Nama Resource

Hierarki nama

Nama resource yang digunakan di Search Ads 360 Reporting API bersifat hierarkis, yang mencerminkan pengaturan entitas dalam Search Ads 360. Hampir semua resource adalah 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 adalah semua 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-nya 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 hal ini, sebaiknya mengurai nama resource untuk mengekstrak ID resource ini dan menyusun yang baru.

Misalnya, periksa nama resource AdGroupAd dari tabel sebelumnya:

customers/1234567890/adGroupAds/54321098765~2109876543210

Hal ini dapat dipecah menjadi ID resource masing-masing (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).