שמות המשאבים

המזהה הייחודי של ישות ב-Google Ads API נקרא שם משאב, והוא מיוצג כמחרוזת בפורמט צפוי. אם אתם יודעים מהם המרכיבים של שם משאב, תוכלו ליצור שמות משאבים באמצעות methods של עזרות שקיימות באובייקטים רבים של Service.

שיטות נתיב השירות

לכל השירותים שנועדו לטפל בקריאה או בשינוי של סוגים ספציפיים של אובייקטים ב-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)

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

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
)