أداة البحث

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

ProtoLookupUtil

تتيح لك طرق أداة البحث المساعدة في GoogleAdsClient (المدعومة من خلال Factories وServiceLookup، ما يحلّ محل الفئة القديمة ProtoLookupUtil) البحث عن مثيلات للخدمات والعمليات والتعدادات والموارد وإنشائها بدون الحاجة إلى تتبُّع أرقام إصدارات واجهة برمجة التطبيقات ومساحات أسماء الوحدات. تستخدم هذه الطرق تلقائيًا أعلى إصدار من واجهة برمجة التطبيقات يتوافق مع حزمة Gem المثبَّتة (V25 في أحدث إصدار، حيث تستخدم إصدارات واجهة برمجة التطبيقات الثانوية، مثل الإصدار 25.1، وحدة الإصدار الرئيسية V25)، أو يمكنك تحديد بادئة إصدار صريحة (مثل v25) في طلب البحث.

بدون أداة البحث، يمكنك إنشاء مثيل لمورد حملة مباشرةً من مساحة الاسم ذات الإصدار:

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

باستخدام طرق البحث عن العميل، يمكنك إنشاء مثيل للمورد مباشرةً من العميل:

campaign = client.resource.campaign

عند جلب مورد أو خدمة أو عملية، يتم عرض نسخة من هذا العنصر:

# Instantiate an operation
operation = client.operation.campaign

البحث عن الخدمات

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

campaign_service = client.service.campaign

البحث عن التعداد

بالنسبة إلى حقول التعداد في رسائل البروتوكول المخزَّن مؤقتًا، يمكنك تعيين رمز Ruby مباشرةً بدلاً من البحث عن وحدة التعداد:

campaign.status = :PAUSED

لفحص جميع الرموز الصالحة لتعداد أو تكرارها في وقت التشغيل، استخدِم client.enum، الذي يعرض Google::Protobuf::EnumDescriptor لهذا التعداد:

status_enum = client.enum.campaign_status
status_enum.each { |status| p status }