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 mã nhận dạng thành phần của một thực thể, bạn có thể sử dụng các tiện ích của thư viện ứng dụng Java để tạo hoặc phân tích cú pháp tên tài nguyên đầy đủ.
Tạo tên tài nguyên bằng ResourceNames
Lớp 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ể đó. Ví dụ: tên tài nguyên chiến dịch có định dạng sau:
customers/{customer_id}/campaigns/{campaign_id}
Nếu bạn biết mã khách hàng (không có dấu gạch ngang) và mã chiến dịch, hãy sử dụng lớp ResourceNames để tạo tên tài nguyên đầy đủ như sau:
long customerId = 1234567890L;
long campaignId = 9876543210L;
String campaignResourceName = ResourceNames.campaign(customerId, campaignId);
Bạn cũng có thể tạo tên tài nguyên cho các loại thực thể khác, chấp nhận các tham số mã nhận dạng khác nhau tuỳ thuộc vào dạng cuối cùng của tên tài nguyên.
Phân tích tên tài nguyên
Mặc dù ResourceNames (com.google.ads.googleads.lib.utils.ResourceNames) không phụ thuộc vào phiên bản trên tất cả các phiên bản API được hỗ trợ, nhưng thư viện ứng dụng Java cũng cung cấp các lớp tên tài nguyên được nhập mạnh (chẳng hạn như CampaignName, AdGroupName và CustomerName) trong mỗi gói tài nguyên theo phiên bản (ví dụ: com.google.ads.googleads.v25.resources) cho phép bạn phân tích cú pháp chuỗi tên tài nguyên trở lại các mã nhận dạng thành phần của chuỗi đó:
import com.google.ads.googleads.v25.resources.CampaignName;
CampaignName campaignName = CampaignName.parse(campaignResourceName);
String parsedCustomerId = campaignName.getCustomerId();
String parsedCampaignId = campaignName.getCampaignId();