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

يُطلق على المعرّف الفريد لأحد العناصر في Google Ads API اسم مورد، ويتم تمثيله كسلسلة بتنسيق يمكن توقّعه. إذا كنت تعرف المكوّنات الأساسية لاسم مورد، يمكنك استخدام الأداة المساعدة ResourceNames لإنشاء اسم المورد المنسَّق.

فئة ResourceNames

تنشئ الأداة المساعدة ResourceNames اسم المورد الخاص بأحد العناصر عندما تكون على دراية بجميع المعرّفات ذات الصلة بهذا العنصر. مرِّر أرقام التعريف كسلاسل تتضمّن أرقامًا فقط، بدون واصلات.

على سبيل المثال، يكون اسم مرجع الحملة بالتنسيق customers/{customer_id}/campaigns/{campaign_id}. إذا كنت تعرف رقم تعريف العميل ورقم تعريف الحملة، يمكنك استخدام الأداة المساعدة ResourceNames لإنشاء اسم المورد الكامل على النحو التالي:

use Google::Ads::GoogleAds::V25::Utils::ResourceNames;

my $customer_id = "1234567890";
my $campaign_id = "9876543210";

# Generates: "customers/1234567890/campaigns/9876543210"
my $resource_name =
  Google::Ads::GoogleAds::V25::Utils::ResourceNames::campaign(
    $customer_id,
    $campaign_id
  );

توفّر الأداة المساعدة ResourceNames طرقًا مشابهة للمساعدة في أنواع العناصر الأخرى، مثل ad_group() وcustomer() وad_group_criterion(). يُرجى العِلم أنّ ResourceNames يقتصر على كل مساحة اسم لإصدار واجهة برمجة التطبيقات المتوافق (مثل V25، حيث تستخدم إصدارات واجهة برمجة التطبيقات الثانوية، مثل v25.1، وحدة رقم الإصدار الرئيسي V25)، لذا استبدِل V25 بإصدار واجهة برمجة التطبيقات المستهدَف إذا كنت تستخدم إصدارًا أقدم. راجِع ResourceNames.pm ملف المصدر للاطّلاع على القائمة الكاملة بطُرق المساعدة المتوافقة.