Google Developers Japan

• 既存の更新トークン: この変更は、以前に行われたユーザー認証には影響しません。既存の更新トークンは引き続き動作し、変更や再認証の必要はありません。
• 単一スコープ アプリケーション: アプリケーションで 1 つの Google API スコープしか使っていない場合、分割できる OAuth スコープがないため、この変更の影響を受けません。
• シングル ユーザー アプリケーション / 手動で認証したアプリケーション: このようなアプリケーションには、明示的な OAuth ユーザー認証フローが実装されていません。代わりに GenerateUserCredentials、gcloud CLI、OAuth Playground などの手動認証スクリプトでユーザーを認証し、その資格情報を長期間にわたって利用します。認証の際に、アプリケーションが必要とするすべてのスコープが選択されるため、アプリケーションはこの変更の影響を受けません。
• サービス アカウント: アプリケーションがサービス アカウントを使って API 呼び出しを認証している場合、この変更による影響はありません。

何をする必要がありますか？

アプリケーションが部分的なユーザーの同意に対応できるようにする必要があります。これを行うには、

1. OAuth フローに include_granted_scopes パラメータを含め、ユーザーが同意した OAuth スコープのリストをリクエストします。
2. ユーザーが実際に OAuth 応答で同意した OAuth スコープのリストを調べます。
3. アプリケーションで段階的な認可を実装します。

きめ細かい同意に対応するための要件とベスト プラクティスについては、OAuth のきめ細かい同意に対応するためのガイドをご覧ください。

どうすればこの機能をテストできますか？
この機能をテストする方法には、次の 2 種類があります。

1. 新しい Google Cloud プロジェクトを作成する: 新しい Google Cloud プロジェクトでは、OAuth の同意の分割が有効になっています。そのため、新しい Google Cloud プロジェクトを作成して、アプリケーションのテストに使うことができます。
2. 既存のプロジェクトで同意の分割を有効にする: 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

サポートの利用方法

ご不明な点がある場合や、サポートが必要な場合は、それぞれの API のサポートチームにお問い合わせください。

Posted by Thanet Knack Praneenararat - Ads Developer Relations Team