PHPackages                             mcg/google-auth-service - 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. [Authentication & Authorization](/categories/authentication)
4. /
5. mcg/google-auth-service

ActiveLibrary[Authentication & Authorization](/categories/authentication)

mcg/google-auth-service
=======================

Librerías en PHP para facilitar la autentificación hacia los servicios de Google como Gmail, Google Drive usando las REST APIs de Google.

05PHP

Since Jan 5Pushed 5y ago1 watchersCompare

[ Source](https://github.com/marcocantugea/googleauthcli)[ Packagist](https://packagist.org/packages/mcg/google-auth-service)[ RSS](/packages/mcg-google-auth-service/feed)WikiDiscussions master Synced today

READMEChangelogDependenciesVersions (1)Used By (0)

### Servicios Google Librerias de Autentificación
mcg/google-auth-service

[](#servicios-google-librerias-de-autentificación-mcggoogle-auth-service)

---

 Librerías en PHP para facilitar la autentificación hacia los servicios de Google como Gmail, Google Drive usando las REST APIs de Google.

📝 Table of Contents
-------------------

[](#-table-of-contents)

- [Acerca](#about)
- [Requerimientos](#Requerimientos)
- [Instalacion](#install)
- [Autentificación a GMail por API](#usageMail)
- [Obtener Correos de Gmail por API](#getGmailAPI)

🧐 Acerca
------------------------------------------

[](#-acerca-)

Estas clases son de ayuda a simplificar el proceso de obtener el cliente del servicio de google asi como realizar la autentificacion de Google

🏁 Requetimientos
-----------------------------------------------------------

[](#-requetimientos-)

Antes de utilizar esta clase ser requiere crear las credenciales oAuth de google descargando el archivo json de la consola de APIs.

Para mayor informacion utilize la siguiente liga:

[](https://developers.google.com/identity/protocols/oauth2)

Una vez descargado nuesro archivo de credenciales lo agregamos a nuestro proyecto, puede ser en la raiz del proyecto o en alguna carpeta deseada, por defecto , la libreria busca el archivo "./credentials.json" en la raíz del proyecto.

En los siguientes ejemplo se ralizara basandonos que el archivo de credenciales esta en la raíz del proyecto.

### Instalacion

[](#instalacion-)

Para la instalación se utiliza via composer

```
composer require mcg/google-auth-service

```

🔧 Autentificación a GMail por API
-----------------------------------------------------------------------

[](#-autentificación-a-gmail-por-api-)

Basandonos que el archivo de credenciales esta en la raiz del proyecto y tiene como nombre "credentials.json" se requiere que se agregen los permisos a esta aplicacion y crear un archivo del token que genera la autentificacion oAuth.

Para inicializar esta autentificación se necesita llamar a la pagina de google para que el usuario le de perimiso a la aplicaci&oacute:n.

Para eso utilizamos el siguiente codigo desde nuestra consola:

```
  $url=AuthGoogleMailService::getActivationURL();
  print_r($url);
  AuthGoogleMailService::setActivationCode(readline());

```

El resultado sera un archivo json en la raiz de nuestro proyecto con el token oAuth generado por Google.

Si deseamos configurar la ruta de el archivo de credenciales y del token, utilizamos el siguente codigo.

```
$AuthGoogleMailService= new AuthGoogleMailService();
$AuthGoogleMailService->setCredentialsJsonPath("./credenciales/credentialsGmail.json");
$AuthGoogleMailService->setTokenPath("./tokens/tokenGmail.json");

$MailClient=$AuthGoogleMailService->getClient();

```

Si deseamos configurar mas propiedades teneos las siguientes

```
$AuthGoogleMailService= new AuthGoogleMailService();
$AuthGoogleMailService->setCredentialsJsonPath("./credenciales/credentialsGmail.json");
$AuthGoogleMailService->setTokenPath("./tokens/tokenGmail.json");
$AuthGoogleMailService->setClientName("Aplication or client name");
$AuthGoogleMailService->setScope(Google_Service_Gmail::GMAIL_READONLY);
$AuthGoogleMailService->setAccessType("offline");
$AuthGoogleMailService->setSetPrompt("select_account consent");

$MailClient=$AuthGoogleMailService->getClient();

```

### Obtener Correos de Gmail por API

[](#obtener-correos-de-gmail-por-api-)

Para obtener los correos de GMAIL por API utilizamos el siguiente ejemplo

```
  //Obtenemos el servicio de gmail
  $GoogleClient = (new AuthGoogleMailService())->getClient();
  $Gmailservice = new Google_Service_Gmail($GoogleClient);

  //parametros para la obtencion de los correos
  $options = array('labelIds' => 'INBOX', 'maxResults' => 10, 'q' => 'is:unread');
  //Obtiene los mensajes
  $messages = $Gmailservice->users_messages->listUsersMessages('me', $options);

  foreach ($messages as $message) {
    //Obtiene lo escencial del mensaje
    $Emailmessage = $Gmailservice->users_messages->get('me', $message['id'], ['format' => 'FULL']);
    foreach($Emailmessage['payload']->getHeaders() as $header){
      print_r($header->name." : ".$header->value . PHP_EOL);
    }
  }

```

###  Health Score

17

—

LowBetter than 6% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity31

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% 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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/cc9d70076bfb03db411e497d3885e318ed6de0cdd4c4265f916ca76d17792803?d=identicon)[marcocantugea](/maintainers/marcocantugea)

---

Top Contributors

[![marcocantugea](https://avatars.githubusercontent.com/u/18039908?v=4)](https://github.com/marcocantugea "marcocantugea (13 commits)")

### Embed Badge

![Health badge](/badges/mcg-google-auth-service/health.svg)

```
[![Health](https://phpackages.com/badges/mcg-google-auth-service/health.svg)](https://phpackages.com/packages/mcg-google-auth-service)
```

###  Alternatives

[vitalybaev/laravel5-dkim

Laravel 5/6 package for signing outgoing messages with DKIM.

3163.1k](/packages/vitalybaev-laravel5-dkim)

PHPackages © 2026

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