Tên tài nguyên

Bảng phân cấp tên

Tên tài nguyên được sử dụng trong API Google Ads có tính phân cấp, phản ánh cách sắp xếp các mục trong Google Ads. Hầu hết tất cả tài nguyên đều là tài nguyên phụ của tài nguyên Customer, phản ánh một 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ừ khóa là tất cả 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
Nhóm Quảng cáo	customers/1234567890/adGroupAds/54321098765~2109876543210

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

Mã tài nguyên

Các thực thể của Google Ads (khách hàng, chiến dịch, v.v.) được tham chiếu bằng tên tài nguyên của họ trên toàn bộ API. Tuy nhiên, điều quan trọng cần lưu ý là tên tài nguyên có thể có mã tài nguyên duy nhất bằng số để xác định từng đối tượng trong hệ thống 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ạo một mã tài nguyên mới.

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

customers/1234567890/adGroupAds/54321098765~2109876543210

Thao tác này có thể chia nhỏ thành các mã tài nguyên riêng lẻ (như đượ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ã 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"

Việc phân tích các mã riêng lẻ cho phép bạn lấy tên tài nguyên mới để tham chiếu khách hàng 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).

Lưu ý quan trọng: Tên tài nguyên trong nội dung yêu cầu và nội dung phản hồi JSON được tham chiếu qua trường resourceName, chứ không phải trường name như trong một số API Google Cloud khác. Nhiều thực thể Google Ads có các thuộc tính tên (campaign.Name, adGroup.Name, v.v.), do đó, 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 các đố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. Trên thực tế, đây là những danh sách như danh sách từ khóa 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 những đối tượng như vậy sẽ khác nhau, tùy thuộc vào tài khoản mà bạn đang gửi lệnh gọi API.

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

Giả sử chúng tôi có tài khoản người quản lý 987-654-3210 chia sẻ hành động chuyển đổi trên nhiều tài khoản với một trong những tài khoản khách hàng của khách hàng đó 123-456-7890:

Ví dụ: khi thực hiện lệnh gọi API đến tài khoản người quản lý, hãy 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 dùng chung bằ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 đã chia sẻ sẽ tham chiếu 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 đó tương ứng với tài khoản dùng để truy cập vào hành động chuyển đổi đó.