Клиентская библиотека Perl

Клиентская библиотека Perl размещена на GitHub, а пакет доступен на CPAN.

Библиотека поддерживает Perl версии 5.28.1 и выше.

Протокол REST API

Примечание. Google Ads API предоставляет как стандартные конечные точки JSON REST, так и высокопроизводительный интерфейс gRPC. Поскольку Perl не является поддерживаемым языком в стеке gRPC, эта клиентская библиотека реализована на основе протокола JSON REST через HTTP 1.1.

Объекты классов, такие как сервис, ресурс, перечисление и ошибка, в клиентской библиотеке Perl создаются путем анализа определений буфера протокола. Подробнее о том, как сериализуются структурированные данные, рассказывается в документации по буферам протокола.

Чтобы подключиться к Google Ads API, клиентская библиотека создает HTTP-запрос в формате JSON, отправляет его конечной точке REST по протоколу HTTP 1.1, десериализует ответ как объект JSON и интерпретирует результаты.

Установка библиотеки

Клиентская библиотека Perl размещена на GitHub и распространяется с помощью CPAN.

1. Клонируйте библиотеку из GitHub:

   git clone https://github.com/googleads/google-ads-perl.git
   

2. Перейдите в каталог google-ads-perl:

   cd google-ads-perl
   

   Вы увидите несколько файлов и подкаталогов:

   • Build.PL – файл сборки Perl, в котором содержатся зависимости и типы тестов этого проекта.
   • lib – исходный код библиотеки.
   • t – отчеты о тестировании кода библиотеки.
   • examples – множество примеров, демонстрирующих, как использовать библиотеку для выполнения распространенных задач с помощью Google Ads API.
   • googleads.properties – пример файла конфигурации для библиотеки.
   • log4perl.conf – пример файла конфигурации ведения журнала.

3. Установите необходимые зависимости и создайте библиотеку. В файле Build.PL перечислены все зависимости, необходимые для библиотеки. Вы можете установить их, выполнив следующие команды:

   cpan install Module::Build
   perl Build.PL
   ./Build installdeps
   ./Build
   ./Build install
   

Примечание. Каждый выпуск Google::Ads::GoogleAds::Client содержит модули определенной версии Google Ads API в lib/Google/Ads/GoogleAds/ (где минорные выпуски API, такие как v25.1, включены в модуль основной версии V25). Сведения о совместимости версий приведены в таблице Поддерживаемые версии API.

Выполнение первого вызова API

Чтобы использовать Google Ads API, необходимо выполнить несколько шагов для получения доступа к API и настроить аккаунты Google Рекламы. Следуйте краткому руководству, в котором описаны все важные шаги, в том числе настройка аккаунтов Google Рекламы.

Как пользоваться отчетом

Подробные сведения о том, как использовать клиентскую библиотеку Perl, приведены в руководстве по базовому использованию.

Аутентификация и авторизация

Клиентская библиотека Perl поддерживает несколько подходов к аутентификации и авторизации. Подробнее об аутентификации и авторизации…

Настройка и ведение журналов

Клиентская библиотека Perl использует googleads.properties для конфигурации и log4perl.conf для ведения журнала. Вы можете изменить эти файлы, чтобы настроить поведение библиотеки. Подробную информацию вы найдете в руководствах по настройке и ведению журналов.

Утилиты

Клиентская библиотека Perl включает вспомогательные классы, которые упрощают работу с API. Чтобы узнать больше, изучите следующие руководства:

• Маски полей
• Названия ресурсов

Тонкая настройка производительности приложения

Рекомендации по настройке производительности приложения приведены в руководстве по производительности.