המזהה הייחודי של ישות ב-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"]
שמות של משאבים מורכבים
כלי עזר לנתיבים בשירותים יוצרים קטעים מורכבים של שם משאב. החלקים השונים של המזהה המורכב מתקבלים כפרמטרים נפרדים ב-method:
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
)