joelbutcher / googleads
一个轻量级且易于配置的Google Ads PHP客户端扩展,支持OAuth2。
资助包维护!
joelbutcher
paypal.me/joelbutcher
Requires
- php: ^8.0
- googleads/google-ads-php: ^22.0
Requires (Dev)
- mockery/mockery: ^1.5
- phpunit/phpunit: ^9.5
README
一个轻量级且易于配置的Google Ads PHP客户端扩展,支持OAuth2。
安装
使用composer安装包
`composer require joelbutcher/googleads
配置
要配置服务,请提供一个包含您的 client_id
、client_secret
、developer_token
和 Google Ads 账户 ID 的数组
$config = [ 'client_id' => '<your-app-client-id>', 'client_secret' => '<your-app-client-secret>', 'developer_token' => '<your-developer-token>', 'login_customer_id' => '<your-app-client-id>', ]; $googleAds = new GoogleAds($config);
注意,如果您使用的是MCC(管理账户),则需要将
login_customer_id
设置为您的MCC账户 ID。
使用方法
一旦您已配置客户端,就可以开始使用客户端与Google Ads进行交互。首先,我们需要使用刷新令牌授权用户。这可以通过简单的 OAuth流程 获取。
请确保在OAuth2.0授权请求中请求adwords作用域。
// ... $googleAds->authorize($refreshToken);
如果您使用MCC并且已将 login_customer_id
配置为使用MCC账户 ID,则需要将代表操作的账户 ID 作为 authorize
方法的第二个参数传递。
// ... $googleAds->authorize($refreshToken, '<child-account-id>');
与Google Ads PHP SDK交互
现在您已经配置并认证完毕,您现在可以开始与底层的 GoogleAdsClient
类进行交互。您可以直接从上面的代码片段中的 $googleAds
实例调用这里找到的任何服务。例如,要检索Campaign Service客户端,只需调用以下代码
// ... $googleAds->getCampaignServiceClient();
版本控制
目前,我们仅支持Google Ads SDK的V9版本。
变更日志
请查看此存储库中的所有最近更改的 变更日志。
维护者
由 Joel Butcher 开发和维护
致谢
您可以在这里查看所有贡献者。
许可证
此软件包是开源软件,根据MIT许可证授权。