Alan eşlemeleri

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

Nesne alanı eşlemeleri

Tablolardaki eşlemeleri kullanarak Google Ads API'deki ProductLink öğesini Data Manager API'deki PartnerLink eşdeğeriyle eşleyin.

ProductLink (Google Ads API) PartnerLink (Veri Yöneticisi API'si) Notlar
  • advertising_partner
  • data_partner
  • google_ads
  • merchant_center
 partner_account Veri Yöneticisi API'sinde, her tür bağlı hesap için ayrı alanlar yoktur. Tüm hesap türleri için partner_account alanını ProductAccount olarak ayarlayın ve bağlı hesabı tanımlamak için account_type ile account_id alanlarını ayarlayın.
product_link_id partner_link_id
resource_name name

Google Ads API'sinde, customer_id resource_name ProductLink, mevcut bir bağlantının hangi hesaba ait olduğunu gösterir. ProductLink oluşturduğunuzda, CreateProductLinkRequest öğesinin customer_id özelliğini ayarlayarak bağlantının sahibini belirtirsiniz.

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

Ayrıntılı bilgi için Kaynak adları ve Oluşturma isteği başlıklı makaleleri inceleyin.

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 isteği eşlemeleri

İş ortağı bağlantılarını 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 CreateProductLinkRequest öğesini Data Manager API'deki eşdeğeri CreatePartnerLinkRequest öğesine dönüştürmek için alan eşlemeleri aşağıda verilmiştir.

CreateProductLinkRequest (Google Ads API) CreatePartnerLinkRequest (Veri Yöneticisi API'si) Notlar
customer_id parent Sahip reklamveren hesabının kaynak adı olarak ayarlanır.
product_link partner_link PartnerLink kaynağı olarak ayarlayın. Nesne alanı eşlemeleri başlıklı makaleyi inceleyin.

İsteği silin

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

RemoveProductLinkRequest (Google Ads API) DeletePartnerLinkRequest (Veri Yöneticisi API'si) Notlar
customer_id Eşdeğeri yok. name alanı, sahip olunan ve iş ortağı hesaplarını kapsadığından bu ek alan gerekli değildir.
resource_name name Kaldırmak istediğiniz PartnerLink öğesinin kaynak adını 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 Veri Yöneticisi 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

SearchPartnerLinkRequest gönderin. İsteğe bağlı filter istek alanı, hangi kaynakların döndürüleceğini tanımlar. Yanıtta tüm alanları doldurulmuş eksiksiz kaynaklar yer alıyor.

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

SearchGoogleAdsRequest (Google Ads API) SearchPartnerLinksRequest (Veri Yöneticisi API'si) Notlar
customer_id parent Aranacak hesabın kaynak adı olarak ayarlayın.
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. Veri Yöneticisi API'si tam kaynaklar döndürdüğünden SELECT ifadesine eşdeğer bir ifade yoktur.
search_settings Eşdeğeri yok.
validate_only Eşdeğeri yok.

filter isteğinin nasıl oluşturulacağı ve farklı senaryolar için istek başlıklarının nasıl ayarlanacağı da dahil olmak üzere daha fazla bilgi için İş ortağı bağlantılarını alma başlıklı makaleyi inceleyin.SearchPartnerLinksRequest

Önceki
Yükseltme adımları