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

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

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

Протокол REST API

Объекты классов, такие как сервис, ресурс, перечисление и ошибка, в клиентской библиотеке 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

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

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

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

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

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

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

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

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

Утилиты

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

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

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