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

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

وبدءًا من الإصدار 10.0.0 من مكتبة البرامج، سيكون لكل خدمة أيضًا مرفق مع طريقة parse_*_path التي تفكك موارد_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
)