Hierarki nama
Nama resource yang digunakan di Search Ads 360 Reporting API bersifat hierarkis, yang mencerminkan
organisasi entitas di Search Ads 360. Hampir semua resource merupakan sub-resource
dari resource Customer
, yang mencerminkan fakta bahwa hampir setiap panggilan API harus menargetkan
akun Search Ads 360 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
|
ID resource
Entitas Search Ads 360 Reporting API (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 Koleksi |
|
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
).