irisdande/lara5-googleclient-api

Google api php client wrapper with Cloud Platform and Laravel 4 & 5 support

Google Api Client Wrapper

Google api php client wrapper with Cloud Platform and Laravel 4 & 5 support, _(*1)

, _(*2)

Requirements

This package requires PHP >=5.4, _(*3)

Installation

Install via composer - edit your composer.json to require the package., _(*4)

"require": {
    "irisdande/lara5-googleclient-api": "2.*"
}

Then run composer update in your terminal to pull it in., _(*5)

Or use composer require irisdande/lara5-googleclient-api, _(*6)

Laravel

To use in laravel add the following to the providers array in your config/app.php, _(*7)

IrisDande\Google\GoogleServiceProvider::class

Next add the following to the aliases array in your config/app.php, _(*8)

'Google' => IrisDande\Google\Facades\Google::class

Finally run php artisan vendor:publish --provider="IrisDande\Google\GoogleServiceProvider" --tag="config" to publish the config file., _(*9)

Looking for a Laravel 4 compatible version?

Checkout the 1.0 branch, _(*10)

Usage

The Client class takes an array as the first parameter, see example of config file below:, _(*11)

return [
    /*
    |----------------------------------------------------------------------------
    | Google application name
    |----------------------------------------------------------------------------
    */
    'application_name' => '',

    /*
    |----------------------------------------------------------------------------
    | Google OAuth 2.0 access
    |----------------------------------------------------------------------------
    |
    | Keys for OAuth 2.0 access, see the API console at
    | https://developers.google.com/console
    |
    */
    'client_id' => '',
    'client_secret' => '',
    'redirect_uri' => '',
    'scopes' => [],
    'access_type' => 'online',
    'approval_prompt' => 'auto',

    /*
    |----------------------------------------------------------------------------
    | Google developer key
    |----------------------------------------------------------------------------
    |
    | Simple API access key, also from the API console. Ensure you get
    | a Server key, and not a Browser key.
    |
    */
    'developer_key' => '',

    /*
    |----------------------------------------------------------------------------
    | Google service account
    |----------------------------------------------------------------------------
    |
    | Set the information below to use assert credentials
    | Leave blank to use app engine or compute engine.
    |
    */
    'service' => [
        /*
        | Example xxx@developer.gserviceaccount.com
        */
        'account' => '',

        /*
        | Example ['https://www.googleapis.com/auth/cloud-platform']
        */
        'scopes' => [],

        /*
        | Path to key file
        | Example storage_path().'/key/google.p12'
        */
        'key' => '',
    ]
];

To use the Google Cloud Platform Services you can either set the information in the config file under service, or if running under compute engine (or app engine) leave it blank., _(*12)

NOTE: service => ['account'] is the service Email Address and not the Client ID!, _(*13)

Get Google_Client, _(*14)

$client = new IrisDande\Google\Client($config);
$googleClient = $client->getClient();

Laravel Example:, _(*15)

$googleClient = Google::getClient();

Get a service, _(*16)

$client = new IrisDande\Google\Client($config);

// returns instance of \Google_Service_Storage
$storage = $client->make('storage');

// list buckets example
$storage->buckets->listBuckets('project id');

// get object example
$storage->objects->get('bucket', 'object');