joelbutcher / googleads-client-oauth2-wrapper
资助软件包维护!
joelbutcher
paypal.me/joelbutcher
Requires
- php: ^7.3|^8.0
- googleads/google-ads-php: ^8.0
- illuminate/support: ^8.0
Requires (Dev)
- mockery/mockery: ^1.0
- phpunit/phpunit: ^9.3
README
这是一个轻量级且易于配置的Google Ads PHP库的OAuth2包装器。
配置
要配置服务,提供一个包含您的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交互了。首先,我们需要使用刷新令牌授权用户。这可以通过Google的简单OAuth流程获得。
请确保在OAuth2.0授权请求中请求adwords作用域。
// ... $googleAds->authorize($refreshToken);
如果您使用的是MCC并已将login_customer_id
配置为使用MCC账户ID,则需要在authorize
方法的第二个参数中传递您代表该账户操作的ID。
// ... $googleAds->authorize($refreshToken, '<child-account-id>');
与Google Ads PHP SDK交互
现在您已配置并认证完毕,可以开始与底层的GoogleAdsClient
类交互。您可以从上面的代码片段中直接调用$googleAds
实例中的任何服务。例如,要检索广告活动服务客户端,只需调用以下内容
// ... $googleAds->getCampaignServiceClient();
版本控制
目前,我们只支持客户端的v6版本。
变更日志
请查看此存储库中的变更日志以了解所有最近的更改。
维护者
由Joel Butcher开发和维护。
鸣谢
您可以在这里查看所有贡献者。
许可
此软件包是开源软件,根据MIT许可证许可。