استخدام البحث

يتطلّب جلب مراجع لفئات proto عند استخدام واجهة برمجة التطبيقات أن يكون لديك فهم جوهري لواجهة برمجة التطبيقات أو أن تحتاج إلى البحث بشكل متكرّر في مستندات مرجع proto عن المسار الدقيق.

ProtoLookupUtil

تتيح أداة البحث عن نماذج أولية البحث عن مثيلات للخدمات والعمليات والتعدادات والموارد وإنشائها بدون الحاجة إلى تتبُّع أرقام إصدارات واجهات برمجة التطبيقات ومساحات الأسماء.

في ما يلي كيفية إنشاء مثيل لحملة عادةً:

campaign = Google::Ads::GoogleAds::V20::Resources::Campaign.new

ولكن باستخدام أداة البحث عن تعريفات البروتوكول، يمكنك استخدام نموذج أبسط:

campaign = client.resource.campaign

عند جلب مورد أو خدمة أو عملية، يتم عرض مثيل لهذا العنصر. عند جلب تعداد، يتم عرض مرجع إلى الفئة، بدون إنشاء مثيل.

بالنسبة إلى التعدادات، يمكنك استخدام اختصار لتجنُّب الحاجة إلى البحث عن بروتوكولات التعداد.

campaign.status = :PAUSED

ننصحك باستخدام طريقة client.service لجلب الخدمات حتى إذا لم تستخدم هذه الأداة المساعدة في أي حالات استخدام أخرى. تتضمّن هذه الطريقة منطقًا إضافيًا لنقل رمز المطوِّر وتفاصيل المصادقة، وهو ما عليك التعامل معه يدويًا إذا استخدمت طريقة أخرى.