Tên tài nguyên

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 có thể dự đoán. 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ể sử 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 liên quan đến thực thể đó. Truyền mã nhận dạng dưới dạng chuỗi chỉ chứa chữ số, không có dấu gạch nối.

Ví dụ: tên tài nguyên chiến dịch có định 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ể sử dụng tiện ích ResourceNames để tạo tên tài nguyên đầy đủ như sau:

use Google::Ads::GoogleAds::V26::Utils::ResourceNames;

my $customer_id = "1234567890";
my $campaign_id = "9876543210";

# Generates: "customers/1234567890/campaigns/9876543210"
my $resource_name =
  Google::Ads::GoogleAds::V26::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 thuộc phạm vi của từng không gian tên phiên bản API được hỗ trợ (chẳng hạn như V26, trong đó các bản phát hành API nhỏ như v25.1 sử dụng mô-đun phiên bản lớn V25), vì vậy, hãy thay thế V26 bằng phiên bản API mục tiêu của bạn nếu sử dụng phiên bản cũ hơn. Xem ResourceNames.pm tệp nguồn để biết danh sách đầy đủ các phương thức trợ giúp được hỗ trợ.