pulkitjalan / google-apiclient
Google api php client wrapper with Cloud Platform and Laravel support
Installs: 2 360 452
Dependents: 6
Suggesters: 0
Security: 0
Stars: 249
Watchers: 9
Forks: 75
Open Issues: 0
Requires
- php: >=8.0
- google/apiclient: ^2.16
- illuminate/support: ^8.0|^9.0|^10.0|^11.0
Requires (Dev)
- mockery/mockery: ^1.6
- pestphp/pest: ^1.20|^2.0
README
Google api php client wrapper with Cloud Platform and Laravel support
Requirements
- PHP >=8.0
Installation
Install via composer
composer require pulkitjalan/google-apiclient
Laravel
To use in laravel add the following to the providers
array in your config/app.php
PulkitJalan\Google\GoogleServiceProvider::class
Next add the following to the aliases
array in your config/app.php
'Google' => PulkitJalan\Google\Facades\Google::class
Finally run php artisan vendor:publish --provider="PulkitJalan\Google\GoogleServiceProvider" --tag="config"
to publish the config file.
Using an older version of PHP / Laravel?
If you are on a PHP version below 8.0 or a Laravel version below 10.0, use an older version of this package.
Usage
The Client
class takes an array as the first parameter, see example of config file below:
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', '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 credentials JSON's location to use assert credentials, otherwise | app engine or compute engine will be used. | */ 'service' => [ /* | Enable service account auth or not. */ 'enabled' => false, /* | Path to service account json file */ 'file' => '', ], /* |---------------------------------------------------------------------------- | Additional config for the Google Client |---------------------------------------------------------------------------- | | Set any additional config variables supported by the Google Client | Details can be found here: | https://github.com/google/google-api-php-client/blob/master/src/Google/Client.php | | NOTE: If client id is specified here, it will get over written by the one above. | */ 'config' => [], ];
To use Google Cloud Platform services, enter the location to the service account JSON file (not the JSON string itself). To use App Engine or Computer Engine, leave it blank.
From Google's upgrading document:
Note: P12s are deprecated in favor of service account JSON, which can be generated in the Credentials section of Google Developer Console.
Get Google\Client
$client = new PulkitJalan\Google\Client($config); $googleClient = $client->getClient();
Laravel Example:
$googleClient = Google::getClient();
Get a service
$client = new PulkitJalan\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');
Laravel Example:
// returns instance of \Google\Service\Storage $storage = Google::make('storage'); // or $storage = Google::make(\Google\Service\Storage::class); // list buckets example $storage->buckets->listBuckets('project id'); // get object example $storage->objects->get('bucket', 'object');
Have a look at google/google-api-php-client-services to get a full list of the supported Google Services.