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

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

فئة ResourceNames

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

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

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

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

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

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