PHPackages                             lucasgiovanny/laravel-google-ads-rest - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. lucasgiovanny/laravel-google-ads-rest

ActiveLibrary[API Development](/categories/api)

lucasgiovanny/laravel-google-ads-rest
=====================================

Use Laravel Google Ads REST API easy

v1.4.0(1y ago)117.6k1MITPHPPHP ^8.0CI passing

Since Mar 27Pushed 5mo ago1 watchersCompare

[ Source](https://github.com/lucasgiovanny/laravel-google-ads-rest)[ Packagist](https://packagist.org/packages/lucasgiovanny/laravel-google-ads-rest)[ Docs](https://github.com/lucasgiovanny/laravel-google-ads-rest)[ GitHub Sponsors](https://github.com/lucasgiovanny)[ RSS](/packages/lucasgiovanny-laravel-google-ads-rest/feed)WikiDiscussions 1.x Synced yesterday

READMEChangelog (5)Dependencies (14)Versions (8)Used By (0)

[![Laravel Google Ads RES](art/logo.png)](art/logo.png)

Laravel Google Ads Rest is a package created by [Lucas Giovanny](https://github.com/lucasgiovanny) that provides a convenient and user-friendly way to utilize the Google Ads API through a REST protocol. With this package, users can easily integrate their Laravel application with the Google Ads API, without the need for extensive coding or technical expertise. This package simplifies the process of accessing and manipulating data from Google Ads campaigns, making it easier for developers to build powerful applications that leverage the full capabilities of the Google Ads API.

[![GitHub release (latest by date)](https://camo.githubusercontent.com/d5ec0319f435d4354a30a341a9f3e13fa0524cad56ed5a91d3fd206f0944476b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f6c7563617367696f76616e6e792f6c61726176656c2d676f6f676c652d6164732d726573743f6c6162656c3d6c61737425323076657273696f6e)](https://camo.githubusercontent.com/d5ec0319f435d4354a30a341a9f3e13fa0524cad56ed5a91d3fd206f0944476b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f6c7563617367696f76616e6e792f6c61726176656c2d676f6f676c652d6164732d726573743f6c6162656c3d6c61737425323076657273696f6e)[![GitHub](https://camo.githubusercontent.com/e2e072f247c3d97ecb6ab2f377b5b7c53ec78bb132032a7f8e4cf692d6dcbeb0/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6c7563617367696f76616e6e792f6c61726176656c2d676f6f676c652d6164732d72657374)](https://camo.githubusercontent.com/e2e072f247c3d97ecb6ab2f377b5b7c53ec78bb132032a7f8e4cf692d6dcbeb0/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6c7563617367696f76616e6e792f6c61726176656c2d676f6f676c652d6164732d72657374)

Documentation
-------------

[](#documentation)

### Installation

[](#installation)

To install the package, you can use Composer by running the following command:

```
composer require lucasgiovanny/laravel-google-ads-rest
```

### Configuration

[](#configuration)

To use the package, you must configure your credentials on your `.env` file.

```
GOOGLEADS_CLIENT_ID=
GOOGLEADS_CLIENT_SECRET=
GOOGLEADS_DEVELOPER_TOKEN=
GOOGLEADS_REFRESH_TOKEN=
GOOGLEADS_DEFAULT_ACCOUNT=
```

### Usage

[](#usage)

You can use the package by calling the `GoogleAds` facade.

Example:

```
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()
```

#### Method: `account($accountId)`

[](#method-accountaccountid)

The `account()` method sets the Google Ads account ID to be used for the query. It takes in a string parameter `$accountId` which is the Google Ads account ID.

#### Method: `from($resource)`

[](#method-fromresource)

The `from()` method specifies the **resource** to be queried. It takes in a string parameter `$resource` which is the name of the resource in the Google Ads API.

#### Method: `select($fields)`

[](#method-selectfields)

The `select()` method specifies the **fields** to be retrieved from the specified resource. It takes in an array parameter `$fields` which is a list of the field names as strings.

#### Method: `where($field, $operator, $value)`

[](#method-wherefield-operator-value)

The `where()` method specifies a filter to apply to the query. It takes in three parameters: `$field` which is the name of the field to filter on, `$operator` which is the filter operator (e.g. BETWEEN, EQUALS, etc.), and `$value` which is the value to filter on.

#### Method: `get()`

[](#method-get)

The `get()` method executes the query and returns the result as an array of objects.

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [Lucas Giovanny](https://github.com/lucasgiovanny)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

41

—

FairBetter than 87% of packages

Maintenance55

Moderate activity, may be stable

Popularity30

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity55

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 85.1% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~205 days

Recently: every ~256 days

Total

6

Last Release

170d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/8487f2121d7a9d801d87e5d28efe83dea1549b6ba8e2fc6519edea6d66eaa31a?d=identicon)[lucasgiovanny](/maintainers/lucasgiovanny)

---

Top Contributors

[![lucasgiovanny](https://avatars.githubusercontent.com/u/4853801?v=4)](https://github.com/lucasgiovanny "lucasgiovanny (40 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (5 commits)")[![D4Cheap](https://avatars.githubusercontent.com/u/58009830?v=4)](https://github.com/D4Cheap "D4Cheap (2 commits)")

---

Tags

laravelgoogle adslucasgiovannylaravel-google-ads

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/lucasgiovanny-laravel-google-ads-rest/health.svg)

```
[![Health](https://phpackages.com/badges/lucasgiovanny-laravel-google-ads-rest/health.svg)](https://phpackages.com/packages/lucasgiovanny-laravel-google-ads-rest)
```

###  Alternatives

[dedoc/scramble

Automatic generation of API documentation for Laravel applications.

2.1k11.2M101](/packages/dedoc-scramble)[simplestats-io/laravel-client

Server-side analytics for Laravel that follows the full funnel from visit to registration to payment, attributed to the channel that drove it. Revenue, MRR, churn and ad-spend profit (ROAS/CAC) per channel. GDPR compliant, ad-blocker proof.

5022.0k](/packages/simplestats-io-laravel-client)[spatie/laravel-health

Monitor the health of a Laravel application

87512.0M167](/packages/spatie-laravel-health)[spatie/laravel-pdf

Create PDFs in Laravel apps

1.0k4.8M47](/packages/spatie-laravel-pdf)[defstudio/telegraph

A laravel facade to interact with Telegram Bots

816333.9k3](/packages/defstudio-telegraph)[codebar-ag/laravel-docuware

DocuWare integration with Laravel

1123.7k](/packages/codebar-ag-laravel-docuware)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)