Google Ads API PHP客户端库安装与使用指南

Google Ads API PHP客户端库安装与使用指南

google-ads-php Google Ads API Client Library for PHP 项目地址: https://gitcode.com/gh_mirrors/go/google-ads-php

1. 项目目录结构及介绍

Google Ads API的PHP客户端库遵循清晰的组织结构来确保开发者易于理解和使用。以下是其主要目录及其简介：

• composer.json: 包含了项目依赖和其他元数据，是通过Composer管理依赖的关键文件。
• src: 存放核心源代码，包括对Google Ads API服务的封装和交互逻辑。
• tests: 包含单元测试和集成测试案例，保证库的稳定性和功能完整性。
• examples: 示例代码的集合，展示了如何使用此库执行常见的Google Ads API操作。
• metadata: 内部使用的元数据文件，由库自动处理，开发者通常不需要直接修改。
• google_ads_php.ini: 示例配置文件，用于存放OAuth2认证信息等，在实际应用中可能需要自定义的配置文件。
• LICENSE: 许可证文件，说明了该库的使用权限遵循Apache-2.0许可。

2. 项目的启动文件介绍

虽然这个库本身没有一个特定的“启动”文件，但开发过程中，典型的起点是通过运行示例或在你的项目中引入这个库。对于快速入门，重点在于例子部分：

1. 首先，从GitHub克隆库到本地，并进入项目目录：

   git clone https://github.com/googleads/google-ads-php.git
   cd google-ads-php
   

2. 安装必要的依赖：

   composer install
   

随后，你可以从examples目录开始，比如通过命令行执行任何一个示例脚本来开始与Google Ads API交互。

3. 项目的配置文件介绍

OAuth2配置

核心的配置涉及OAuth2凭证，通常通过.ini文件进行管理，如上述提到的google_ads_php.ini示例文件。配置文件应当包含至少以下关键信息（以环境变量形式设置或者直接在文件中指定）：

• developerToken: 你的Google Ads开发者令牌。
• clientId: 你的OAuth2客户端ID。
• clientSecret: 对应的OAuth2客户端秘密。
• refreshToken: 通过授权流程获取的刷新令牌，用于长期访问API（仅限非Web应用程序场景）。
• customerId: 要操作的Google Ads账户的客户ID，需去除短横线。

注意：在生产环境中，建议将这些敏感信息安全存储，不在版本控制系统中提交。

通过以上步骤和理解，你可以顺利地集成并开始利用Google Ads API的PHP客户端库来进行广告相关的程序化操作。记得阅读具体示例中的注释和库的官方文档，以便更深入地掌握其用法和最佳实践。

google-ads-php Google Ads API Client Library for PHP 项目地址: https://gitcode.com/gh_mirrors/go/google-ads-php