Pemetaan kolom

Gunakan pemetaan kolom untuk mengupgrade setiap langkah alur kerja link partner dari Google Ads API ke Data Manager API:

• Pemetaan kolom objek berisi pemetaan kolom untuk resource yang mewakili objek link partner.
• Pemetaan permintaan pengelolaan link berisi pemetaan kolom untuk permintaan guna membuat dan menghapus link partner.
• Pemetaan permintaan pengambilan link berisi pemetaan kolom untuk mengambil link partner.

Pemetaan kolom objek

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

Poin Penting: ProductLink dan PartnerLink adalah representasi yang berbeda dari entity link yang sama. Jika sudah memiliki ProductLink di Google Ads API , Anda dapat mengambil dan mengelolanya sebagai PartnerLink di Data Manager API. Jangan mencoba membuat PartnerLink lain untuk pasangan akun yang sama.

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 serta account_id untuk mengidentifikasi akun tertaut.
product_link_id	partner_link_id
resource_name	name	Di Google Ads API, customer_id dari resource_name dari 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 menetapkan 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 link

Gunakan pemetaan permintaan di bagian ini untuk mengonversi permintaan guna membuat, menghapus, dan mengambil link partner.

Buat permintaan

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

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

Hapus permintaan

Berikut pemetaan kolom untuk mengonversi a RemoveProductLinkRequest di Google Ads API ke its equivalent DeletePartnerLinkRequest di the Data Manager API.

RemoveProductLinkRequest (Google Ads API)	DeletePartnerLinkRequest (Data Manager API)	Catatan
customer_id	Tidak ada ekuivalen.	Kolom name merangkum akun pemilik dan partner, sehingga kolom tambahan ini tidak diperlukan.
resource_name	name	Tetapkan 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

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

SELECT
  product_link.product_link_id,
  ...
FROM product_link
WHERE
  ...

Data Manager API

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

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

SearchGoogleAdsRequest (Google Ads API)	SearchPartnerLinksRequest (Data Manager API)	Catatan
customer_id	parent	Tetapkan ke nama resource akun yang akan ditelusuri.
page_size	page_size
page_token	page_token
query	filter	Tetapkan filter untuk menentukan resource yang akan ditampilkan. Data Manager API menampilkan lengkap resource, sehingga tidak ada yang setara dengan klausul 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.