Hierarki nama
Nama resource yang digunakan di Google Ads API bersifat hierarkis, yang mencerminkan organisasi entity 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
|
| AdGroup | customers/1234567890/adGroups/54321098765
|
| AdGroupAd | customers/1234567890/adGroupAds/54321098765~2109876543210
|
ID resource
Entity Google Ads (pelanggan, kampanye, dll.) dirujuk berdasarkan nama resourcenya 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 berguna untuk mengurai nama resource guna mengekstrak ID resource ini dan merakit yang baru.
Misalnya, periksa nama resource AdGroupAd dari tabel sebelumnya:
customers/1234567890/adGroupAds/54321098765~2109876543210
Hal ini dapat dipecah menjadi ID resource individual (dipisahkan oleh ID koleksi) sebagai berikut:
| Komponen nama resource | |||||||
|---|---|---|---|---|---|---|---|
| ID resource |
|
||||||
| ID Koleksi |
|
||||||
Dengan mengurai ID individual, Anda dapat memperoleh nama resource baru untuk merujuk
pelanggan iklan grup iklan (customers/1234567890) atau grup iklannya
(customers/1234567890/adGroupAds/54321098765).
ID objek bersama
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 ini 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 pengelola 987-654-3210 yang membagikan tindakan konversi lintas-akun dengan salah satu akun pelanggan kliennya 123-456-7890:
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.
Melakukan panggilan API ke akun klien untuk memilih menggunakan tindakan konversi bersama akan merujuknya menggunakan nama resource: customers/1234567890/conversionActions/257733534.
Ini adalah tindakan konversi dasar yang sama, tetapi nama resourcenya relatif terhadap akun yang digunakan untuk mengaksesnya.