フィールド マッピング

フィールド マッピングを使用して、パートナーリンク ワークフローの各ステップを 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 では、customer_id の resource_name の ProductLink は、既存の リンクを所有するアカウントを示します。ProductLink を作成するときに、customer_id を設定して、CreateProductLinkRequest の所有者を示します。

Data Manager API では、accountType と accountId の owning_account の組み合わせは、既存のリンクを所有するアカウントを示します。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 同等のものはありません。

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

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