---
title: "App Store Connect APIキーをAdaptyに追加する"
description: "App Store Connect APIキーを使用して、AdaptyはApp Storeプロダクトを作成し、ステータスと価格を同期します。チームキーを生成して接続し、動作しなくなったら置き換えてください。"
---

> **AI agents**: to search Adapty docs faster and with fewer tokens, install the Adapty skills: `npx adapty skills install --yes`

AdaptyはApp Store Connect APIキーを使用して、App Store Connect内のプロダクトを管理します：

- [プロダクトを作成](create-product#create-product-and-push-to-store)し、サブスクリプショングループを設定する。
- Adaptyにプロダクトを追加する際、IDで既存のプロダクトを検索する。
- Adapty内で各プロダクトのApp Storeステータスを表示する。
- 価格を毎日インポートし、Adaptyで行った価格変更をエクスポートする。
- [リテンションメッセージング](retention-messaging-setup)のSwitchプランにプロダクトを提案する。

Adaptyは、プロダクトの作成や価格変更など、Adapty上で操作を行った場合にのみApp Store Connectを更新します。ステータスの表示や価格のインポートは、App Store Connectの読み取りのみを行います。

**App Store Connect** の **Team Keys** タブでキーを生成し、Adapty の **App settings** で接続してください。キーが使えなくなったり変更が必要になった場合は、[キーを置き換えて](#replace-the-key)ください。

App Store Connect API キーは [アプリ内課金キー](generate-in-app-purchase-key) とは別のものですが、App Store Connect ではどちらのキーの ID も **Issuer ID** および **Key ID** として表示されます。

**App settings** > **iOS SDK** ですべての認証情報を一度に入力するには、[App Store インテグレーションの設定](app-store-connection-configuration) に従ってください。

## App Store Connect でチームキーを生成する \{#generate-a-team-key-in-app-store-connect\}

1. App Store Connect で [**Users and Access** > **Integrations** > **App Store Connect API**](https://appstoreconnect.apple.com/access/integrations/api) に移動し、**Team Keys** タブを開きます。Adapty にはチームキーが必要です。個人キーには Issuer ID がありません。

   1 つのチームキーで、App Store Connect チームのすべてのアプリに使用できます。このタブに **Admin** アクセス権を持つ有効なキーがあり、そのファイルを持っている場合は、そのキーを再利用し、手順 2〜4 をスキップしてください。

   チームがまだ App Store Connect API アクセスを持っていない場合は、Account Holder が[アクセスをリクエスト](https://developer.apple.com/help/app-store-connect/get-started/app-store-connect-api)します。Apple が各リクエストを審査します。

2. キーを生成するには、App Store Connect で Account Holder または Admin のロールが必要です。どちらのロールも持っていない場合は、いずれかのロールを持つ人に **Admin** アクセス権のキーを生成してもらい、Issuer ID と Key ID とともにファイルを送ってもらってください。

   タブにすでに有効なキーが表示されている場合は **+** をクリックします。表示されていない場合は **Generate API Key** をクリックします。

   <ZoomImage id="asc-team-keys-add.webp" width="700px" alt="Team Keys tab of the App Store Connect API page in App Store Connect" />

3. キーの名前を入力し、**Access** を **Admin** に設定します。**Access** は、ご自身のロールに関わらず Adapty がキーで実行できる操作を決定します。キーを生成した後に **Access** を変更することはできません。**Generate** をクリックします。

   <ZoomImage id="asc-team-key-generate-dialog.webp" width="700px" alt="Dialog for a new team key, with a name and the Access dropdown" />

4. 各キーのダウンロードは 1 回のみ可能です。新しいキーの横にある **Download** をクリックします。ファイルは安全に保管してください。このキーを使用する各 Adapty アプリにアップロードします。

   <ZoomImage id="asc-team-key-download.webp" width="700px" alt="Active list of team keys, with the Download link next to a new key" />

## Adaptyでキーを連携する \{#connect-the-key-in-adapty\}

1. **Issuer ID** と **Key ID** を確認するには、App Store Connect で [**Users and Access** > **Integrations** > **App Store Connect API**](https://appstoreconnect.apple.com/access/integrations/api) に移動し、**Team Keys** タブを開きます。他の担当者がキーを生成し、Issuer ID、Key ID、ファイルを送ってくれた場合は、この手順をスキップしてください。

   <ZoomImage id="asc-team-keys-ids.webp" width="700px" alt="Issuer ID and the Key ID of a team key on the Team Keys tab in App Store Connect" />

2. Adapty で [**App settings** > **iOS SDK**](https://app.adapty.io/settings/ios-sdk) に移動します。**App Store Connect API key** セクションで **Connect API Key** をクリックします。

   <ZoomImage id="app-settings-connect-api-key.webp" width="700px" alt="App Store Connect API key section in Adapty, with the Connect API Key button" />

3. 各フィールドを入力します：
   - **Issuer ID**：App Store Connect の **Team Keys** タブからコピーします。
   - **Key ID**：**Team Keys** タブの **Active** リストから、ダウンロードしたキーの横にある値をコピーします。
   - **Private key (.p8 file)**：チームキー用にダウンロードしたファイルをアップロードします。

   <ZoomImage id="app-settings-api-key-dialog.webp" width="700px" alt="Issuer ID, Key ID, and Private key (.p8 file) fields in the window for the App Store Connect API key" />

4. 接続済みのキーは後から置き換えることができますが、削除はできません。キーがこのアプリを所有する App Store Connect チームのものであることを確認し、**Connect** をクリックします。以降は、**App Store Product ID** をキーボードで入力するのではなく、App Store Connect 内のプロダクトから選択できるようになります。

   Adapty は接続時に Apple でキーを検証しません。誤ったキーを設定した場合、キーに関するエラーメッセージは表示されず、プロダクトに App Store のステータスが表示されなくなり、**App Store Product ID** のドロップダウンが空のままになります。誤ったキーを修正するには、[キーを置き換えて](app-store-connect-api-key#replace-the-key)ください。

## キーを置き換える \{#replace-the-key\}

キーが機能しなくなった場合や **Access** の設定を変更する必要がある場合は、古いキーを無効化する前に新しいキーを Adapty に接続してください。

有効なキーがないと、Adapty は以下の操作を実行できません：

- プロダクトを作成する。
- ID で既存のプロダクトを検索する。
- プロダクトのステータスや価格を同期する。

機能しなくなったキーも、Adapty 上では接続済みとして表示されます。その兆候として、[App Store のステータスが表示されず、**App Store Product ID** のドロップダウンが空のプロダクト](troubleshoot-app-store-integration#products-dont-appear-or-show-no-app-store-status)が挙げられます。

Adapty は、接続済みキーの Key ID を表示しません。Adapty が使用しているキーが不明な場合は、新しいキーに置き換えてください。

アプリを別の Apple デベロッパーアカウントに移行する場合は、[新しいオーナーのチームキーを接続してください](transfer-apps#app-store-ios-transfer)。

キーを置き換えるには:

1. [新しいチームキーを生成する](#generate-a-team-key-in-app-store-connect)。
2. Adapty で [**App settings** > **iOS SDK**](https://app.adapty.io/settings/ios-sdk) に移動します。**App Store Connect API key** セクションで **Edit** をクリックします。[新しいキーの値を入力し](#connect-the-key-in-adapty)、**Save changes** をクリックします。
3. 1つのチームキーで App Store Connect チームのすべてのアプリに対応できます。チームの他のアプリで Adapty を使用している場合は、それらにも新しいキーを接続してください。また、古いキーを使用しているサーバーがあれば、そちらも新しいキーに置き換えてください。
4. 失効したキーは、それを使用しているすべてのアプリで機能しなくなり、復元することはできません。新しいキーが置き換えるキーがわかっている場合は、App Store Connect にアクセスしてそのキーを失効させてください。