ตัวระบุที่ไม่ซ้ำกันของเอนทิตีใน Google Ads API เรียกว่าชื่อทรัพยากร และแสดงเป็นสตริงที่มีรูปแบบที่คาดการณ์ได้ หากคุณทราบองค์ประกอบส่วนประกอบของชื่อทรัพยากร คุณจะสร้างชื่อทรัพยากรได้โดยใช้เมธอดตัวช่วยที่มีอยู่ในออบเจ็กต์บริการหลายรายการ
เมธอดเส้นทางบริการ
บริการทั้งหมดที่ออกแบบมาเพื่อจัดการการอ่านหรือการกลายพันธุ์ของออบเจ็กต์บางประเภทใน API จะมีเมธอดที่ช่วยทำให้สร้างresource_namesได้โดยง่าย เช่น การสร้างชื่อทรัพยากรสำหรับออบเจ็กต์ 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)
ตั้งแต่ไลบรารีของไคลเอ็นต์ตั้งแต่เวอร์ชัน 10.0.0 เป็นต้นไป แต่ละบริการจะมีเมธอด parse_*_path ที่เกี่ยวข้อง ซึ่งจะแยก resource_name เป็นกลุ่มแต่ละรายการ เช่น
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"]
ชื่อทรัพยากรแบบผสม
ตั้งแต่ไลบรารีของไคลเอ็นต์เวอร์ชัน 9.0.0 เป็นต้นไป ตัวช่วยเส้นทางในบริการจะสร้างกลุ่มแบบผสมของชื่อทรัพยากร ระบบจะยอมรับกลุ่มต่างๆ ของรหัสคอมโพสิตเป็นพารามิเตอร์แต่ละรายการในเมธอด ดังนี้
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
)
เวอร์ชันก่อนหน้า 9.0.0
ก่อนเวอร์ชัน 9.0.0 ตัวช่วยเส้นทางในบริการจะไม่สร้างกลุ่มประกอบของชื่อทรัพยากร กลุ่มเหล่านี้ต้องระบุโดย ผู้โทร ไลบรารีของไคลเอ็นต์มีเครื่องมือเล็กๆ น้อยๆ เพื่อช่วยในเรื่องนี้
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
)