שמות המשאבים

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

החל מגרסה 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
)