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

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

بدءًا من الإصدار 10.0.0 من مكتبة العميل، تتضمّن كل خدمة أيضًا parse_*_path method مصاحبة تُحلِّل 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
)