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