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

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

إنشاء أسماء الموارد باستخدام ResourceNames

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

customers/{customer_id}/campaigns/{campaign_id}

إذا كنت تعرف رقم تعريف العميل (بدون واصلات) ورقم تعريف الحملة، استخدِم فئة ResourceNames لإنشاء اسم المورد الكامل على النحو التالي:

long customerId = 1234567890L;
long campaignId = 9876543210L;

String campaignResourceName = ResourceNames.campaign(customerId, campaignId);

يمكنك إنشاء أسماء موارد لأنواع الكيانات الأخرى أيضًا، والتي تقبل معلَمات معرّفات مختلفة حسب الشكل النهائي لاسم المورد.

تحليل أسماء الموارد

على الرغم من أنّ ResourceNames (com.google.ads.googleads.lib.utils.ResourceNames) لا يعتمد على الإصدار في جميع إصدارات واجهة برمجة التطبيقات المتوافقة، توفّر مكتبة برامج Java أيضًا فئات أسماء موارد ذات أنواع قوية (مثل CampaignName وAdGroupName وCustomerName) في كل حزمة موارد ذات إصدار (على سبيل المثال، com.google.ads.googleads.v26.resources) تتيح لك تحليل سلسلة اسم المورد مرة أخرى إلى أرقام التعريف المكوّنة لها:

import com.google.ads.googleads.v26.resources.CampaignName;

CampaignName campaignName = CampaignName.parse(campaignResourceName);
String parsedCustomerId = campaignName.getCustomerId();
String parsedCampaignId = campaignName.getCampaignId();