Hệ phân cấp tên
Tên tài nguyên được sử dụng trong API Google Ads mang tính phân cấp, phản ánh cách tổ chức các thực thể trong Google Ads. Hầu hết các tài nguyên đều là tài nguyên phụ
của tài nguyên Customer, điều này phản ánh thực tế là hầu hết lệnh gọi API đều phải nhắm đến
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 tài nguyên gốc của khách hàng.
| Tài nguyên | Tên tài nguyên |
|---|---|
| Khách hàng | customers/1234567890
|
| Chiến dịch | customers/1234567890/campaigns/8765432109
|
| AdGroup | customers/1234567890/adGroups/54321098765
|
| AdGroupAd | customers/1234567890/adGroupAds/54321098765~2109876543210
|
Mã tài nguyên
Các thực thể Google Ads (khách hàng, chiến dịch, v.v.) được tham chiếu bằng tên tài nguyên trong toàn bộ API. Tuy nhiên, điều quan trọng cần lưu ý là bản thân tên tài nguyên có thể có các mã nhận dạng tài nguyên dạng số duy nhất 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 và 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
Bạn có thể chia nhỏ mã này thành các mã 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ã tài nguyên |
|
||||||
| Mã bộ sưu tập |
|
||||||
Việc phân tích cú pháp các mã nhận dạng riêng lẻ cho phép bạn lấy tên tài nguyên mới để tham chiếu đến
khách hàng của quảng cáo của 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).
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 khách hàng Google Ads cụ thể. 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 nội dung như danh sách từ khoá phủ định hoặc hành động chuyển đổi trên nhiều tài khoản, 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 các đối tượng như vậy sẽ khác nhau, tuỳ thuộc vào tài khoản mà bạn đang gửi lệnh gọi API đến.
Ví dụ: Hành động chuyển đổi trên nhiều tài khoản
Giả sử tài khoản người quản lý 987-654-3210 của chúng ta có chia sẻ hành động chuyển đổi trên nhiều tài khoản với một trong các tài khoản khách hàng của tài khoản khách hàng 123-456-7890:
Ví dụ: việc thực hiện lệnh gọi API đến tài khoản người quản lý để cập nhật giai đoạn xem lại của hành động chuyển đổi 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.
Việc thực hiện lệnh gọi API đến tài khoản khách hàng để chọn sử dụng hành động chuyển đổi được chia sẻ sẽ tham chiếu đến hành động đó bằng tên tài nguyên: customers/1234567890/conversionActions/257733534.
Đây cũng là hành động chuyển đổi cơ bản, nhưng tên tài nguyên của hành động này tương ứng với tài khoản dùng để truy cập vào hành động đó.