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

يُطلق على المعرّف الفريد لأحد العناصر في 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.v25.resources) تتيح لك تحليل سلسلة اسم المورد مرة أخرى إلى المعرّفات المكوّنة لها:

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

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