このガイドでは、クライアント ライブラリを使用して Google 広告キャンペーンを取得します。
API アクセスを有効にするには、まず必要な OAuth2 認証情報を取得します。
次に、承認とアカウントの詳細を構成ファイルに追加します。構成ファイルを設定したら、API を呼び出す準備が整います。
クライアント ライブラリの構成パラメータ
クライアント ライブラリの構成ファイルに次の情報を入力します。
- 開発者トークン
開発者トークンを使用すると、アプリは API にアクセスできますが、トークンは 1 つの Google 広告アカウントのみに限定されません。トークンが承認されると、そのトークンに関連付けられた Google 広告 MCC アカウントにリンクされていなくても、すべての Google 広告アカウントに対するリクエストに同じトークンを使用できます。
管理するアカウントは、MCC アカウントの OAuth 認証情報によって承認されます。MCC アカウントでは、すべてのサブアカウントを管理するための 1 組の認証情報のみが必要になります。
本番用 Google 広告アカウントで API に接続できるのは、承認済みの開発者トークンのみです。承認待ちのトークンではテスト用アカウントにしか接続できません。
開発者トークンを取得するには、マネージャー アカウントにログインし、API センター（[ツールと設定] > [設定] > [API センター]）に移動します。
- クライアントのお客様 ID
クライアントのお客様 ID は、API で管理する Google 広告のクライアント アカウントのアカウント番号です。通常、形式は
123-456-7890です。
クライアントのお客様 ID は、設定ファイルには含めず、プログラムで設定することも可能です。開発者トークンが承認されると、テスト アカウントの代わりに、本番環境のアカウントのクライアントのお客様 ID を使用できるようになります。
- OAuth2 クライアント ID とクライアント シークレット
OAuth2 クライアント ID とクライアント シークレットは、クライアント アプリを Google API Console のプロジェクトにマッピングし、OAuth2 認証に使用されます。これにより、アプリはアカウントに代わって動作できるようになります。アプリを Google が識別し、Google 広告ユーザーを管理するための OAuth トークンを生成します。詳しくは、クライアント ID とクライアント シークレットを作成するをご覧ください。
- OAuth2 アクセスと更新トークン
アプリが API を使用して限定公開データにアクセスするには、その前に API へのアクセスを許可する OAuth2 アクセス トークンを取得する必要があります。
クライアント ライブラリを使用している場合、OAuth2 アクセス トークンが自動的に処理されます。それ以外の場合は、OAuth Playground でトークンを取得してみてください。
OAuth2 アクセス トークンは一定期間後に有効期限が切れます。このため、クライアント ライブラリは OAuth2 更新トークンを使用して OAuth2 アクセス トークンを自動的に再生成します。更新トークンを作成する手順については、アクセス トークンと更新トークンをご覧ください。