Tên tài nguyên

Hệ phân cấp tên

Tên tài nguyên dùng trong API Google Ads mang tính phân cấp, phản ánh hệ thống của các pháp nhân trong Google Ads. Hầu hết mọi tài nguyên đều là tài nguyên phụ của Customer phản ánh thực tế là hầu hết mọi lệnh gọi API đều phải nhắm mục tiêu một tài khoản Google Ads cụ thể. Ví dụ: chiến dịch, nhóm quảng cáo, quảng cáo và từ khoá đều là các tài nguyên phụ của một tài nguyên của khách hàng gốc.

Tài nguyên	Tên tài nguyên
Khách hàng	customers/1234567890
Chiến dịch	customers/1234567890/campaigns/8765432109
Nhóm Quảng cáo	customers/1234567890/adGroups/54321098765
AdGroupAd	customers/1234567890/adGroupAds/54321098765~2109876543210

Lưu ý quan trọng: Việc sử dụng API Google Ads Tên tài nguyên tương đối (và không phải là tên đầy đủ của tài nguyên như một số API khác của Google).

Mã tài nguyên

Các thực thể Google Ads (khách hàng, chiến dịch, v.v.) được gọi theo tài nguyên tên xuyên suốt API. Tuy nhiên, điều quan trọng cần lưu ý là tài nguyên tên riêng có thể có tài nguyên số duy nhất Mã nhận dạng giúp xác định từng đối tượng trong hệ phân cấp. Trong những trường hợp này, có thể bạn nên phân tích cú pháp tên tài nguyên để trích xuất các mã nhận dạng tài nguyên này rồi tập hợp một mã mới.

Ví dụ: kiểm tra tên tài nguyên AdGroupAd trong bảng trước:

customers/1234567890/adGroupAds/54321098765~2109876543210

Tài nguyên này có thể được chia nhỏ thành từng mã nhận dạng tài nguyên riêng lẻ (được phân tách bằng mã bộ sưu tập) như sau:

Thành phần tên tài nguyên
Mã nhận dạng tài nguyên	mã khách hàng: "1234567890" mã nhóm quảng cáo: "54321098765" mã quảng cáo của nhóm quảng cáo: "2109876543210"
Mã bộ sưu tập	"customers" "adGroupAds"

Khi phân tích cú pháp mã nhận dạng cá nhân, bạn có thể lấy được tên tài nguyên mới để tham chiếu khách hàng của quảng cáo trong nhóm quảng cáo (customers/1234567890) hoặc nhóm quảng cáo của nhóm quảng cáo (customers/1234567890/adGroupAds/54321098765).

Lưu ý quan trọng: Tên tài nguyên trong yêu cầu JSON và nội dung phản hồi được tham chiếu bằng trường resourceName, chứ không phải trường name giống như trong một số API Google Cloud khác. Nhiều mục trên Google Ads đã có tên tự phân bổ (campaign.Name, adGroup.Name, v.v.) nên resourceName được dùng để tránh xung đột với các tên đối tượng hiện có.

Giá trị nhận dạng của đối tượng dùng chung

Hầu hết các đối tượng trong API đều được liên kết với một tài khoản Google Ads cụ thể khách hàng. Tuy nhiên, có một số loại đối tượng có thể được chia sẻ giữa nhiều tài khoản. Trong thực tế, đây là những việc như từ khoá phủ định danh sách hoặc nhiều tài khoản hành động chuyển đổi thường do người quản lý tạo và sau đó được chia sẻ với nhiều tài khoản khách hàng.

Tên tài nguyên của những đối tượng như thế này sẽ khác nhau, tuỳ thuộc vào việc mà bạn đang gửi lệnh gọi API tới.

Ví dụ: Hành động chuyển đổi trên nhiều tài khoản

Giả sử chúng ta có tài khoản người quản lý 987-654-3210 dùng chung nhiều tài khoản hành động chuyển đổi với một trong các tài khoản khách hàng khách hàng 123-456-7890:

Thực hiện lệnh gọi API đến tài khoản người quản lý để chẳng hạn như cập nhật lượt chuyển đổi giai đoạn xem lại của hành động sẽ tham chiếu đến đối tượng được chia sẻ bằng cách sử dụng tên tài nguyên: customers/9876543210/conversionActions/257733534.

Thực hiện lệnh gọi API tới tài khoản khách hàng để chọn tham gia sử dụng tài khoản được chia sẻ hành động chuyển đổi sẽ tham chiếu hành động đó bằng cách sử dụng tên tài nguyên: customers/1234567890/conversionActions/257733534.

Đây là cùng một hành động chuyển đổi cơ bản, nhưng tên tài nguyên của hành động này là tương đối với tài khoản dùng để truy cập vào email đó.