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

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

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

Протокол REST API

Сущности классов, такие как service, resource, enum и error, в клиентской библиотеке Perl генерируются путём анализа определений буфера протокола . Подробнее о сериализации структурированных данных см. в документации по буферу протокола .

Для подключения к 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. Подробнее см. в следующих руководствах:

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

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