Flow Service API を使用したGoogle Ads ベース接続の作成

WARNING
Google Ads ソースは一時的に使用できません。 Adobeはこのソースに関する問題を解決するために取り組んでいます。
NOTE
Google Ads ソースはベータ版です。 ベータラベル付きソースの使用について詳しくは、 ソースの概要を参照してください。

ベース接続は、ソースと Adobe Experience Platform 間の認証済み接続を表します。

このチュートリアルでは、Flow Service API を使用してGoogle Ads のベース接続を作成する手順について説明します。

はじめに

このガイドでは、Adobe Experience Platform の次のコンポーネントに関する十分な知識が必要です。

  • ソース:Experience Platformを使用すると、データを様々なソースから取得しながら、Experience Platformサービスを使用して受信データの構造化、ラベル付け、拡張を行うことができます。
  • サンドボックス:Experience Platformには、1 つのExperience Platformインスタンスを別々の仮想環境に分割し、デジタルエクスペリエンスアプリケーションの開発と発展に役立つ仮想サンドボックスが用意されています。

次の節では、Flow Service API を使用してGoogle Ads に正常に接続するために必要な追加情報を示します。

必要な資格情報の収集

Flow Service をGoogle Ads に接続するには、次の接続プロパティの値を指定する必要があります。

資格情報
説明
clientCustomerId
クライアントカスタマー ID は、Google Ads API で管理するGoogle Ads クライアントアカウントに対応するアカウント番号です。 この ID は 123-456-7890 のテンプレートに従います。
loginCustomerId
ログインカスタマー ID は、Google Ads Manager のアカウントに対応するアカウント番号で、特定の運用顧客からレポートデータを取得するために使用されます。 ログインカスタマー ID について詳しくは、Google Ads API ドキュメントを参照してください。
developerToken
開発者トークンを使用すると、Google Ads API にアクセスできます。 同じ開発者トークンを使用して、すべてのGoogle Ads アカウントに対してリクエストを行うことができます。 マネージャーアカウントにログインしてデベロッパートークンを取得し、API Center のページに移動します。
refreshToken
更新トークンは認証の一部 OAuth2 す。 このトークンを使用すると、有効期限が切れた後にアクセストークンを再生成できます。
clientId
クライアント ID は、クライアント秘密鍵と並行して、認証の一部として使用 OAuth2 れます。 クライアント ID とクライアント秘密鍵を組み合わせることで、Googleに対するアプリケーションを識別し、お客様のアカウントに代わってアプリケーションを動作させることができます。
clientSecret
クライアントの秘密鍵は、クライアント ID と並行して、認証の一部として使用 OAuth2 れます。 クライアント ID とクライアント秘密鍵を組み合わせることで、Googleに対するアプリケーションを識別し、お客様のアカウントに代わってアプリケーションを動作させることができます。
connectionSpec.id
接続仕様は、ベース接続とソース接続の作成に関連する認証仕様などの、ソースのコネクタプロパティを返します。Google Ads の接続仕様 ID は d771e9c1-4f26-40dc-8617-ce58c4b53702 です。

詳しくは、API の概要のドキュメント Google Ads の使用の手引きについて詳しくはを参照してください。

Platform API の使用

Platform API への呼び出しを正常に実行する方法について詳しくは、Platform API の概要を参照してください。

ベース接続の作成

ベース接続は、ソースと Platform 間の情報(ソースの認証資格情報、現在の接続状態、固有のベース接続 ID など)を保持します。ベース接続 ID により、ソース内からファイルを参照および移動し、データタイプやフォーマットに関する情報を含む、取り込みたい特定の項目を識別することができます。

ベースPOSTID を作成するには、/connections エンドポイントに接続リクエストを実行し、その際にGoogle Ads 認証資格情報をリクエストパラメーターの一部として指定します。

API 形式

POST /connections

リクエスト

次のリクエストは、Google Ads のベース接続を作成します。

curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/connections' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json'
  -d '{
      "name": "Google Ads base connection",
      "description": "Google Ads base connection",
      "auth": {
          "specName": "Basic Authentication",
          "params": {
              "clientCustomerID": "{CLIENT_CUSTOMER_ID}",
              "loginCustomerID": "{LOGIN_CUSTOMER_ID}",
              "developerToken": "{DEVELOPER_TOKEN}",
              "authenticationType": "{AUTHENTICATION_TYPE}"
              "clientId": "{CLIENT_ID}",
              "clientSecret": "{CLIENT_SECRET}",
              "refreshToken": "{REFRESH_TOKEN}"
          }
      },
      "connectionSpec": {
          "id": "d771e9c1-4f26-40dc-8617-ce58c4b53702",
          "version": "1.0"
      }
  }'
プロパティ
説明
auth.params.clientCustomerID
Google Ads アカウントのクライアントカスタマー ID。
auth.params.loginCustomerID
Google Ads Manager アカウントに対応するログインカスタマー ID。
auth.params.developerToken
Google Ads アカウントの開発者トークン。
auth.params.refreshToken
Google Ads アカウントの更新トークン。
auth.params.clientID
Google Ads アカウントのクライアント ID。
auth.params.clientSecret
Google Ads アカウントのクライアント秘密鍵。
connectionSpec.id
Google Ads 接続仕様 ID:d771e9c1-4f26-40dc-8617-ce58c4b53702

応答

リクエストが成功した場合は、一意の ID(id)を含め、新しく作成されたベース接続の詳細が返されます。この ID は、次の手順でソース接続を作成する際に必要になります。

{
    "id": "2484f2df-c057-4ab5-84f2-dfc0577ab592",
    "etag": "\"10033e77-0000-0200-0000-5e96785b0000\""
}

次の手順

このチュートリアルでは、Flow Service API を使用してGoogle Ads ベース接続を作成しました。 このベース接続 ID は、次のチュートリアルで使用できます。

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089