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

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

ProtoLookupUtil

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

في ما يلي الطريقة المعتادة لإنشاء حملة:

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

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

campaign = client.resource.campaign

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

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

    campaign.status = :PAUSED

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