認証と HTTP ヘッダー

動画: 認証

OAuth 2.0 アプリケーションの認証情報とデベロッパー あります。API 呼び出しを行う場合 Google 広告クライアント センター（MCC）アカウントを使用している場合は、login-customer-id も指定する必要があります 必要があります。このページでは、これらの値の設定方法と、 送信される API 固有の HTTP ヘッダーが追加でドキュメント化されます。 受信するメッセージの数に制限はありません。

OAuth 2.0 認証情報

Google Ads API では、アプリケーションの認証情報を使用して API を識別し、承認します できます。OAuth 2.0 クライアントとサービス アカウントを構成できます。詳細情報 クライアントサイド認証の設定について詳しくは、OAuth2 Google Ads API

Google API を初めて使用する場合は、 oauth2l または OAuth 2.0 テスト対象のプレイグラウンド 認証情報と Google Ads API を確認してから、 。

デスクトップまたはウェブアプリのフローの使用

手順に沿って、サービス アカウント向けに Google API Console プロジェクトを設定します。 Google Ads APIクライアント ID と クライアント シークレットを入力してから、このページに戻ってください。

OAuth クライアントを作成したら、デスクトップ アプリのフローに沿って操作する 手順または ウェブアプリのフロー 手順 更新トークンとアクセス トークンを生成します。

サービス アカウントを使用する

サービス アカウント Google Ads API のサービス アカウントのアクセス権を設定するためのガイドです。

Google 広告アカウントにアクセスするためのサービス アカウントを設定したら、 サーバー間での OAuth 2.0 の使用 アプリケーション [HTTP/REST] タブを選択してください。Google Ads API で使用する scope アクセス権は https://www.googleapis.com/auth/adwords です。

新しいアクセス トークンの生成

クライアント ID、クライアント シークレット、更新トークンを取得したら、 新しいアクセス トークンを生成して、API 呼び出しで使用する curl コマンドライン ツール:

curl \
  --data "grant_type=refresh_token" \
  --data "client_id=CLIENT_ID" \
  --data "client_secret=CLIENT_SECRET" \
  --data "refresh_token=REFRESH_TOKEN" \
  https://www.googleapis.com/oauth2/v3/token

次に、curl リクエストによって返されたアクセス トークンを Google Ads API に対するすべての API 呼び出しの Authorization HTTP ヘッダー:

GET /v17/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN

リクエスト ヘッダー

開発者トークン

Google Ads API では、次の呼び出しを行うために開発者トークンも必要です。 できます。クライアント センター（MCC）アカウントのトークンは、 Google 広告の管理画面。開発者トークンのセットアップについて詳しくは、 開発者トークンを取得します。

developer-token HTTP に開発者トークンの値を含める必要があります。 ヘッダー:

GET /v17/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN

ログイン用のお客様 ID

マネージャーがクライアント アカウントに対して行う Google Ads API 呼び出し（ 管理者としてログインしてクライアント アカウントの 1 つに API 呼び出しを行う場合） login-customer-id HTTP ヘッダーも指定する必要があります。この値は API 呼び出しを行うマネージャーの Google 広告のお客様 ID。

このヘッダーを含めることは、Google 広告の管理画面でアカウントを選択するのと同じことです。 アカウントにログインするか、アカウントの右上にあるプロフィール画像をクリックすると、 表示されます。お客様 ID を指定するときは、必ずハイフン（—）を削除してください。 たとえば、123-456-7890 ではなく 1234567890 です。

GET /v17/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
login-customer-id: MANAGER_CUSTOMER_ID

リンクされたお客様 ID

このヘッダーは、第三者アプリ分析プロバイダが リンクされた Google 広告にコンバージョンをアップロードする 。詳しくは、 API 呼び出しの構成ガイド をご覧ください。

...
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
login-customer-id: MANAGER_CUSTOMER_ID
linked-customer-id: LINKED_CUSTOMER_ID

レスポンス ヘッダー

API からの HTTP レスポンスでは、次のヘッダーが返されます。

リクエスト ID

request-id は、API リクエストを一意に識別する文字列です。日時 特定の API 呼び出し、request-id Google デベロッパーに問い合わせる際に使用できる重要な識別子です。 サポート。

request-id: 2a5Cj89VV7CNhya1DZjjrC
前へ
はじめに
次へ
概要