أسماء الموارد

يُعرف المعرّف الفريد لكيان في Google Ads 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
)