واکشی کردن ارجاع‌ها به کلاس‌های پروتو هنگام استفاده از API مستلزم این است که یا درک ذاتی از API داشته باشید یا اغلب اسناد مرجع پروتو را برای مسیر فضای نام دقیق جستجو کنید.
ProtoLookupUtil
روش‌های ابزار جستجو در GoogleAdsClient (با پشتیبانی
کارخانه‌ها و ServiceLookup، جایگزین کلاس
ProtoLookupUtil قدیمی) به شما امکان می‌دهد بدون نیاز به پیگیری شماره‌های نسخه API و فضاهای نام واحد، نمونه‌های سرویس‌ها،
عملیات، شمارش‌ها، و منابع را جستجو و ایجاد کنید. به‌طور پیش‌فرض، این روش‌ها از بالاترین نسخه
میانای برنامه‌سازی کاربردی پشتیبانی‌شده توسط gem نصب‌شده شما (V25 در
جدیدترین نسخه، جایی که نسخه‌های جزئی میانای برنامه‌سازی کاربردی مثل v25.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
جستجوی فهرست
برای فیلدهای شمارشی در پیام‌های protobuf، به‌جای جستجوی واحد شمارشی، مستقیماً نماد Ruby را اختصاص دهید:
campaign.status = :PAUSED
برای بازرسی یا تکرار کردن همه نمادهای معتبر برای شمارش در زمان اجرا، از
client.enum استفاده کنید که Google::Protobuf::EnumDescriptor را برای آن
شمارش برمی‌گرداند:
status_enum = client.enum.campaign_status
status_enum.each { |status| p status }