Google Ads DFA Reporting Samples 项目教程
1. 项目的目录结构及介绍
Google Ads DFA Reporting Samples 项目是一个用于与 DCM/DFA Reporting and Trafficking API 交互的示例代码集合。项目包含了多种编程语言和平台的示例代码。以下是项目的目录结构及介绍:
googleads-dfa-reporting-samples/
├── dotnet/
│ └── v4/
├── java/
├── php/
│ └── v4/
├── python/
│ └── v4/
├── ruby/
├── LICENSE
├── README.md
└── gen_sample_targets.bzl
dotnet/
:包含 .NET 平台的示例代码。java/
:包含 Java 平台的示例代码。php/
:包含 PHP 平台的示例代码。python/
:包含 Python 平台的示例代码。ruby/
:包含 Ruby 平台的示例代码。LICENSE
:项目的许可证文件。README.md
:项目的说明文档。gen_sample_targets.bzl
:用于生成示例目标的 Bazel 文件。
2. 项目的启动文件介绍
每个平台的示例代码目录中都包含了启动文件,用于初始化 API 连接并执行特定的操作。以下是一些示例:
php/v4/
目录中的启动文件通常是一个 PHP 脚本,例如example.php
,用于连接到 DCM API 并执行特定的报告查询。
<?php
require 'vendor/autoload.php';
use Google\AdsApi\Dfp\DfpServices;
use Google\AdsApi\Dfp\DfpSession;
use Google\AdsApi\Dfp\DfpSessionBuilder;
use Google\AdsApi\Dfp\v201808\ReportService;
// 初始化 DfpSession
$dfpSession = (new DfpSessionBuilder())
->fromFile()
->build();
// 创建 ReportService
$reportService = (new DfpServices())->get($dfpSession, ReportService::class);
// 执行报告查询
$reportJob = $reportService->runReportJob(...);
3. 项目的配置文件介绍
项目的配置文件通常用于存储 API 连接所需的凭证和设置。以下是一些示例:
php/v4/
目录中的配置文件通常是一个 JSON 文件,例如adsapi_php.ini
,用于存储 API 连接所需的凭证和设置。
[OAUTH2]
client_id = "INSERT_CLIENT_ID_HERE"
client_secret = "INSERT_CLIENT_SECRET_HERE"
refresh_token = "INSERT_REFRESH_TOKEN_HERE"
[DFP]
application_name = "INSERT_APPLICATION_NAME_HERE"
network_code = "INSERT_NETWORK_CODE_HERE"
以上配置文件包含了 OAuth2 认证所需的客户端 ID、客户端密钥和刷新令牌,以及 DFP 应用的名称和网络代码。
通过以上教程,您可以了解 Google Ads DFA Reporting Samples 项目的目录结构、启动文件和配置文件的基本信息,从而更好地使用和配置该项目。