Accedi ai file di Drive condivisi tramite link utilizzando chiavi di risorse

Puoi condividere file e cartelle di Google Drive con altre persone utilizzando l' interfaccia utente di Drive o tramite l' API Google Drive. Quando condividi da Drive, puoi controllare se le persone possono modificare, commentare o solo aprire il file.

Una chiave di accesso alla risorsa contribuisce a proteggere il file da accessi indesiderati. Le chiavi risorsa sono un parametro aggiuntivo che viene trasmesso in modo che gli utenti possano accedere a determinati file che sono stati condivisi utilizzando un link. Gli utenti che non hanno mai visualizzato il file devono fornire la chiave di accesso alla risorsa per ottenere l'accesso. Chi ha visualizzato di recente il file o ha accesso diretto non ha bisogno della chiave di accesso alla risorsa per accedere al file.

Un file di Drive condiviso con un link può essere scoperto solo dagli utenti che possono accedere al file in seguito a una risorsa type=user o type=group permissions. Le richieste degli utenti che hanno accesso a questi file condivisi tramite link solo con un'autorizzazione type=domain o type=anyone potrebbero richiedere una chiave della risorsa.

Per saperne di più sulle autorizzazioni, vedi Condividere file, cartelle e unità. Per un elenco completo dei ruoli e delle operazioni consentite da ciascuno, consulta Ruoli e autorizzazioni.

Leggi la chiave della risorsa dal file

L'API Drive restituisce la chiave risorsa di un file nel campo resourceKey di sola lettura della risorsa files.

Se il file è una scorciatoia di Drive, la chiave risorsa della destinazione della scorciatoia viene restituita nel campo shortcutDetails.targetResourceKey di sola lettura.

I campi nella risorsa files che restituiscono URL, come exportLinks, webContentLink e webViewLink, includono anche resourceKey. I client che si integrano con l'interfaccia utente di Drive possono anche utilizzare resourceKeys all'interno del parametro state. Per maggiori informazioni, vedi Scaricare ed esportare file.

Imposta la chiave della risorsa nella richiesta

Le chiavi delle risorse per tutti i file a cui fanno riferimento le richieste all'API Drive sono impostate nell'intestazione HTTP X-Goog-Drive-Resource-Keys.

Le richieste all'API Drive possono specificare una o più chiavi risorsa con l'intestazione HTTP X-Goog-Drive-Resource-Keys.

Sintassi

Una coppia di ID file e chiave risorsa viene impostata nell'intestazione utilizzando una barra (/) come separatore. L'intestazione viene creata combinando tutte le coppie chiave-valore ID file e risorsa utilizzando separatori virgola (,).

Ad esempio, considera una richiesta di spostamento del file fileId1 dalla cartella fileId2 alla cartella fileId3. Supponiamo che le chiavi della risorsa per questi tre file siano resourceKey1, resourceKey2 e resourceKey3, rispettivamente. L'intestazione creata da questi valori utilizzando una barra e separatori virgola è:

    X-Goog-Drive-Resource-Keys: fileId1/resourceKey1,fileId2/resourceKey2,fileId3/resourceKey3