Tên tài nguyên
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Giá trị nhận dạng duy nhất cho một thực thể trong API Google Ads đượ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ụ.
Các 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 resource_names. 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 giúp phân tích một resource_name thành các 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
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 làm các 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
)
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-27 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-27 UTC."],[[["\u003cp\u003eIn the Google Ads API, entities are uniquely identified by a predictable string format called a resource name.\u003c/p\u003e\n"],["\u003cp\u003eHelper methods on Service objects can be used to generate these resource names if you know the required components.\u003c/p\u003e\n"],["\u003cp\u003eServices offer path methods like \u003ccode\u003ecampaign_path\u003c/code\u003e to build resource names and \u003ccode\u003eparse_campaign_path\u003c/code\u003e to break them down into individual segments.\u003c/p\u003e\n"],["\u003cp\u003eComposite resource names, such as those for AdGroupCriterion, are constructed by path helpers using multiple ID segments as parameters.\u003c/p\u003e\n"]]],[],null,["# Resource Names\n\nThe unique identifier for an entity in the Google Ads API is called a resource\nname, and is represented as a string with a predictable format. If you know\nthe constituent components of a resource name, you can generate resource names\nusing helper methods present on many Service objects.\n\nService path methods\n--------------------\n\nAll Services that are designed to handle reading or mutating specific types of\nobjects in the API have helper methods to construct resource_names. For example,\nyou can create a resource name for a `Campaign` object: \n\n from google.ads.googleads.client import GoogleAdsClient\n\n client = GoogleAdsClient.load_from_storage()\n customer_id = \"7892134783\"\n campaign_id = \"1234567890\"\n campaign_service = client.get_service(\"CampaignService\")\n resource_name = campaign_service.campaign_path(customer_id, campaign_id)\n\nEach service also has an accompanying `parse_*_path` method that deconstructs a\nresource_name into its individual segments, for example: \n\n from google.ads.googleads.client import GoogleAdsClient\n\n client = GoogleAdsClient.load_from_storage()\n resource_name = \"customers/7892134783/campaigns/1234567890\"\n campaign_service = client.get_service('CampaignService')\n segments = campaign_service.parse_campaign_path(resource_name)\n customer_id = segments[\"customer_id\"]\n campaign_id = segments[\"campaign_id\"]\n\nComposite resource names\n------------------------\n\nPath helpers on services construct composite segments of a resource name. The\ndifferent segments of the composite ID are accepted as individual parameters in\nthe method: \n\n from google.ads.google_ads.client import GoogleAdsClient\n\n customer_id = \"0987654321\"\n ad_group_id = \"1234567890\"\n criterion_id = \"74932\"\n\n client = GoogleAdsClient.load_from_storage()\n ad_group_criterion_service = client.get_service(\"AdGroupCriterionService\")\n\n # An AdGroupCriterion resource name that uses the above IDs looks like this:\n # \"customers/0987654321/adGroupCriteria/1234567890~74932\"\n resource_name = ad_group_criterion_service.ad_group_criterion_path(\n customer_id, ad_group_id, criterion_id\n )"]]
