Nama Resource

Hierarki nama

Nama resource yang digunakan di Google Ads API bersifat hierarkis, yang mencerminkan organisasi entitas dalam Google Ads. Hampir semua resource merupakan sub-resource dari resource Customer, yang mencerminkan fakta bahwa hampir setiap panggilan API harus menargetkan akun Google Ads tertentu. Misalnya, kampanye, grup iklan, iklan, dan kata kunci merupakan sub-resource dari resource pelanggan root.

Resource	Nama Resource
Pelanggan	customers/1234567890
Kampanye	customers/1234567890/campaigns/8765432109
AdGroup	customers/1234567890/adGroups/54321098765
AdGroupAd	customers/1234567890/adGroupAds/54321098765~2109876543210

Poin Penting: Google Ads API menggunakan nama resource relative (dan bukan nama resource relative seperti beberapa Google API lainnya).

ID resource

Entitas Google Ads (pelanggan, kampanye, dll.) dirujuk oleh nama resource mereka di seluruh API. Namun, penting untuk diperhatikan bahwa nama resource itu sendiri mungkin memiliki ID resource numerik unik yang mengidentifikasi setiap objek dalam hierarki. Dalam kasus ini, sebaiknya urai nama resource untuk mengekstrak ID resource ini dan menyusun yang baru.

Misalnya, periksa nama resource AdGroupAd dari tabel sebelumnya:

customers/1234567890/adGroupAds/54321098765~2109876543210

ID ini dapat dibagi menjadi ID resource individualnya (dipisahkan oleh ID koleksi) sebagai berikut:

Komponen nama resource
ID Resource	ID pelanggan: "1234567890" ID grup iklan: "54321098765" ID iklan grup iklan: "2109876543210"
ID Koleksi	"customers" "adGroupAds"

Dengan menguraikan ID individual, Anda dapat memperoleh nama resource baru untuk merujuk pelanggan iklan grup iklan (customers/1234567890) atau grup iklannya (customers/1234567890/adGroupAds/54321098765).

Poin Penting: Nama resource dalam isi permintaan dan respons JSON dirujuk oleh kolom resourceName, bukan kolom name seperti di beberapa Google Cloud API lainnya. Banyak entitas Google Ads yang memiliki atribut nama itu sendiri (campaign.Name, adGroup.Name, dll.), sehingga resourceName digunakan untuk menghindari konflik dengan nama objek yang sudah ada.

ID objek yang dibagikan

Sebagian besar objek di API dikaitkan dengan satu pelanggan Google Ads tertentu. Namun, ada beberapa jenis objek yang dapat digunakan bersama oleh beberapa akun. Dalam praktiknya, hal-hal tersebut adalah daftar kata kunci negatif atau tindakan konversi lintas-akun yang biasanya dibuat oleh pengelola, lalu dibagikan ke banyak akun klien.

Nama resource objek seperti ini akan berbeda, bergantung pada akun tujuan pengiriman panggilan API.

Contoh: Tindakan konversi lintas-akun

Misalkan kita memiliki akun pengelola 987-654-3210 yang berbagi tindakan konversi lintas-akun dengan salah satu akun pelanggan kliennya 123-456-7890:

Melakukan panggilan API ke akun pengelola, misalnya, memperbarui periode lihat balik tindakan konversi akan mereferensikan objek bersama menggunakan nama resource: customers/9876543210/conversionActions/257733534.

Melakukan panggilan API ke akun klien untuk memilih ikut serta menggunakan tindakan konversi bersama akan mereferensikannya menggunakan nama resource: customers/1234567890/conversionActions/257733534.

Ini adalah tindakan konversi pokok yang sama, tetapi nama resource-nya relatif terhadap akun yang digunakan untuk mengaksesnya.