Google Ads PHP 客户端库教程

Google Ads PHP 客户端库教程

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

项目介绍

Google Ads PHP 客户端库是一个开源项目，旨在帮助开发者使用 PHP 语言与 Google Ads API 进行交互。该库提供了丰富的功能，包括广告管理、报告生成、账户管理等，使开发者能够轻松地集成 Google Ads 服务到他们的 PHP 应用程序中。

项目快速启动

安装

首先，确保你已经安装了 Composer，然后在你的项目目录下运行以下命令来安装 Google Ads PHP 客户端库：

composer require googleads/google-ads-php

配置

在项目根目录下创建一个 google_ads_php.ini 文件，并添加以下配置：

[GOOGLE_ADS]
; 替换为你的 Google Ads 开发者令牌
developerToken = "INSERT_DEVELOPER_TOKEN_HERE"

; 替换为你的 OAuth2 客户端 ID
clientId = "INSERT_OAUTH2_CLIENT_ID_HERE"

; 替换为你的 OAuth2 客户端密钥
clientSecret = "INSERT_OAUTH2_CLIENT_SECRET_HERE"

; 替换为你的 OAuth2 刷新令牌
refreshToken = "INSERT_OAUTH2_REFRESH_TOKEN_HERE"

; 替换为你的 Google Ads 客户 ID
loginCustomerId = "INSERT_LOGIN_CUSTOMER_ID_HERE"

初始化客户端

在你的 PHP 文件中，初始化 Google Ads 客户端并进行 API 调用：

require 'vendor/autoload.php';

use Google\Ads\GoogleAds\Lib\V13\GoogleAdsClientBuilder;
use Google\Ads\GoogleAds\Lib\V13\GoogleAdsException;
use Google\Ads\GoogleAds\Lib\V13\GoogleAdsClient;
use Google\Ads\GoogleAds\V13\Services\GoogleAdsServiceClient;

$iniFilePath = __DIR__ . '/google_ads_php.ini';
$googleAdsClient = (new GoogleAdsClientBuilder())
    ->fromFile($iniFilePath)
    ->build();

try {
    $googleAdsServiceClient = $googleAdsClient->getGoogleAdsServiceClient();
    // 进行 API 调用
} catch (GoogleAdsException $googleAdsException) {
    // 处理异常
}

应用案例和最佳实践

应用案例

1. 广告管理：使用 Google Ads PHP 客户端库可以轻松管理广告系列、广告组和广告。例如，你可以创建一个新的广告系列并设置预算。

2. 报告生成：通过调用 Google Ads API，你可以生成详细的报告，包括广告表现、点击率、转化率等。

3. 账户管理：管理多个 Google Ads 账户，进行账户级别的操作，如账户预算调整、账户状态监控等。

最佳实践

1. 错误处理：在调用 API 时，务必进行异常处理，以确保应用程序的稳定性。

2. 性能优化：合理使用批量操作和异步请求，以提高 API 调用的性能。

3. 安全配置：确保你的 OAuth2 令牌和开发者令牌等敏感信息安全存储，避免泄露。

典型生态项目

1. Google Ads API 官方文档：提供了详细的 API 参考和使用指南，帮助开发者深入理解 Google Ads API 的功能和使用方法。

2. Google Ads 开发者社区：一个活跃的开发者社区，提供了丰富的资源、教程和问题解答，帮助开发者解决在使用 Google Ads API 过程中遇到的问题。

3. Google Ads 示例代码库：包含了多个示例代码，展示了如何使用 Google Ads PHP 客户端库进行常见的操作，如广告创建、报告生成等。

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