Pemetaan kolom

Gunakan pemetaan kolom untuk meng-upgrade setiap langkah alur kerja penautan partner Anda dari Google Ads API ke Data Manager API:

Pemetaan kolom objek

Gunakan pemetaan dalam tabel untuk memetakan ProductLink di Google Ads API ke PartnerLink yang setara di Data Manager API.

ProductLink (Google Ads API) PartnerLink (Data Manager API) Catatan
  • advertising_partner
  • data_partner
  • google_ads
  • merchant_center
 partner_account Data Manager API tidak memiliki kolom terpisah untuk setiap jenis akun tertaut. Untuk semua jenis akun, tetapkan kolom partner_account ke ProductAccount, dan tetapkan account_type dan account_id-nya untuk mengidentifikasi akun tertaut.
product_link_id partner_link_id
resource_name name

Di Google Ads API, customer_id dari resource_name ProductLink menunjukkan akun mana yang memiliki link yang ada. Saat membuat ProductLink, Anda menunjukkan pemilik link dengan menetapkan customer_id dari CreateProductLinkRequest.

Di Data Manager API, kombinasi accountType dan accountId dari owning_account menunjukkan akun mana yang memiliki link yang ada. Saat membuat PartnerLink, Anda menunjukkan pemilik link dengan menyetel name ke nama resource pemilik.

Lihat Nama resource dan Buat permintaan untuk mengetahui detailnya.

type owning_account.account_type

Nama resource

Data Manager API menggunakan format nama resource yang berbeda dengan Google Ads API.

Google Ads API

Di Google Ads API, nama resource ProductLink menggunakan format:

customers/{customer_id}/productLinks/{product_link_id}

Data Manager API

Di Data Manager API, nama resource PartnerLink menggunakan format:

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

Pemetaan permintaan pengelolaan penautan

Gunakan pemetaan permintaan di bagian ini untuk mengonversi permintaan pembuatan, penghapusan, dan pengambilan link partner.

Buat permintaan

Berikut adalah pemetaan kolom untuk mengonversi CreateProductLinkRequest di Google Ads API ke CreatePartnerLinkRequest yang setara di Data Manager API.

CreateProductLinkRequest (Google Ads API) CreatePartnerLinkRequest (Data Manager API) Catatan
customer_id parent Disetel ke nama resource akun pengiklan pemilik.
product_link partner_link Disetel ke resource PartnerLink. Lihat Pemetaan kolom objek

Hapus permintaan

Berikut adalah pemetaan kolom untuk mengonversi RemoveProductLinkRequest di Google Ads API ke DeletePartnerLinkRequest yang setara di Data Manager API.

RemoveProductLinkRequest (Google Ads API) DeletePartnerLinkRequest (Data Manager API) Catatan
customer_id Tidak ada ekuivalen. Kolom name mencakup akun pemilik dan partner, sehingga kolom tambahan ini tidak diperlukan.
resource_name name Disetel ke nama resource PartnerLink yang ingin dihapus.
validate_only Tidak ada ekuivalen.

Pemetaan permintaan pengambilan link

Pendekatan untuk mengambil link partner berbeda antara Google Ads API dan Data Manager API.

Google Ads API

Mengirim SearchGoogleAdsRequest yang berisi query. Klausul WHERE opsional dari kueri menentukan resource mana yang akan ditampilkan. Klausa SELECT kueri menentukan kolom yang akan diisi pada resource sebagian yang ditampilkan.

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

Mengirim SearchPartnerLinkRequest. Kolom permintaan filter opsional menentukan resource yang akan ditampilkan. Respons berisi resource lengkap, dengan semua kolom terisi.

Berikut adalah pemetaan kolom untuk mengonversi SearchGoogleAdsRequest di Google Ads API ke SearchPartnerLinksRequest yang setara di Data Manager API.

SearchGoogleAdsRequest (Google Ads API) SearchPartnerLinksRequest (Data Manager API) Catatan
customer_id parent Disetel ke nama resource akun yang akan ditelusuri.
page_size page_size
page_token page_token
query filter Tetapkan filter untuk menentukan resource mana yang akan ditampilkan. Data Manager API menampilkan resource lengkap, sehingga tidak ada yang setara dengan klausa SELECT.
search_settings Tidak ada ekuivalen.
validate_only Tidak ada ekuivalen.

Lihat Mengambil link partner untuk mengetahui informasi selengkapnya, termasuk cara membuat filter permintaan SearchPartnerLinksRequest dan menetapkan header permintaan untuk berbagai skenario.

Sebelumnya
Langkah-langkah untuk mengupgrade