Nama Resource

Hierarki nama

Nama resource yang digunakan di Google Ads API bersifat hierarkis, yang mencerminkan organisasi entitas dalam Google Ads. Hampir semua resource adalah sub-resource dari resource Customer, yang mencerminkan fakta bahwa hampir setiap panggilan API harus menarget akun Google Ads tertentu. Misalnya, kampanye, grup iklan, iklan, dan kata kunci, semuanya 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

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 dapat 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 ID baru.

Misalnya, periksa nama resource AdGroupAd dari tabel sebelumnya:

customers/1234567890/adGroupAds/54321098765~2109876543210

Hal ini dapat diperinci 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 mengurai ID individual, Anda dapat memperoleh nama resource baru untuk mereferensikan pelanggan iklan grup iklan (customers/1234567890) atau grup iklannya (customers/1234567890/adGroupAds/54321098765).

ID objek yang dibagikan

Sebagian besar objek di API dikaitkan dengan satu pelanggan Google Ads tertentu. Namun, ada beberapa jenis objek yang dapat dibagikan di antara beberapa akun. Dalam praktiknya, hal-hal seperti 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 yang Anda kirimi panggilan API.

Contoh: Tindakan konversi lintas-akun

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

Diagram yang menunjukkan hubungan nama resource dengan hierarki akun.

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

Membuat 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 dengan akun yang digunakan untuk mengaksesnya.