يتطلب استرجاع المراجع لفئات Proto عند استخدام واجهة برمجة التطبيقات إما أن يكون لديك فهم جوهري لواجهة برمجة التطبيقات أو تحتاج إلى البحث بشكل متكرر عن الوثائق المرجعية للنموذج الأوّلي للمسار المحدد.
ProtoLookupUtil
تتيح لك أداة البحث الأولي البحث عن مثيلات للخدمات والعمليات والتعدادات والموارد وإنشائها بدون الحاجة إلى تتبع أرقام إصدار واجهة برمجة التطبيقات ومساحات الاسم.
في ما يلي كيفية إنشاء مثيل لإحدى الحملات عادةً:
campaign = Google::Ads::GoogleAds::V16::Resources::Campaign.new
ولكن باستخدام Proto lookup lookup، يمكنك استخدام نموذج أبسط:
campaign = client.resource.campaign
عند جلب مورد أو خدمة أو عملية، يتم عرض مثيل لذلك الكيان. عند استرجاع التعداد، يتم إرجاع مرجع إلى الفئة، بدون إنشاء مثيل.
بالنسبة إلى التعدادات، يمكنك استخدام اختصار لتجاوز الحاجة إلى البحث عن النماذج الأوّلية للتعداد.
campaign.status = :PAUSED
ننصحك باستخدام طريقة client.service
لجلب الخدمات حتى إذا لم تكن تستخدم هذه الأداة لأي حالات استخدام أخرى. هناك منطق إضافي مضمّن في
هذه الطريقة لنقل الرمز المميز للمطوِّر وتفاصيل المصادقة،
والتي سيتعين عليك التعامل معها يدويًا إذا استخدمت طريقة أخرى.