フィールド マッピング

フィールド マッピングを使用して、パートナー リンク ワークフローの各ステップを Google Ads API からデータマネージャー 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 データマネージャー 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

リソース名

データ マネージャー 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 をデータ マネージャー API の同等の CreatePartnerLinkRequest に変換するためのフィールド マッピングは次のとおりです。

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

リクエストを削除

Google Ads API の RemoveProductLinkRequest をデータ マネージャー API の同等の DeletePartnerLinkRequest に変換するためのフィールド マッピングは次のとおりです。

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

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

パートナー リンクを取得する方法は、Google Ads API とデータマネージャー API で異なります。

Google Ads API

query を含む SearchGoogleAdsRequest を送信します。クエリの WHERE 句（省略可）は、返すリソースを定義します。クエリの SELECT 句は、返される部分リソースに設定するフィールドを定義します。

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

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

Google Ads API の SearchGoogleAdsRequest をデータ マネージャー 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 を作成する方法や、さまざまなシナリオでリクエスト ヘッダーを設定する方法など、詳細については、パートナー リンクを取得するをご覧ください。

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