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

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

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

Протокол REST API

В клиентской библиотеке Perl сущности классов, такие как service, resource, enum и error, генерируются путем анализа определений протокола Protocol Buffer . Для получения дополнительной информации о сериализации структурированных данных обратитесь к документации по протоколу Protocol Buffer .

Для подключения к API Google Ads клиентская библиотека создает 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 : множество примеров, демонстрирующих, как использовать библиотеку для выполнения распространенных сценариев использования API Google Ads.
    • googleads.properties : пример конфигурационного файла для библиотеки.
    • log4perl.conf : пример файла конфигурации логирования.

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

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

Выполните свой первый вызов API.

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

Основное использование

Для получения более подробной информации об использовании клиентской библиотеки Perl обратитесь к базовому руководству по использованию .

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

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

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

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

Коммунальные услуги

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

Оптимизируйте производительность вашего приложения.

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