redbaron76/googlavel

a Google API v3 wrapper for Laravel 4.x

A Google API v3 wrapper for Laravel 4

This package enables a Laravel flavoured way to manage Google services through its API interface (v3), _(*1)

Installation

Add the required package to your composer.json file, _(*2)

{
    "require": {
        ...
        "redbaron76/googlavel": "1.0"
    }
}

Set minimum-stability to 'dev'

In order to avoid Composer's possible conflicts, just set your composer.json 'minimum-stability' to 'dev', _(*3)

{
    ...
    "minimum-stability": "dev"
}

...then just run composer update, _(*4)

Laravel implementation

This package includes a ServiceProvider that will give access to a helpful Googlavel facade. Set the GooglavelServiceProvider reference in your /app/config/app.php like this:, _(*5)

// app/config/app.php

'providers' => array(
    '...',
    'Redbaron76\Googlavel\GooglavelServiceProvider'
);

Export and edit the configuration file

Before using this package, you will need to activate a profile from Google developer and get your personal code from the Google Developers Console in order to obtain access and use their services through API calls., _(*6)

, _(*7)

Once obtained Client ID and Client Secret strings for web application from the Google Developers Console and set a valid Redirect URI callback, export the package config file:, _(*8)

php artisan config:publish redbaron76/googlavel, _(*9)

...and put them to the oauth2 parameters into the config file, _(*10)

// app/config/packages/redbaron76/googlavel/config.php

return array(

    // OAuth2 Setting, you can get these keys in Google Developers Console
    'oauth2_client_id'      => '< YOUR CLIENT ID >',
    'oauth2_client_secret'  => '< YOUR CLIENT SECRET >',
    'oauth2_redirect_uri'   => 'http://localhost:8081/',   // Change it according to your needs

    ...
  );

Set also the correct scope for the services you will use in your application (and remember to activate related APIs inside the Google Developers Console => APIS & AUTH => APIs). Refer to Google API wiki for any help., _(*11)

Using the Googlavel facade

Once everything set correctly, you'll gain access to the Googlavel facade in a pure Laravel style., _(*12)

Need to use the Google Calendar service?

```php, <sub>(*13)</sub>

// routes.php, <sub>(*14)</sub>

Route::get('/', function() { if ( Input::has('code') ) { $code = Input::get('code');, <sub>(*15)</sub>

    // authenticate with Google API
    if ( Googlavel::authenticate($code) )
    {
        return Redirect::to('/protected');
    }
}

// get auth url
$url = Googlavel::authUrl();

return link_to($url, 'Login with Google!');

});, <sub>(*16)</sub>

Route::get('/logout', function() { // perform a logout with redirect return Googlavel::logout('/'); });, <sub>(*17)</sub>

Route::get('/protected', function() { // Get the google service (related scope must be set) $service = Googlavel::getService('Calendar');, <sub>(*18)</sub>

// invoke API call
$calendarList = $service->calendarList->listCalendarList();

foreach ( $calendarList as $calendar )
{
    echo "{$calendar->summary} <br>";
}

return link_to('/logout', 'Logout');

});, <sub>(*19)</sub>

```, <sub>(*20)</sub>