İş 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:
- Object field mappings, iş ortağı bağlantı nesnesini temsil eden kaynağın alan eşlemelerini içerir.
- Bağlantı yönetimi isteği eşlemeleri, iş ortağı bağlantısı oluşturma ve silme istekleri için alan eşlemeleri içerir.
- Bağlantı alma isteği eşlemeleri, iş ortağı bağlantılarını almak için alan eşlemeleri içerir.
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 |
|---|---|---|
|
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
Veri Yöneticisi API'sinde, 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
ProductLinkkaynak adı şu biçimi kullanır:customers/{customer_id}/productLinks/{product_link_id}- Data Manager API
Data Manager API'de
PartnerLinkkaynak 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
queryiçeren birSearchGoogleAdsRequestgönderin. Sorgunun isteğe bağlıWHEREifadesi, hangi kaynakların döndürüleceğini tanımlar. SorgununSELECTifadesi, 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
SearchPartnerLinksRequestgönderin. İsteğe bağlıfilteristek 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.