واکشی ارجاع به کلاس‌های پروتو هنگام استفاده از API مستلزم آن است که یا درک ذاتی از API داشته باشید یا نیاز به جستجوی مکرر اسناد مرجع پروتو برای مسیر دقیق داشته باشید.
ProtoLookupUtil
ابزار جستجوی پروتو به شما امکان می‌دهد بدون نیاز به پیگیری شماره‌های نسخه API و فضاهای نام، نمونه‌هایی از خدمات، عملیات، شمارش‌ها و منابع را جستجو کرده و ایجاد کنید.
در اینجا نحوه نمونه سازی یک کمپین به این صورت است:
campaign = Google::Ads::GoogleAds::V17::Resources::Campaign.new
اما با ابزار جستجوی پروتو، می‌توانید از یک فرم ساده‌تر استفاده کنید:
campaign = client.resource.campaign
هنگام واکشی یک منبع، سرویس یا عملیات، نمونه ای از آن موجودیت برگردانده می شود. هنگام واکشی یک شمارش، ارجاع به کلاس، بدون نمونه سازی، برگردانده می شود.
برای شمارش‌ها، می‌توانید از یک میانبر برای دور زدن نیاز به جستجوی پروتوهای شمارش استفاده کنید.
campaign.status = :PAUSED
توصیه می کنیم از روش client.service برای واکشی خدمات استفاده کنید، حتی اگر از این ابزار برای موارد استفاده دیگری استفاده نمی کنید. منطق اضافی در این روش برای ارسال توکن توسعه دهنده و جزئیات احراز هویت وجود دارد که اگر از روش دیگری استفاده می کردید، باید به صورت دستی آن را مدیریت کنید.