Tên tài nguyên

Hệ thống phân cấp tên

Tên tài nguyên được dùng trong Search Ads 360 Reporting API có tính phân cấp, phản ánh cấu trúc của 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, đ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 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à tài nguyên phụ của 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ể của Search Ads 360 Reporting API (khách hàng, chiến dịch, v.v.) được gọi bằng tên tài nguyên của chúng trong toàn bộ API. Tuy nhiên, bạn cần lưu ý rằng bản thân tên tài nguyên có thể có mã nhận dạng tài nguyên dạng số riêng biệ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 cú pháp tên tài nguyên để trích xuất các mã tài nguyên này và tập hợp một mã mới.

Ví dụ: hãy 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 mã này thành các mã nhận dạng tài nguyên riêng lẻ (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ã khách hàng:
"1234567890"
mã nhóm quảng cáo:
"54321098765"
mã quảng cáo trong nhóm quảng cáo:
"2109876543210"
Mã bộ sưu tập
"customers"
"adGroupAds"

Việc phân tích cú pháp từng 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).