Утилита поиска

Для получения ссылок на прототипы классов при использовании API необходимо либо иметь внутреннее понимание API, либо вам нужно часто искать точный путь в справочной документации по прототипам.

ProtoLookupUtil

Утилита поиска прототипов позволяет искать и создавать экземпляры сервисов, операций, перечислений и ресурсов без необходимости отслеживать номера версий API и пространства имен.

Вот как вы обычно создаете кампанию:

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

Но с помощью утилиты поиска прототипов вы можете использовать более простую форму:

campaign = client.resource.campaign

При получении ресурса, службы или операции возвращается экземпляр этого объекта. При получении перечисления возвращается ссылка на класс без создания экземпляра.

Для перечислений вы можете использовать ярлык, чтобы обойти необходимость поиска прототипов перечисления.

campaign.status = :PAUSED

Мы рекомендуем использовать метод client.service для получения служб, даже если вы не используете эту утилиту для других случаев использования. В этот метод встроена дополнительная логика для передачи вашего токена разработчика и данных аутентификации, которые вам придется обрабатывать вручную, если вы используете другой метод.