joelbutcher/googleads

一个轻量级且易于配置的Google Ads PHP客户端扩展,支持OAuth2。

v8.0.0 2024-02-09 17:15 UTC

README

Build Status Total Downloads Latest Stable Version License

一个轻量级且易于配置的Google Ads PHP客户端扩展,支持OAuth2。

安装

使用composer安装包

`composer require joelbutcher/googleads

配置

要配置服务,请提供一个包含您的 client_idclient_secretdeveloper_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许可证授权。