Hệ phân cấp tên
Tên tài nguyên được sử dụng trong API Báo cáo Search Ads 360 mang tính phân cấp, phản ánh cách tổ chức các thực thể trong Search Ads 360. Hầu hết các tài nguyên đều là tài nguyên phụ của tài nguyên Customer, 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 Search Ads 360 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ể API Báo cáo Search Ads 360 (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ó 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).