Hệ phân cấp tên
Tên tài nguyên được dùng trong API Google Ads có tính phân cấp, phản ánh cấu trúc của 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 mọi 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à tài nguyên phụ của một tài nguyên 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
|
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 theo 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ó mã nhận dạng tài nguyên bằng số duy nhất để xác định từng đối tượng trong hệ phân cấp. Trong những trường hợp này, bạn nên phân tích tên tài nguyên để trích xuất các mã nhận dạng tài nguyên này và lắp ráp một mã nhận dạng mới.
Ví dụ: hãy xem xét tên tài nguyên AdGroupAd trong bảng trước:
customers/1234567890/adGroupAds/54321098765~2109876543210
Bạn có thể chia thành các mã nhận dạng tài nguyên riêng lẻ (được phân tách bằng mã nhận dạng 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ã 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 trong nhóm quảng cáo (customers/1234567890) hoặc nhóm quảng cáo của quảng cáo đó (customers/1234567890/adGroupAds/54321098765).
Giá trị nhận dạng của các đối tượng được chia sẻ
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 cụ thể trên Google Ads. 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. Trên thực tế, đây là những thứ 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 rồi 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ư thế nà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ử chúng ta có tài khoản người quản lý 987-654-3210 chia sẻ một 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 123-456-7890:
Ví dụ: khi thực hiện một lệnh gọi API đến tài khoản người quản lý để cập nhật khoảng thời gian xem lại của hành động chuyển đổi, bạn sẽ tham chiếu đến đối tượng dùng chung bằng tên tài nguyên: customers/9876543210/conversionActions/257733534.
Khi thực hiện một 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ẻ, bạn sẽ tham chiếu hành động đó bằng tên tài nguyên: customers/1234567890/conversionActions/257733534.
Đây là hành động chuyển đổi cơ bản tương tự, nhưng tên tài nguyên của hành động này có liên quan đến tài khoản được dùng để truy cập vào hành động đó.