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ể tạo tên tài nguyên bằng các phương thức trợ giúp có trên nhiều đối tượng dịch vụ.
Phương thức đường dẫn dịch vụ
Tất cả các dịch vụ được thiết kế để xử lý việc đọc hoặc thay đổi các loại đối tượng cụ thể trong API đều có các phương thức trợ giúp để tạo tên tài nguyên. Ví dụ: bạn có thể tạo tên tài nguyên cho một đối tượng Campaign:
from google.ads.googleads.client import GoogleAdsClient
client = GoogleAdsClient.load_from_storage()
customer_id = "7892134783"
campaign_id = "1234567890"
campaign_service = client.get_service("CampaignService")
resource_name = campaign_service.campaign_path(customer_id, campaign_id)
Mỗi dịch vụ cũng có một phương thức parse_*_path đi kèm, phương thức này sẽ phân tích tên tài nguyên thành một từ điển gồm các phân đoạn riêng lẻ (hoặc trả về một từ điển trống nếu chuỗi không khớp với định dạng dự kiến):
from google.ads.googleads.client import GoogleAdsClient
client = GoogleAdsClient.load_from_storage()
resource_name = "customers/7892134783/campaigns/1234567890"
campaign_service = client.get_service("CampaignService")
segments = campaign_service.parse_campaign_path(resource_name)
customer_id = segments["customer_id"]
campaign_id = segments["campaign_id"]
Tên tài nguyên kết hợp
Trình trợ giúp đường dẫn trên các dịch vụ tạo các phân đoạn kết hợp của tên tài nguyên. Các phân đoạn khác nhau của mã nhận dạng kết hợp được chấp nhận dưới dạng các tham số riêng lẻ trong phương thức:
from google.ads.googleads.client import GoogleAdsClient
customer_id = "0987654321"
ad_group_id = "1234567890"
criterion_id = "74932"
client = GoogleAdsClient.load_from_storage()
ad_group_criterion_service = client.get_service("AdGroupCriterionService")
# An AdGroupCriterion resource name that uses these IDs looks like this:
# "customers/0987654321/adGroupCriteria/1234567890~74932"
resource_name = ad_group_criterion_service.ad_group_criterion_path(
customer_id, ad_group_id, criterion_id
)