Google Play Integrity API では、Google Play Console のアプリまたは Google Play SDK Console の SDK にリンクされていない Google Cloud プロジェクトからのトラフィックに対して、1 日あたり 10,000 件のリクエストという上限が適用されます。この上限は、ほとんどの Google Cloud プロジェクトですでに有効になっています。以前に割り当てが引き上げられた一部のプロジェクトでは、上限が適用される前にリンクを完了するための期限が 2027 年 2 月 16 日まで延長されました。
このガイドでは、プロジェクトのリンクが割り当てにどのように影響するか、Google Cloud プロジェクトをアプリまたは SDK にリンクする方法について説明します。また、よくある質問への回答も紹介します。
概要
| 主な詳細 | 説明 |
|---|---|
| 施行日 | ほとんどのプロジェクトですでに有効になっています。 期限通知を受け取ったプロジェクトの場合は 2027 年 2 月 16 日。 |
| ポリシー | アプリまたは SDK にリンクされていないクラウド プロジェクトから送信される Play Integrity API リクエストは、プロジェクトに設定されているカスタム割り当ての上限に関係なく、1 日あたり 10,000 件に制限されます。 |
| 影響を受けるユーザー | アプリ（Google Play Console 内）または SDK（Google Play SDK Console 内）にリンクされていない Google Cloud プロジェクトを使用して、1 日あたり 10,000 件を超えるリクエストを送信しているアプリと SDK。 |
| 要対応 | Google Play Console で Google Cloud プロジェクトをアプリにリンクするか、Google Play SDK Console で SDK にリンクします。 |
| 割り当て超過エラー | 1 日あたり 10,000 件を超えるリンクされていないリクエストは、エラー TOO_MANY_REQUESTS（エラーコード -8）で失敗します。 |
よくある質問
Q1: Google Cloud プロジェクトをリンクする必要があるのはなぜですか？
Play Integrity API では、すべての Google Cloud プロジェクトに 1 日あたり 10,000 件のリクエストというデフォルトの割り当てが提供されます。より多くの割り当てが必要なデベロッパーは、割り当ての増加をリクエストできます。
アプリや SDK を保護し、権限のない第三者が割り当てを使い切るのを防ぐため、1 日あたりの割り当ての増加は、Google Play Console でアプリにリンクされている Google Cloud プロジェクト、または Google Play SDK Console で SDK にリンクされている Google Cloud プロジェクトにのみ適用されます。
Q2: Google Play Console または Google Play SDK Console で Google Cloud プロジェクトをリンクするにはどうすればよいですか？
アプリの場合（Google Play Console）:
- Google Play Console にログインして、対象のアプリを選択します。
- 左側のナビゲーション メニューで [Google Play による保護] に移動します。
- [Play Integrity API] の横にある [開始]（または [管理]）を選択します。
- [Cloud プロジェクトをリンク]（すでにリンクされたプロジェクトがある場合は [プロジェクトを追加]）をクリックします。
- リンクする Google Cloud プロジェクト番号を選択または入力して、確認します。
SDK の場合（Google Play SDK Console）:
- Google Play SDK Console にログインして、対象の SDK を選択します。
- 左側のナビゲーション メニューで [SDK の完全性] に移動します。
- [Play Integrity API] の横にある [設定] をクリックします。
- [Cloud プロジェクトをリンク] をクリックします（すでにリンクされたプロジェクトがある場合は [別のプロジェクトを追加] をクリックします）。
- リンクする Google Cloud プロジェクト番号を選択または入力して、確認します。
必要な権限:
- Google Play Console（アプリの場合）: アプリに対する「製品版としてのリリース、デバイスの除外、Play アプリ署名の使用」権限が必要です。
- Google Play SDK Console（SDK の場合）: SDK の「管理」権限が必要です。
- Google Cloud（両方）: ターゲットの Google Cloud プロジェクトに対する 'serviceusage.services.enable' 権限と 'resourcemanager.projects.get' 権限が必要です。
Q3: クラウド プロジェクトが正しくリンクされていることを確認するにはどうすればよいですか？
アプリの場合（Google Play Console）:
- Google Play Console > [Google Play で保護] > [Play Integrity API] > [管理] を開きます。
- [プロジェクト構成] セクションを確認します。
- 表示されているプロジェクト番号が、Play Integrity API の呼び出しに使用した番号と一致していることを確認します。
SDK の場合（Google Play SDK Console）:
- Google Play SDK Console > [SDK の整合性] > [設定] を開きます。
- [プロジェクト構成] セクションを確認します。
- 表示されているプロジェクト番号が、Play Integrity API の呼び出しに使用した番号と一致していることを確認します。
Q4: アプリまたは SDK が Google Play にない場合、Cloud プロジェクトをリンクするにはどうすればよいですか？
Google Cloud プロジェクトをリンクできるのは、Google Play Console で管理されているアプリと、Google Play SDK Console で登録されている SDK のみです。
アプリが Google Play 以外でのみ配信されている場合や、SDK が Google Play SDK Console にない場合は、Google Cloud プロジェクトをリンクできません。Play Integrity API のトラフィックは、デフォルトの 1 日あたり 10,000 件のリクエストに制限されます。より高い割り当ての対象となるには、Google Play でアプリを公開するか、対象となる SDK を Google Play SDK Console に登録して、Cloud プロジェクトをリンクします。
Q5: 複数の Google Cloud プロジェクトをリンクしたり、1 つのプロジェクトを複数のアプリや SDK で共有したりできますか？
- アプリまたは SDK ごとに複数のプロジェクト: 1 つのアプリまたは SDK に最大 5 つの Google Cloud プロジェクトをリンクできます。
- 複数のアプリで 1 つのプロジェクトを使用する: Google Play Console で、同じ Google Cloud プロジェクトを複数のアプリにリンクできます。同じ Google Cloud プロジェクトを複数の SDK、または SDK とアプリにリンクすることはできません。
Q6: アプリまたは SDK を管理しているのが自分でも、Google Cloud プロジェクトを所有しているのが組織内の別のユーザーである場合はどうすればよいですか？
リンクを完了するには、Google Play Console（または Google Play SDK Console）で操作を行うユーザーに、Google Cloud プロジェクトで必要な権限も付与されている必要があります。これには、次の 2 つの方法があります。
- オプション A: Google Cloud プロジェクトで IAM アクセスを管理できるユーザーに、Google アカウントに 'serviceusage.services.enable' 権限と 'resourcemanager.projects.get' 権限を一時的に付与するよう依頼します。リンクされると、これらの権限は日常業務に必要なくなります。
- オプション B: Google Cloud プロジェクトで 'serviceusage.services.enable' と 'resourcemanager.projects.get' をすでに持っているチームメンバーに、必要なコンソール権限を付与して、リンク手順を実行できるようにします。
- アプリの場合（Google Play Console）: アプリに「製品版としてのリリース、デバイスの除外、Play アプリ署名の使用」権限を付与します。
- SDK の場合（Google Play SDK Console）: SDK に対する管理権限を付与します。
Q7: 2027 年 2 月 16 日までに Cloud プロジェクトをリンクしなかった場合はどうなりますか？
2027 年 2 月 16 日以降に、アプリまたは SDK がリンクされていない Google Cloud プロジェクトを使用して Play Integrity API リクエストを送信した場合:
- 1 日あたり最大 10,000 件のリクエスト: リクエストは、デフォルトのベースライン割り当てで正常に処理されます。
- 1 日あたり 10,000 件を超えるリクエスト: リンクされていないプロジェクトが 1 日あたり 10,000 件のリクエストに達すると、リクエストはエラー
TOO_MANY_REQUESTS（エラーコード-8）で拒否されます。
即時のセルフサービス修復:
Cloud プロジェクトがリンクされていないために、期限後にアプリまたは SDK で TOO_MANY_REQUESTS エラーが発生した場合は、Google Play Console または Google Play SDK Console で、リンクされていない Google Cloud プロジェクトをリンクすると、問題が解決します。
Q8: Play Integrity API を使用していません。Cloud プロジェクトのリンクを求めるメッセージが届いたのはなぜですか？
この通知は、お客様の Google Cloud プロジェクトで、リンクされていない Play Integrity API リクエストが 1 日あたり 10,000 件を超えているためにお送りしています。一般的な理由は次のとおりです。
- Cloud プロジェクト番号で構成されたライブラリまたは SDK: 一部のライブラリは、Google Cloud プロジェクトを使用して Play Integrity API を呼び出します。アプリまたは SDK でそのようなライブラリを使用している場合は、Google Play Console でそのプロジェクトをアプリにリンクするか、Google Play SDK Console で SDK にリンクします。
- 組織内の別のアプリまたはチーム: 別のチームが、アプリまたは SDK でこの Google Cloud プロジェクトを使用している可能性があります。エンジニアリング チームに確認してアプリまたは SDK を特定し、Google Play Console または Google Play SDK Console でプロジェクトをリンクします。
- 不正なトラフィックまたは廃止された統合: 不正なアプリまたはクローン作成済みアプリがプロジェクト番号を使用してリクエストを送信している場合、または API を使用しなくなった場合は、対応は必要ありません。1 日あたり 10,000 件のリンクされていないリクエストの上限を有効にすると、不要なトラフィックが制限されます。
お問い合わせとサポート
Cloud プロジェクトのリンクや Play Integrity API の割り当ての管理についてご不明な点がある場合は、
- Play Integrity サポート フォーム: デベロッパー サポートに問い合わせる
- Google Play Console に関する一般的なヘルプ: Google Play Console ヘルプセンター