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

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