Google Drive API: creare un' app PHP per gestire il tuo Drive

Attraverso l' API di Google Drive è possibile creare un'app in PHP, attraverso la quale possiamo accedere e modificare il contenuto all' interno del nostro Google Drive.

Di seguito tutti  i passaggi necessari per la crezione di un app:

1°:Attivare la api di google drive

Andiamo sul sito https://console.developers.google.com/flows/enableapi?apiid=drive accediamo con la nosta utenza di Gmail, creaiamo un nuovo progetto,andiamo nella sezione autorizzazione OAuth e mettiamo un e-mail e il nome del prodotto.
Ora andiamo su credenziali e selezioniamo l'opzione ID client OAuth,

 come tipo mettiamo altro e lo chiamiamo ad esempio "GoogleDriveManage".

A questo punto scarichiamo il file .json rinominandolo in credentials.json e lo andiamo a copiare nella cartella in cui vogliamo creare la nostra app.

2°:scrivere il codice php

Utilizando il composer per installare la libreria di google drive. (Per chi non cosocesse composer vi rimando ad un'articolo specifico su questo tool, utile per scaricare le libreria di terzi garantendo la corretta gestione delle dipendenze tra librerie).

Da riga di comando installiamo la libreria:

composer require google/apiclient:"^2.0"  o  php composer.phar require google/apiclient:"^2.0"

Creiamo, quindi, un file quickstart.php all'interno della nostra cartella e vi inseriamo il seguente codice di esempio (vedi anche articolo ufficiale di google sulle API)

Nell'esempio seguente da notare che abbiamo impostato lo scope  Google_Service_Drive::DRIVE, che ci consente sia di leggere che modificare i contenuti di google drive.

Nell'esempio che troviamo nella pagina ufficiale di Google Drive, viene impostato uno scope di sola lettura.  Per capire come impostare i giusti Scope/Permessi in relazione allo scopo della nostra applicazione vi rimando al seguente articolo.

<?php
require __DIR__ . '/vendor/autoload.php';
date_default_timezone_set('Europe/Rome');

if (php_sapi_name() != 'cli') {
    throw new Exception('This application must be run on the command line.');
}

/**
 * Returns an authorized API client.
 * @return Google_Client the authorized client object
 */
function getClient()
{
    $client = new Google_Client();
    $client->setApplicationName('Google Drive API PHP Quickstart');
    $client->setScopes(Google_Service_Drive::DRIVE);
    $client->setAuthConfig('credentials.json');
    $client->setAccessType('offline');
    $client->setPrompt('select_account consent');

    // Load previously authorized token from a file, if it exists.
    $tokenPath = 'token.json';
    if (file_exists($tokenPath)) {
        $accessToken = json_decode(file_get_contents($tokenPath), true);
        $client->setAccessToken($accessToken);
    }

    // If there is no previous token or it's expired.
    if ($client->isAccessTokenExpired()) {
        // Refresh the token if possible, else fetch a new one.
        if ($client->getRefreshToken()) {
            $client->fetchAccessTokenWithRefreshToken($client->getRefreshToken());
        } else {
            // Request authorization from the user.
            $authUrl = $client->createAuthUrl();
            printf("Open the following link in your browser:\n%s\n", $authUrl);
            print 'Enter verification code: ';
            $authCode = trim(fgets(STDIN));

            // Exchange authorization code for an access token.
            $accessToken = $client->fetchAccessTokenWithAuthCode($authCode);
            $client->setAccessToken($accessToken);

            // Check to see if there was an error.
            if (array_key_exists('error', $accessToken)) {
                throw new Exception(join(', ', $accessToken));
            }
        }
        // Save the token to a file.
        if (!file_exists(dirname($tokenPath))) {
            mkdir(dirname($tokenPath), 0700, true);
        }
        file_put_contents($tokenPath, json_encode($client->getAccessToken()));
    }
    return $client;
}


// Get the API client and construct the service object.
$client = getClient();
$service = new Google_Service_Drive($client);

// Print the names and IDs for up to 10 files.
$optParams = array(
  'pageSize' => 10,
  'fields' => 'nextPageToken, files(id, name)'
);
$results = $service->files->listFiles($optParams);

if (count($results->getFiles()) == 0) {
    print "No files found.\n";
} else {
    print "Files:\n";
    foreach ($results->getFiles() as $file) {
        printf("%s (%s)\n", $file->getName(), $file->getId());
    }
}

3°:Esecuzione

A questo punto non ci resta che eseguire il nostro file.

Da riga di comando eseguire:  php quickstart.php

Alla prima esecuzione ci viene chiesto di inserire l'url di autorizzazione nel browser.

joomla@virtualmin:~/public_html/lab/google-drive$ php quickstart.php 

Open the following link in your browser:


 .... accounts.google.com/o/oauth2/auth?response_type=code&access_type=offline&client_id=.....
Enter verification code:

Dopo che abbiamo confermato cliccando su OK:

ci verrà restituita una pagina con il codice di verifica che inseriremo nel prompt a questo punto, se tutto è andato come previsto saremo in grado attraverso la shell, eseguendo il file PHP di poter gestire i file all'interno del nostro Google Drive.

Per vedere alcuni esempi e approfondire la gestione degli "Scope", vi consiglio di leggere il seguente articolo: Google Drive - Api - Esempi di app PHP

Verifica della validità del Token

E' possibile verificare se il Token rilasciato in fase inizializzazione (prima esecuzione dello script), scritto nel file token.json è attivo e valido.

Possiamo prendere il valore nel file token.json ed invocare il seguente url:

 https://www.googleapis.com/oauth2/v1/tokeninfo?access_token=........

Ci ritornerà un json con l'esito

{
 "issued_to": "823977055880-6a8e8e6m6t99nqmhj5kdtq6gta02p504.apps.googleusercontent.com",
 "audience": "823977055880-6a8e8e6m6t99nqmhj5kdtq6gta02p504.apps.googleusercontent.com",
 "scope": "https://www.googleapis.com/auth/drive",
 "expires_in": 3380,
 "access_type": "offline"
}

{
 "error": "invalid_token",
 "error_description": "Invalid Value"
}