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

Puoi condividere file e cartelle di Google Drive con altri utenti utilizzando l' interfaccia utente di Drive o tramite l' API Google Drive. Quando condividi un file da Drive, puoi decidere se le persone possono modificarlo, commentarlo o solamente aprirlo.

Una chiave di accesso alla risorsa consente di proteggere il file dagli accessi indesiderati. Le chiavi di accesso alla risorsa sono un parametro aggiuntivo che viene passato in modo che gli utenti possano accedere a determinati file condivisi tramite un link. Gli utenti che non hanno mai visualizzato il file prima devono fornire la chiave di accesso alla risorsa per accedervi. Gli utenti che hanno visualizzato di recente il file o che hanno accesso diretto non hanno 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 come risultato di una type=user o type=group permissions risorsa. Le richieste degli utenti che hanno accesso a questi file condivisi tramite link solo utilizzando un'autorizzazione type=domain o type=anyone potrebbero richiedere una chiave di accesso alla risorsa.

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

Leggere la chiave di accesso alla risorsa dal file

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

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

I campi della 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 state parametro. Per saperne di più, consulta Scaricare ed esportare file.

Impostare la chiave di accesso alla risorsa nella richiesta

Le chiavi di accesso alla risorsa per tutti i file a cui fanno riferimento le richieste all'API Drive vengono impostate nell'intestazione HTTP X-Goog-Drive-Resource-Keys.

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

Sintassi

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

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

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