lucasgiovanny/laravel-google-ads-rest

轻松使用 Laravel Google Ads REST API

v1.3.0 2024-03-13 07:48 UTC

README

Laravel Google Ads RES

Laravel Google Ads Rest 是由 Lucas Giovanny 创建的一个包,它通过 REST 协议提供了一种方便且用户友好的方式来利用 Google Ads API。使用此包,用户可以轻松地将他们的 Laravel 应用程序与 Google Ads API 集成,无需进行大量的编码或技术专长。此包简化了访问和操作 Google Ads 营销活动数据的流程,使得开发者能够构建利用 Google Ads API 全部功能的强大应用程序。

GitHub release (latest by date) GitHub

文档

安装

要安装此包,您可以使用 Composer 运行以下命令

composer require lucasgiovanny/laravel-google-ads-rest

配置

要使用此包,您必须在您的 .env 文件上配置您的凭证。

GOOGLEADS_CLIENT_ID=
GOOGLEADS_CLIENT_SECRET=
GOOGLEADS_DEVELOPER_TOKEN=
GOOGLEADS_REFRESH_TOKEN=
GOOGLEADS_DEFAULT_ACCOUNT=

用法

您可以通过调用 GoogleAds 门面来使用此包。

示例

use LucasGiovanny\LaravelGoogleAds\Facades\GoogleAds;

GoogleAds::account('ACCOUNT_ID')
    ->from('ad_group_ad')
    ->select(['metrics.cost_micros', 'segments.date'])
    ->where('segments.date', 'BETWEEN', '2023-01-01 AND 2023-01-31')
    ->get()

方法:account($accountId)

account() 方法设置要用于查询的 Google Ads 账户 ID。它接受一个字符串参数 $accountId,这是 Google Ads 账户 ID。

方法:from($resource)

from() 方法指定要查询的资源。它接受一个字符串参数 $resource,这是 Google Ads API 中资源的名称。

方法:select($fields)

select() 方法指定从指定的资源中检索的字段。它接受一个数组参数 $fields,这是一个字段名称的字符串列表。

方法:where($field, $operator, $value)

where() 方法指定查询的过滤器。它接受三个参数:$field 是要筛选的字段名称,$operator 是筛选运算符(例如 BETWEEN、EQUALS 等),$value 是要筛选的值。

方法:get()

get() 方法执行查询并返回一个对象数组的结果。

变更日志

有关最近更改的更多信息,请参阅变更日志

贡献

请参阅 贡献指南 以获取详细信息。

安全漏洞

请查看我们的安全策略以了解如何报告安全漏洞。

鸣谢

许可

MIT 许可证 (MIT)。有关更多信息,请参阅许可文件