Perl 客户端库

Perl 客户端库托管在 GitHub 上，软件包可在 CPAN 上获取。

该库支持 Perl 5.28.1 或更高版本。

REST API 协议

中实现的。

Perl 客户端库中的类实体（例如服务、资源、枚举和错误）是通过解析 协议缓冲区 定义生成的。如需详细了解如何序列化结构化数据， 请参阅 协议缓冲区文档。

为了与 Google Ads API 建立连接，客户端库会以 JSON格式创建 HTTP 请求，通过 HTTP 1.1 将其发送到 REST 端点，将 响应反序列化为 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 Ads 账号。请按照快速入门 指南操作，该指南将引导您完成所有重要步骤，包括 设置 Google Ads 账号。

基本用法

如需详细了解如何使用 Perl 客户端库，请参阅基本用法指南。

身份验证和授权

Perl 客户端库支持多种身份验证和授权方法。如需了解详情，请参阅身份验证和授权 指南。

配置和日志记录

Perl 客户端库使用 googleads.properties 进行配置，使用 log4perl.conf 进行日志记录。您可以修改这些文件以自定义库的行为。如需了解详情，请参阅配置和 日志记录指南。

实用程序

Perl 客户端库包含实用程序类，可提高 API 的易用性。如需了解详情，请参阅以下指南：

微调应用性能

如需获得有关如何 微调应用性能的建议，请参阅性能指南。