واکشی ارجاع‌ها به کلاس‌های پروتو هنگام استفاده از API مستلزم این است که یا درک ذاتی از API داشته باشید یا اغلب اسناد مرجع پروتو را برای مسیر فضای نام دقیق جستجو کنید.
ProtoLookupUtil
روش‌های ابزار جستجو در GoogleAdsClient (پشتیبانی‌شده توسط
Factories و ServiceLookup، جایگزین کلاس قدیمی
ProtoLookupUtil) به شما امکان می‌دهد بدون نیاز به پیگیری شماره‌های نسخه API و فضاهای نام ماژول، نمونه‌های سرویس‌ها، عملیات، شمارش‌ها و منابع را جستجو و ایجاد کنید. به‌طور پیش‌فرض، این روش‌ها از بالاترین نسخه
میانای برنامه‌سازی کاربردی پشتیبانی‌شده توسط gem نصب‌شده شما (V26 در
جدیدترین نسخه، جایی که نسخه‌های جزئی میانای برنامه‌سازی کاربردی مثل v25.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 }