ชื่อทรัพยากร

ตัวระบุที่ไม่ซ้ำกันของเอนทิตีใน Google Ads API เรียกว่าชื่อทรัพยากร และแสดงเป็นสตริงที่มีรูปแบบที่คาดการณ์ได้ หากทราบคอมโพเนนต์ที่เป็นส่วนประกอบของชื่อทรัพยากร คุณจะสร้างชื่อทรัพยากรได้โดยใช้วิธีการช่วยเหลือที่มีอยู่ในออบเจ็กต์บริการจำนวนมาก

วิธีการเส้นทางบริการ

บริการทั้งหมดที่ออกแบบมาเพื่อจัดการการอ่านหรือการเปลี่ยนแปลงออบเจ็กต์บางประเภทใน API จะมีวิธีการช่วยเหลือในการสร้างชื่อทรัพยากร ตัวอย่างเช่น คุณสามารถสร้างชื่อทรัพยากรสำหรับออบเจ็กต์ 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)

นอกจากนี้ แต่ละบริการยังมีเมธอด parse_*_path ที่มาพร้อมกัน ซึ่งจะแยกชื่อทรัพยากรออกเป็นพจนานุกรมของเซกเมนต์แต่ละรายการ (หรือแสดงพจนานุกรมว่างเปล่าหากสตริงไม่ตรงกับรูปแบบที่คาดไว้)

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"]

ชื่อทรัพยากรแบบผสม

วิธีการช่วยเหลือเส้นทางในบริการจะสร้างเซกเมนต์แบบผสมของชื่อทรัพยากร ระบบจะยอมรับเซกเมนต์ต่างๆ ของรหัสแบบผสมเป็นพารามิเตอร์แต่ละรายการในเมธอด

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
)