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 build 文件，其中包含此项目的依赖项和测试类型。
    • lib：库的源代码。
    • t：库代码的测试用例。
    • examples：许多示例，演示了如何使用该库通过 Google Ads API 执行常见的使用情形。
    • googleads.properties：库的示例配置文件。
    • log4perl.conf：示例日志记录配置文件。

  3. 安装所需的依赖项。Build.PL 文件列出了该库所需的所有依赖项。您可以运行以下命令来安装它们：

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

进行首次 API 调用

如需使用 Google Ads API，您需要执行多个步骤才能获得该 API 的访问权限并配置 Google Ads 账号。我们建议您按照快速入门指南操作，该指南会引导您完成所有重要步骤，包括设置 Google Ads 账号。

基本用法

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

身份验证和授权

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

配置和日志记录

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

实用程序

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

微调应用性能

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