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

يُطلق على المعرّف الفريد لأحد العناصر في 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
)