شناسه منحصر به فرد یک موجودیت در 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
)