albafo/google-connector-php

Google OAuth2 API 连接器

v0.1.3 2020-10-07 10:06 UTC

This package is auto-updated.

Last update: 2024-09-07 23:39:41 UTC


README

PHP version Build Status

本项目托管了针对各种 Google API(广告、YouTube、度量...)的 PHP Google API 连接器。

安装

使用 composer require

Composer 将下载库并将其存储在 vendor/ 目录下。**示例不会通过此下载方法下载**。

  1. 使用 Composer 安装最新版本。

    $ composer require albafo/google-connector-php
    
  2. 如果您尚未设置凭证,请按照 使用 OAuth 2.0 访问 Google API 进行操作。

  3. 现在您可以使用此库了。

AdsApi

AdsApi 允许我们通过 Google Ads 查询语言 访问 Google Ads 报告。

设置您的凭证

  1. 从您的 Google Cloud Platform 凭证部分获取 OAuth2 Client IDSecret
  2. 从您项目的根目录中调用我们的 refresh-token.php 脚本以获取 Refresh Token,这将提示您输入 OAuth2 客户端 ID 和密钥。
php vendor/bin/refresh-token.php
  1. 从您的 Google Ads API 中心 获取 Development Token
  2. 从您的 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 页面 了解所有报告查询选项。

下一个模块很快将推出...