2025 年 2 月 20 日（木曜日）
変更点2025 年 5 月 1 日の週より、2019 年より前に作成されたすべての Google Cloud プロジェクトを対象に、OAuth ユーザー認証の同意のアンバンドルをリリースします。2019 年より前に作成された Google Cloud プロジェクトを通じて広告関連の API を使用するアプリケーションを所有している場合は、2025 年 5 月 1 日までに、バンドルされていないユーザーの同意を処理するようにアプリケーションを更新する必要がある場合があります。
背景
OAuth ユーザー認証フローの同意のアンバンドルにより、ユーザーは、アプリケーションに認証する特定の OAuth スコープをカスタマイズできます。これは、すべてを認証するか、何も認証しないかというアプローチとは異なります。2019 年以降に作成されたすべての Google Cloud コンソール プロジェクトでは、この機能が有効になっています。一方、2019 年より前に作成されたすべてのプロジェクトでは、この機能が無効になっています。
この変更の影響を受けるユーザー
次のすべての条件が満たされている場合、この変更の影響を受けます。
- API アプリケーションで、2019 年より前に作成された Google Cloud コンソール プロジェクトを使用している。
- アプリケーションに OAuth 2.0 ユーザーの同意フローを実装します。これは、ユーザーが Google アカウントでログインし、アプリケーションがリクエストしている 1 つ以上の権限を付与する認証ワークフローです。
- アプリケーションで複数の Google API を使用しており、そのうちの 1 つが以下に記載されている広告関連の API である。
この変更の影響を受けないユーザー
- 既存の更新トークン: この変更は、すでに設定されているユーザー認証には影響しません。既存の更新トークンは、変更や再認証なしで引き続き機能します。
- 単一スコープのアプリケーション: アプリケーションが 1 つの Google API スコープのみを使用している場合、バンドルを解除する複数の OAuth スコープがないため、アプリケーションはこの変更の影響を受けません。
- 単一ユーザー アプリケーション / 手動認証アプリケーション: アプリケーションに明示的な OAuth ユーザー認証フローが実装されていません。代わりに、GenerateUserCredentials、gcloud CLI、OAuth Playground などの手動認証スクリプトを使用してユーザーを認証し、その認証情報を長期間使用します。認証時にアプリケーションに必要なすべてのスコープを選択しているため、アプリケーションはこの変更の影響を受けません。
- サービス アカウント: アプリケーションでサービス アカウントを使用して API 呼び出しを認証している場合、今回の変更による影響はありません。
必要なご対応
アプリがユーザーの同意を部分的に処理できるようにする必要があります。手順は次のとおりです。
- OAuth フローに
include_granted_scopesパラメータを含めることで、ユーザーが同意した OAuth スコープのリストをリクエストします。 - OAuth レスポンスでユーザーが同意した OAuth スコープの実際のリストを確認します。
- アプリケーションに増分認証を実装します。
OAuth のきめ細かい同意に関するガイドで、きめ細かい同意を処理するための要件とベスト プラクティスを確認してください。
この機能をテストするにはどうすればよいですか？
この機能をテストするには、次の 2 つの方法があります。
- 新しい Google Cloud プロジェクトを作成する: 新しい Google Cloud プロジェクトでは、OAuth 同意のアンバンドルが有効になっています。新しい Google Cloud プロジェクトを作成して、アプリケーションのテストに使用できます。
- 既存のプロジェクトで同意のバンドル解除を有効にする: OAuth 認証リクエストで
enable_granular_consentパラメータを true に設定できます。
影響を受ける API スコープ
この変更の影響を受ける広告関連の API は次のとおりです。
サポートを受ける方法
ご不明な点がある場合やサポートが必要な場合は、各 API のサポートチームにお問い合わせください。
- Anash P. Oommen、Google Ads API チーム