Giá trị nhận dạng riêng biệt cho một thực thể trong Google Ads API được gọi là tên tài nguyên và được biểu thị dưới dạng một chuỗi có định dạng dự đoán được. Nếu biết các thành phần cấu thành của tên tài nguyên, bạn có thể dùng tiện ích ResourceNames để tạo tên tài nguyên được định dạng.
Lớp ResourceNames
Tiện ích ResourceNames tạo tên tài nguyên của một thực thể khi bạn biết tất cả mã nhận dạng có liên quan đến thực thể đó. Truyền mã nhận dạng dưới dạng chuỗi chỉ chứa các chữ số, không có dấu gạch ngang.
Ví dụ: tên tài nguyên chiến dịch có dạng customers/{customer_id}/campaigns/{campaign_id}. Nếu biết mã khách hàng và mã chiến dịch, bạn có thể dùng tiện ích ResourceNames để tạo tên tài nguyên đầy đủ như sau:
use Google::Ads::GoogleAds::V25::Utils::ResourceNames;
my $customer_id = "1234567890";
my $campaign_id = "9876543210";
# Generates: "customers/1234567890/campaigns/9876543210"
my $resource_name =
Google::Ads::GoogleAds::V25::Utils::ResourceNames::campaign(
$customer_id,
$campaign_id
);
Tiện ích ResourceNames cung cấp các phương thức trợ giúp tương tự cho các loại thực thể khác, chẳng hạn như ad_group(), customer() và ad_group_criterion(). Xin lưu ý rằng ResourceNames được giới hạn trong từng không gian tên phiên bản API được hỗ trợ (chẳng hạn như V25, trong đó các bản phát hành API phụ như v25.1 sử dụng mô-đun phiên bản chính V25), vì vậy, hãy thay thế V25 bằng phiên bản API mục tiêu nếu bạn đang dùng phiên bản cũ hơn. Hãy xem tệp nguồn ResourceNames.pm để biết danh sách đầy đủ các phương thức trợ giúp được hỗ trợ.