نام منابع

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