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