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

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

เมธอดของเส้นทางบริการ

บริการทั้งหมดที่ออกแบบมาเพื่อจัดการการอ่านหรือเปลี่ยนแปลงประเภท ใน 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
)