Google AdSense 管理 API 示例项目教程

Google AdSense 管理 API 示例项目教程

1. 项目的目录结构及介绍

项目 googleads-adsense-examples 的目录结构如下：

googleads-adsense-examples/
├── LICENSE
├── README.md
└── v2/
    ├── dotnet/
    ├── java/
    ├── php/
    │   ├── examples/
    │   │   └── GetAllSavedReports.php
    ├── python/

目录介绍

• LICENSE: 项目许可证文件，采用 Apache-2.0 许可证。
• README.md: 项目说明文件，包含项目的基本信息和使用指南。
• v2/: 包含不同编程语言的示例代码。
  • dotnet/: C# 语言的示例代码。
  • java/: Java 语言的示例代码。
  • php/: PHP 语言的示例代码。
    • examples/: PHP 示例代码目录。
      • GetAllSavedReports.php: 获取所有保存报告的示例代码。
  • python/: Python 语言的示例代码。

2. 项目的启动文件介绍

在 googleads-adsense-examples 项目中，不同编程语言的启动文件位于各自的目录下。以 PHP 为例，主要的启动文件是 GetAllSavedReports.php。

PHP 启动文件

• GetAllSavedReports.php: 该文件展示了如何使用 PHP 调用 AdSense Management API 获取所有保存的报告。

// 示例代码片段
require_once __DIR__ . '/../vendor/autoload.php';

use Google\AdsApi\AdManager\AdManagerSession;
use Google\AdsApi\AdManager\AdManagerSessionBuilder;
use Google\AdsApi\AdManager\v202108\ReportService;
use Google\AdsApi\Common\OAuth2TokenBuilder;

// 配置和初始化代码

3. 项目的配置文件介绍

在 googleads-adsense-examples 项目中，配置文件通常用于设置 API 访问的凭证和参数。以 PHP 为例，配置文件通常是一个包含 API 密钥和其他设置的文件。

PHP 配置文件

• adsense-php.ini: 该文件包含了访问 AdSense Management API 所需的配置信息，如客户端 ID、客户端密钥、刷新令牌等。

# adsense-php.ini 示例内容
[AD_MANAGER]
networkCode = "INSERT_NETWORK_CODE_HERE"
applicationName = "INSERT_APPLICATION_NAME_HERE"

[OAUTH2]
clientId = "INSERT_CLIENT_ID_HERE"
clientSecret = "INSERT_CLIENT_SECRET_HERE"
refreshToken = "INSERT_REFRESH_TOKEN_HERE"

以上是 googleads-adsense-examples 项目的基本教程，涵盖了项目的目录结构、启动文件和配置文件的介绍。希望这些信息能帮助你更好地理解和使用该项目。