View in English

はじめに

App Store Connect API

App Store Connect API は、App Store Connect におけるタスクの自動化を実現する REST API です。

アカウント内のすべてのアプリで使用可能な API キーを役割ごとに生成することも、各 App Store Connect ユーザに対して個別にキーを生成することもできます。App Store Connect API キーは App Store Connect API に固有であるため、ほかの Apple のサービスで使用することはできません。

利用するにあたり、まずはじめに Account Holder が App Store Connect で当該 API へのアクセス権をリクエストする必要があります。

App Store Connect APIへのアクセスのリクエスト

必要な役割: Account Holder。「役割の権限」を参照してください。

  1. 「ユーザとアクセス」で、「統合」をクリックします。「App Store Connect API」ページが開きます。

  2. 「Request Access」(アクセス権のリクエスト) をクリックします。

  3. チェックボックスをオンにして利用規約に同意したら、「提出」をクリックします。

その後リクエストは審査され、状況に応じて承認が行われます。

チーム API キーの生成

必要な役割：Account Holder または Admin。「役割の権限」を参照してください。

アカウント内のすべてのアプリで使用できるチームキーですが、特定の役割のみに割り当てることが可能です。

  1. 「ユーザとアクセス」で、「統合」をクリックします。「App Store Connect API」ページが開きます。

  2. 「Team Keys」(チームキー) をクリックします。

  3. 「API キーを生成」をクリックします。「アクティブ」となっている API キーがすでにある場合、キーを追加するには追加ボタン (+) をクリックします。

  4. キーの名前を入力します。この名前は参照にのみ使用されるもので、キー自体の構成には含まれません。

  5. 「アクセス」でユーザの役割を選択します。この API を使用できるユーザが決定されます。チーム API キーはすべてのアプリに適用されるものです。つまり、アプリのアクセス権限を使って、API キーの利用制限をすることはできません。

  6. 「生成」をクリックします。

一度 API キーを生成すると、その名前やアクセスレベルを編集することはできません。変更が必要な場合は、その API キーを取り消して新しいキーを生成します。キーの管理やセキュリティの詳細については、こちらをご覧ください。

個人で使用する API キーの生成

必要な役割：Account Holder、Admin、App Manager、Customer Support、Developer、または Marketing。「役割の権限」を参照してください。

すべての App Store Connect ユーザが、デフォルトで、個人で使用する API キーの生成および無効化を行うことができます (Admin または Account Holder がその権限を取り消していない場合に限る)。各ユーザは、一度に有効な API キーを 1 つだけ持つことができます。

  1. App Store Connect 内のページ右上隅にあるユーザ名をクリックし、「プロフィールを編集」を選択します。

  2. 「Individual API Key」(個々の API キー) で、「Generate Key」(キーを生成) をクリックします。

  3. 個人用 API キーをダウンロードするには、「Download」(ダウンロード) をクリックし、その後ダイアログで表示される「Download」(ダウンロード) をクリックします。

    注：API キーは、プライベートなものであり、1 回しかダウンロードできません。ダウンロード後は安全な場所で保管します。キーが紛失したり侵害されたりした場合は必ず、即時無効化してください。

  4. 個人用 API キーを無効化するには、「無効化」をクリックし、その後ダイアログで表示される「無効化」をクリックします。API キーは、一度無効化すると復元できません。

個人用キーとチームキーの管理

必要な役割：Account Holder または Admin。「役割の権限」を参照してください。

Account Holder または Admin の役割を持つユーザは、チームキーと当該ユーザが所属する App Store Connect のチームメンバーによって作成された個人用キーの表示および管理ができます。API キーを無効化することで、その API キーを使った App Store Connect サービスの認証を行えなくすることが可能です。ユーザの API キーを無効化し、かつ新規の API キーを作成できないようにするには、当該ユーザの「個人 API キーを生成する」権限を削除します。

  1. 「ユーザとアクセス」で、「統合」をクリックします。「App Store Connect API」ページが開きます。

  2. 左上で「Individual Keys」(個々のキー) または「Team Keys」(チームキー) をクリックします。

  3. 右上の「編集」をクリックします。

  4. 無効化したい API キーを選択します。

  5. 右上で「キーを無効化」をクリックし、ダイアログで「無効化」をクリックします。API キーは、一度無効化すると復元できません。「App Store Connect API」ページの「無効化済み」セクションに、過去 30 日間で無効化されたキーの一覧が表示されます。
関連項目 App Store Connect API App Store Connect API を利用したワークフローの自動化