أداة البحث

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

ProtoLookupUtil

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

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

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

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

campaign = client.resource.campaign

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

# Instantiate an operation
operation = client.operation.campaign

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

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

campaign_service = client.service.campaign

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

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

campaign.status = :PAUSED

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

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