フィールド マッピング

フィールド マッピングを使用して、パートナー リンク ワークフローの各ステップを Google Ads API から Data Manager API にアップグレードします。

認証

Data Manager API には、Google Ads API とは異なるスコープの認証情報が必要です。パートナー リンクを管理するための Data Manager API スコープを含む新しい認証情報を生成する必要があります。

オブジェクト フィールドのマッピング

表のマッピングを使用して、Google Ads API の ProductLink を Data Manager API の PartnerLink にマッピングします。

ProductLink（Google Ads API） PartnerLink（Data Manager API） メモ
  • advertising_partner
  • data_partner
  • google_ads
  • merchant_center
 partner_account Data Manager API には、リンクされたアカウントのタイプごとに個別のフィールドはありません。すべてのアカウントの種類で、partner_account フィールドを ProductAccount に設定し、account_type と account_id を設定してリンクされたアカウントを識別します。
product_link_id partner_link_id
resource_name name

Google Ads API では、ProductLink の resource_name の customer_id は、既存のリンクを所有しているアカウントを示します。ProductLink を作成するときに、CreateProductLinkRequest の customer_id を設定してリンクのオーナーを指定します。

Data Manager API では、owning_account の accountType と accountId の組み合わせにより、既存のリンクを所有するアカウントが示されます。PartnerLink を作成するときに、name をオーナーのリソース名に設定して、リンクのオーナーを指定します。

詳細については、リソース名と作成リクエストをご覧ください。
type owning_account.account_type

リソース名

Data Manager API では、Google Ads API とは異なるリソース名形式が使用されます。

Google Ads API

Google Ads API では、ProductLink リソース名は次の形式を使用します。

customers/{customer_id}/productLinks/{product_link_id}

Data Manager API

Data Manager API では、PartnerLink リソース名は次の形式を使用します。

accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}

リンク管理リクエストのマッピング

このセクションのリクエスト マッピングを使用して、パートナー リンクの作成、削除、取得のリクエストを変換します。

リクエストを作成

Google Ads API の CreateProductLinkRequest を Data Manager API の同等の CreatePartnerLinkRequest に変換するフィールド マッピングは次のとおりです。

CreateProductLinkRequest（Google Ads API） CreatePartnerLinkRequest（Data Manager API） メモ
customer_id parent 所有する広告主アカウントのリソース名に設定します。
product_link partner_link PartnerLink リソースに設定します。オブジェクト フィールド マッピングをご覧ください。

リクエストを削除

Google Ads API の RemoveProductLinkRequest を Data Manager API の同等の DeletePartnerLinkRequest に変換するフィールド マッピングは次のとおりです。

RemoveProductLinkRequest（Google Ads API） DeletePartnerLinkRequest（Data Manager API） メモ
customer_id 同等のものはありません。 name フィールドは、所有アカウントとパートナー アカウントをカプセル化するため、この追加フィールドは必要ありません。
resource_name name 削除する PartnerLink のリソース名に設定します。
validate_only 同等のものはありません。

リンク取得リクエストのマッピング

パートナー リンクを取得する方法は、Google Ads API と Data Manager API で異なります。

Google Ads API

query を含む SearchGoogleAdsRequest を送信します。クエリのオプションの WHERE 句では、返すリソースを定義します。クエリの SELECT 句は、返された部分リソースに入力するフィールドを定義します。

SELECT
  product_link.product_link_id,
  ...
FROM product_link
WHERE
  ...
Data Manager API

SearchPartnerLinksRequest を送信します。オプションの filter リクエスト フィールドは、返すリソースを定義します。レスポンスには、すべてのフィールドが入力された完全なリソースが含まれます。

Google Ads API の SearchGoogleAdsRequest を Data Manager API の同等の SearchPartnerLinksRequest に変換するフィールド マッピングは次のとおりです。

SearchGoogleAdsRequest（Google Ads API） SearchPartnerLinksRequest（Data Manager API） メモ
customer_id parent 検索するアカウントのリソース名に設定します。
page_size page_size
page_token page_token
query filter filter を設定して、返すリソースを定義します。Data Manager API は完全なリソースを返すため、SELECT 句に相当するものはありません。
search_settings 同等のものはありません。
validate_only 同等のものはありません。

SearchPartnerLinksRequest リクエストの filter を作成する方法や、さまざまなシナリオでリクエスト ヘッダーを設定する方法など、詳細については、パートナー リンクを取得するをご覧ください。

前へ
アップグレードの手順