Alan eşlemeleri

İş ortağı bağlantısı iş akışlarınızın her adımını Google Ads API'den Data Manager API'ye yükseltmek için alan eşlemelerini kullanın:

Kimlik doğrulama

Data Manager API, Google Ads API'den farklı bir kapsama sahip kimlik bilgileri gerektirir. İş ortağı bağlantılarını yönetmek için Data Manager API kapsamını içeren yeni kimlik bilgileri oluşturmanız gerekir.

Nesne alanı eşlemeleri

Google Ads API'deki bir ProductLink'yi Data Manager API'deki PartnerLink eşdeğeriyle eşlemek için tablolardaki eşlemeleri kullanın.

ProductLink (Google Ads API) PartnerLink (Data Manager API) Notlar
  • advertising_partner
  • data_partner
  • google_ads
  • merchant_center
partner_account Data Manager API'de her bağlı hesap türü için ayrı alanlar yoktur. Tüm hesap türleri için partner_account alanını bir ProductAccount olarak ayarlayın ve bağlı hesabı tanımlamak için account_type ve account_id değerlerini ayarlayın.
product_link_id partner_link_id
resource_name name

Google Ads API'de, bir ProductLink için resource_name öğesinin customer_id alanı, mevcut bir bağlantının hangi hesaba ait olduğunu gösterir. ProductLink oluşturduğunuzda, CreateProductLinkRequest öğesinin customer_id değerini ayarlayarak bağlantının sahibini belirtirsiniz.

Veri Yöneticisi API'sinde, owning_account'nin accountType ve accountId kombinasyonu, mevcut bir bağlantının hangi hesaba ait olduğunu gösterir. PartnerLink oluştururken name değerini sahibin kaynak adına ayarlayarak bağlantının sahibini belirtirsiniz.

Ayrıntılar için Kaynak adları ve İstek oluşturma bölümlerine bakın.

type owning_account.account_type

Kaynak adları

Data Manager API, Google Ads API'den farklı bir kaynak adı biçimi kullanır.

Google Ads API

Google Ads API'de ProductLink kaynak adı şu biçimi kullanır:

customers/{customer_id}/productLinks/{product_link_id}

Data Manager API

Data Manager API'de PartnerLink kaynak adı şu biçimi kullanır:

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

Bağlantı yönetimi istek eşlemeleri

İş ortağı bağlantıları oluşturma, silme ve alma isteklerini dönüştürmek için bu bölümdeki istek eşlemelerini kullanın.

İstek oluştur

Google Ads API'deki bir CreateProductLinkRequest öğesini Data Manager API'deki eşdeğeri olan CreatePartnerLinkRequest öğesine dönüştürmek için alan eşlemeleri aşağıda verilmiştir.

CreateProductLinkRequest (Google Ads API) CreatePartnerLinkRequest (Data Manager API) Notlar
customer_id parent Sahip olan reklamveren hesabının kaynak adına ayarlanır.
product_link partner_link PartnerLink kaynağına ayarlandı. Nesne alanı eşlemeleri bölümüne bakın.

İsteği silin

Google Ads API'deki bir RemoveProductLinkRequest öğesini Data Manager API'deki eşdeğeri olan DeletePartnerLinkRequest öğesine dönüştürmek için alan eşlemeleri aşağıda verilmiştir.

RemoveProductLinkRequest (Google Ads API) DeletePartnerLinkRequest (Data Manager API) Notlar
customer_id Eşdeğeri yok. name alanı, sahip ve iş ortağı hesaplarını kapsadığından bu ek alana gerek yoktur.
resource_name name Kaldırmak istediğiniz PartnerLink kaynağının adına ayarlayın.
validate_only Eşdeğeri yok.

Bağlantı alma isteği eşlemeleri

İş ortağı bağlantılarını alma yaklaşımı, Google Ads API ile Data Manager API'si arasında farklılık gösterir.

Google Ads API

query içeren bir SearchGoogleAdsRequest gönderin. Sorgunun isteğe bağlı WHERE ifadesi, hangi kaynakların döndürüleceğini tanımlar. Sorgunun SELECT ifadesi, döndürülen kısmi kaynaklarda hangi alanların doldurulacağını tanımlar.

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

SearchPartnerLinksRequest gönderin. İsteğe bağlı filter istek alanı, hangi kaynakların döndürüleceğini tanımlar. Yanıt, tüm alanları doldurulmuş eksiksiz kaynaklar içeriyor.

Google Ads API'deki bir SearchGoogleAdsRequest öğesini Data Manager API'deki eşdeğeri olan SearchPartnerLinksRequest öğesine dönüştürmek için alan eşlemeleri aşağıda verilmiştir.

SearchGoogleAdsRequest (Google Ads API) SearchPartnerLinksRequest (Data Manager API) Notlar
customer_id parent Aranacak hesabın kaynak adı olarak ayarlanır.
page_size page_size
page_token page_token
query filter Hangi kaynakların döndürüleceğini tanımlamak için filter değerini ayarlayın. Data Manager API, tam kaynaklar döndürür. Bu nedenle, SELECT ifadesinin eşdeğeri yoktur.
search_settings Eşdeğeri yok.
validate_only Eşdeğeri yok.

SearchPartnerLinksRequest isteğinin filter değerini oluşturma ve farklı senaryolar için istek başlıklarını ayarlama gibi daha fazla bilgi için İş ortağı bağlantılarını alma bölümüne göz atın.