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