Giá trị nhận dạng duy nhất của một thực thể trong API Google Ads được gọi là 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 được. Nếu bạn 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ách sử dụ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ả Dịch vụ được thiết kế để xử lý việc đọc hoặc thay đổi các loại nội dung cụ thể
các đối tượng trong API có các phương thức trợ giúp để giúp bạn dễ dàng tạo
resource_names. Ví dụ về cách tạo tên tài nguyên cho đố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)
Bắt đầu từ phiên bản 10.0.0 của thư viện ứng dụng, mỗi dịch vụ cũng có một
phương thức parse_*_path đi kèm giúp giải cấu trúc resource_name thành
phân đoạn riêng lẻ, ví dụ:
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 tổng hợp
Bắt đầu từ phiên bản 9.0.0 của thư viện ứng dụng, trình trợ giúp đường dẫn trên các dịch vụ tạo 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 tổng hợp được chấp nhận dưới dạng tham số riêng lẻ trong phương thức:
from google.ads.google_ads.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 the above 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
)
Các phiên bản trước 9.0.0
Trước phiên bản 9.0.0, trình trợ giúp đường dẫn trên các dịch vụ không xây dựng phân đoạn kết hợp của tên tài nguyên. Các phân đoạn đó cần được cung cấp bởi người gọi. Thư viện ứng dụng có một tiện ích nhỏ giúp bạn thực hiện việc này:
from google.ads.google_ads.client import GoogleAdsClient
from google.ads.google_ads.util import ResourceName
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 the above IDs looks like this:
# "customers/0987654321/adGroupCriteria/1234567890~74932"
composite_id = ResourceName.format_composite(ad_group_id, criterion_id)
resource_name = ad_group_criterion_service.ad_group_criterion_path(
customer_id, composite_id
)