# インストール後のアクションと設定を有効にする

アプリのインストール後に発生する追加設定をサポートします。

ユーザーがアプリをインストールしたら、ユーザーに追加アクションや設定を求めることができます。たとえば、アプリでユーザーが外部サービスにアクセスするために、ユーザーに個別の認証情報を求めることができます。Stripe Apps ではこれらの追加アクションを、_「インストール後のアクション」_と呼びます。インストール後のアクションの複数のタイプからいずれかを選択して設定できます。

- アプリ自体の内部 ([SettingsView](https://docs.stripe.com/stripe-apps/components/settingsview.md) コンポーネントを使用)
- 外部 (Web サイトへのリンクを使用)。

インストール後のアクションを定義しない場合は、インストール後にダッシュボードにアプリが表示されます。
 (See full diagram at https://docs.stripe.com/stripe-apps/post-install-actions)
## インストール後のアクションを追加する

インストール後のアクションを追加するには、以下の手順を使用します。

1. [アプリのマニフェスト](https://docs.stripe.com/stripe-apps/reference/app-manifest.md)ファイルを開きます。

1. 新しいフィールド、`post_install_action` を追加します。

   ```json
   {
     "id": "com.invoicing.[YOUR_APP]",
     "version": "1.2.3",
     "name": "[YOUR APP] Shipment Invoicing",
     "icon": "./[YOUR_APP]_icon_32.png",
     "permissions": [],
     "app_backend": {},
     "ui_extension": {},"post_install_action": {}
   }
   ```

1. アプリケーション設定のニーズを満たす、`post_install_action` の[設定オプション](https://docs.stripe.com/stripe-apps/post-install-actions.md#configuration-options)を追加します。

1. アプリを Stripe に[アップロード](https://docs.stripe.com/stripe-apps/upload-install-app.md)します。

1. アプリの[新しいリリースを作成](https://docs.stripe.com/stripe-apps/versions-and-releases.md)します。

1. マーケットプレイスにアプリを[公開](https://docs.stripe.com/stripe-apps/publish-app.md)します。

## 設定オプション

Stripe Apps は、以下のインストール後のアクションをサポートしています。

- [Link to app](https://docs.stripe.com/stripe-apps/post-install-actions.md#link-to-app)
- [アカウント登録へのリンク](https://docs.stripe.com/stripe-apps/post-install-actions.md#link-to-onboarding)
- [設定へのリンク](https://docs.stripe.com/stripe-apps/post-install-actions.md#link-to-settings)
- [外部 URL へのリンク](https://docs.stripe.com/stripe-apps/post-install-actions.md#link-external)

### アプリへのリンク (デフォルト)

ユーザーがアプリをインストールした後のデフォルトのアクションでは、そのユーザーがアプリケーションインターフェイス (存在する場合) にリダイレクトされます。
![アプリを表示するためのリンクが含まれるインストール後の画面](https://b.stripecdn.com/docs-statics-srv/assets/app.09cbbc38c50cfef0a9aaf9a92f8d1d0e.png)

この動作には、実装すべき追加設定は必要ありません。

### アカウント登録へのリンク

アプリを使用する前にユーザーにセットアップタスクを完了するよう指示するには、アプリのインストール直後に [ユーザー登録フロー](https://docs.stripe.com/stripe-apps/patterns/onboarding-experience.md)を起動します。このフローを有効にするには、アプリのマニフェストファイルの `post_install_action`パラメータを更新します。

```json
{
  "id": "com.invoicing.[YOUR_APP]",
  "version": "1.2.3",
  "name": "[YOUR APP] Shipment Invoicing",
  "icon": "./[YOUR_APP]_icon_32.png",
  "permissions": [],
  "app_backend": {},
  "ui_extension": {},"post_install_action": {
    "type": "onboarding"
  }
}
```

### 外部 URL へのリンク

アプリを設定するために、ユーザーに外部サイトを訪れてもらう必要がある場合には、アプリマニフェストの `post_install_action` パラメーターを以下のように更新します。

```json
{
  "id": "com.invoicing.[YOUR_APP]",
  "version": "1.2.3",
  "name": "[YOUR APP] Shipment Invoicing",
  "icon": "./[YOUR_APP]_icon_32.png",
  "permissions": [],
  "app_backend": {},
  "ui_extension": {},"post_install_action": {
    "type": "external",
    "url": "https://[YOUR-URL]"
  }
}
```

`[YOUR-URL]` を外部サイトの URL に置き換えます。

ユーザーがアプリをインストールすると、アプリマニフェストで指定された URL にユーザーをリダイレクトするボタンが表示されます。

この URL には `account_id` クエリ文字列パラメーターが含まれ、ユーザーの識別に使用できます。以下の例をご覧ください。

```
https://www.company.com/marketplace/stripe?account_id=12345
```
![外部リンクが含まれるインストール後の画面](https://b.stripecdn.com/docs-statics-srv/assets/external.565e55096589e7c7580bc5d534c1ace1.png)

### 設定へのリンク

アプリに [SettingsView](https://docs.stripe.com/stripe-apps/components/settingsview.md) コンポーネントが含まれている場合は、`post_install_action` を設定してインストール後にそれを開くことができます。このアクションを有効にするには、アプリのマニフェストファイルを次のように更新します。

```json
{
  "id": "com.invoicing.[YOUR_APP]",
  "version": "1.2.3",
  "name": "[YOUR APP] Shipment Invoicing",
  "icon": "./[YOUR_APP]_icon_32.png",
  "permissions": [],
  "app_backend": {},
  "ui_extension": {},"post_install_action": {
    "type": "settings"
  }
}
```

ユーザーがアプリをインストールすると、アプリケーションの SettingsView コンポーネントにユーザーをリダイレクトするボタンが表示されます。
![設定を表示するリンクが含まれるインストール後の画面](https://b.stripecdn.com/docs-statics-srv/assets/settings.e6bc859871bc657c25d353055497c8ee.png)