شناسه یکتا برای یک نهاد در Google Ads 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)
هر سرویس همچنین دارای یک روش parse_*_path همراه است که نام منبع را به یک فرهنگ لغت از بخشهای جداگانه آن تجزیه میکند (یا اگر رشته با قالب مورد انتظار مطابقت نداشته باشد، یک فرهنگ لغت خالی برمیگرداند):
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.googleads.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 these 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
)