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