שמות המשאבים

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