Google Developers Japan: Ads API での同意の分割について

Local blog for Japanese speaking developers

Ads API での同意の分割について

2025年3月26日水曜日

この記事は Anash P. Oommen による Google Ads Developer Blog の記事 "Consent unbundling in Ads APIs" を元に翻訳・加筆したものです。詳しくは元記事をご覧ください。変更事項2025 年 5 月 1 日の週より、2019 年以前に作成されたすべての Google Cloud プロジェクトで、OAuth ユーザー認証の同意の分割がロールアウトされます。2019 年以前に作成された Google Cloud プロジェクトで広告関連の API を利用するアプリケーションでは、分割されたユーザーの同意に対応するため、2025 年 5 月 1 日までにアプリケーションの更新が必要になる場合があります。背景OAuth ユーザー認証フローで同意を分割すると、すべてかゼロかのアプローチではなく、アプリケーションで認可したい特定の OAuth スコープをユーザーがカスタマイズできます。この機能は、2019 年以降に作成されたすべての Google Cloud コンソールプロジェクトでオンになっていますが、2019 年以前に作成されたすべてのプロジェクトではオフになっています。

次のスクリーンショットは、すべてかゼロかの同意プロンプトと、分割された同意プロンプトの違いを示しています。

図 1: すべてかゼロかの同意画面。ユーザーは OAuth スコープのリストから選択することはできない。

図 2: 分割された同意画面。ユーザーは OAuth スコープのリストから選択できる。

変更の影響を受けるのは誰ですか？

次の条件をすべて満たす場合、この変更の影響を受けます。

API アプリケーションで、2019 年以前に作成された Google Cloud コンソールプロジェクトを使っている。
アプリケーションで OAuth 2.0 ユーザー同意フローを実装している。これは、ユーザーが Google アカウントでログインし、アプリケーションが要求する 1 つ以上の権限を付与する認証ワークフローです。
アプリケーションで複数の Google API を使っており、後述する広告関連の 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	OAuth スコープ
Google Ads API	https://adwords.google.com/api/adwords
Google Ad Manager API（SOAP API、ベータ版）	https://www.googleapis.com/auth/dfp https://www.googleapis.com/auth/admanager
Bid Manager API	https://www.googleapis.com/auth/doubleclickbidmanager
Content API for Shopping	https://www.googleapis.com/auth/content
Display and Video 360 API	https://www.googleapis.com/auth/display-video-mediaplanning https://www.googleapis.com/auth/display-video-user-management
AdMob API	https://www.googleapis.com/auth/admob.report https://www.googleapis.com/auth/admob.googlebidding.readwrite https://www.googleapis.com/auth/admob.monetization
AdSense for Platforms API	https://www.googleapis.com/auth/adsensehost https://www.googleapis.com/auth/adsense https://www.googleapis.com/auth/adsense.readonly
Google Analytics API	https://www.googleapis.com/auth/analytics https://www.googleapis.com/auth/analytics.readonly https://www.googleapis.com/auth/analytics.edit https://www.googleapis.com/auth/analytics.manage.users https://www.googleapis.com/auth/analytics.manage.users.readonly https://www.googleapis.com/auth/analytics.provision https://www.googleapis.com/auth/analytics.user.deletion
Campaign Manager 360 API	https://www.googleapis.com/auth/ddmconversions https://www.googleapis.com/auth/dfareporting https://www.googleapis.com/auth/dfatrafficking
Search Ads 360 API	https://www.googleapis.com/auth/doubleclicksearch
Google Tag Manager API	https://www.googleapis.com/auth/tagmanager.delete.containers https://www.googleapis.com/auth/tagmanager.edit.containers https://www.googleapis.com/auth/tagmanager.edit.containerversions https://www.googleapis.com/auth/tagmanager.manage.accounts https://www.googleapis.com/auth/tagmanager.manage.users https://www.googleapis.com/auth/tagmanager.publish https://www.googleapis.com/auth/tagmanager.readonly
Real time bidding API	https://www.googleapis.com/auth/realtime-bidding
Authorized Buyers Marketplace API	https://www.googleapis.com/auth/authorized-buyers-marketplace https://www.googleapis.com/auth/adexchange.buyer