Nama Resource

Hierarki nama

Nama resource yang digunakan di Google Ads API bersifat hierarkis, yang mencerminkan organisasi entitas dalam Google Ads. Hampir semua resource merupakan sub-resource dari Customer , yang mencerminkan fakta bahwa hampir setiap panggilan API harus menargetkan akun Google Ads tertentu. Misalnya, Campaigns, Ad groups, Ads, dan Keywords 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

Poin Penting: Google Ads API menggunakan Nama resource relatif (dan bukan nama resource lengkap seperti beberapa Google API lainnya).

ID resource

Entitas Google Ads (pelanggan, kampanye, dll.) dirujuk oleh resource mereka nama di seluruh API. Namun, penting untuk dicatat bahwa sumber daya nama itu sendiri mungkin memiliki sumber daya numerik ID yang mengidentifikasi setiap objek dalam hierarki. Dalam kasus 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

Ini dapat dibagi menjadi ID sumber daya 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 bisa mendapatkan nama resource baru sebagai referensi pelanggan iklan grup iklan (customers/1234567890) atau grup iklannya (customers/1234567890/adGroupAds/54321098765).

Poin Penting: Nama resource di isi permintaan dan respons JSON dirujuk oleh isian resourceName, bukan name seperti di beberapa Google Cloud API lainnya. Banyak entitas Google Ads memiliki nama mengatribusikan dirinya sendiri (campaign.Name, adGroup.Name, dll.), jadi resourceName digunakan untuk menghindari bentrok dengan nama objek yang sudah ada.

ID objek yang dibagikan

Sebagian besar objek di API dikaitkan dengan satu Google Ads spesifik juga merupakan pelanggan Google Workspace. Namun, ada beberapa jenis objek yang dapat digunakan bersama di antara beberapa akun. Dalam praktiknya, ini adalah hal-hal seperti kata kunci negatif daftar atau lintas-akun tindakan konversi yang biasanya dibuat oleh manajer dan kemudian dibagikan ke banyak akun klien.

Nama sumber daya objek seperti ini akan berbeda, tergantung pada akun yang Anda kirimi panggilan API.

Contoh: Tindakan konversi lintas-akun

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

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

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

Ini adalah tindakan konversi pokok yang sama, tetapi nama resource-nya relatif ke akun yang digunakan untuk mengaksesnya.