albafo / google-connector-php
Google OAuth2 API 连接器
v0.1.3
2020-10-07 10:06 UTC
Requires
- php: ^7.3
- ext-json: *
- google/auth: ^1.13
Requires (Dev)
- dms/phpunit-arraysubset-asserts: ^0.2.0
- phpunit/phpunit: ^9.4
README
本项目托管了针对各种 Google API(广告、YouTube、度量...)的 PHP Google API 连接器。
安装
使用 composer require
Composer 将下载库并将其存储在 vendor/
目录下。**示例不会通过此下载方法下载**。
-
使用 Composer 安装最新版本。
$ composer require albafo/google-connector-php
-
如果您尚未设置凭证,请按照 使用 OAuth 2.0 访问 Google API 进行操作。
-
现在您可以使用此库了。
AdsApi
AdsApi 允许我们通过 Google Ads 查询语言 访问 Google Ads 报告。
设置您的凭证
- 从您的 Google Cloud Platform 凭证部分获取 OAuth2 Client ID 和 Secret。
- 从您项目的根目录中调用我们的 refresh-token.php 脚本以获取 Refresh Token,这将提示您输入 OAuth2 客户端 ID 和密钥。
php vendor/bin/refresh-token.php
- 从您的 Google Ads API 中心 获取 Development Token。
- 从您的 Google Ads 控制台获取您的 Customer ID(您咨询的账户 ID)和您的 Login Customer ID(父账户 ID)。查找您的 Customer ID
从您的 customerId 和 loginCustomerId 中删除连字符: xxx-XXX-xxx 到 xxxXXXxxx
基本用法
要使用 Google Ads 查询语言获取报告,请使用您的配置创建 AdsApi 的一个实例,然后从 searchStream 方法发送查询。
use Zeus\GoogleConnector\Api\AdsApi; $adsApi = AdsApi::fromConfig([ 'clientId' => $config['clientId'], 'clientSecret' => $config['clientSecret'], 'refreshToken' => $config['refreshToken'], 'developerToken' => $config['developerToken'], 'customerId' => $config['customerId'], 'loginCustomerId' => $config['loginCustomerId'] ]); $reportObject = $adsApi->searchStream(" SELECT campaign.id, campaign.name, campaign.status FROM campaign ORDER BY campaign.id ");
在 Google 开发者 Ads Api 页面 了解所有报告查询选项。