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

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

ProtoLookupUtil

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

Вот как обычно запускается кампания:

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

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

campaign = client.resource.campaign

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

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

    campaign.status = :PAUSED

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