המזהה הייחודי של ישות ב-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
)