フィールド マッピング

フィールド マッピングを使用して、パートナー リンク ワークフローの各ステップを 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 データマネージャー 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 を設定して、リンクの所有者を示します。

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

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