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

يُسمى المعرّف الفريد لأحد الكيانات في 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 مرافقة تُفكِّل "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
)