Caution: You are viewing documentation for the API's REST interface. Most of our official client libraries use gRPC. See the REST Introduction for details.

Nama Resource

Hierarki nama

Nama resource yang digunakan di Google Ads API bersifat hierarkis, mencerminkan organisasi entitas dalam Google Ads. Hampir semua resource adalah 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 adalah sub-resource dari resource pelanggan root.

Resource Nama Resource
Pelanggan customers/1234567890
Kampanye customers/1234567890/campaigns/8765432109
GrupIklan customers/1234567890/adGroups/54321098765
IklanGrupIklan customers/1234567890/adGroupAds/54321098765~2109876543210

ID resource

Entitas Google Ads (pelanggan, kampanye, dll.) dirujuk menggunakan 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, mungkin ada baiknya mengurai 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 dengan ID koleksi) sebagai berikut:

Komponen nama resource
ID fasilitas
ID pelanggan:
"1234567890"
ID grup iklan:
"54321098765"
ID iklan grup iklan:
"2109876543210"
ID koleksi
"customers"
"adGroupAds"

Mengurai ID individual memungkinkan Anda mendapatkan nama resource baru untuk mereferensikan pelanggan iklan grup iklan (customers/1234567890) atau grup iklannya (customers/1234567890/adGroupAds/54321098765).

ID objek bersama

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

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

Diagram yang menunjukkan hubungan nama resource dengan hierarki akun.

Misalnya, membuat panggilan API ke akun pengelola untuk memperbarui periode lihat balik tindakan konversi akan mereferensikan objek yang dibagikan menggunakan nama resource: customers/9876543210/conversionActions/257733534.

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

Tindakan ini sama dengan tindakan konversi yang mendasarinya, tetapi nama resource-nya relatif terhadap akun yang digunakan untuk mengaksesnya.