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

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

Una chiave risorsa consente di proteggere il file da accessi indesiderati. Le chiavi di 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 devono fornire la chiave della risorsa per ottenere l'accesso. Gli utenti che hanno visualizzato di recente il file o che dispongono dell'accesso diretto non hanno bisogno della chiave della risorsa per accedere al file.

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

Per ulteriori informazioni sulle autorizzazioni, vedi Condividere file, cartelle e Drive. Per un elenco completo dei ruoli e delle operazioni consentite da ciascuno, vedi Ruoli e autorizzazioni.

Leggi la chiave della risorsa dal file

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

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

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 di risorsa per tutti i file a cui fanno riferimento le richieste all'API Drive sono impostate sull'intestazione HTTP X-Goog-Drive-Resource-Keys.

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

Sintassi

Un ID file e una coppia di chiavi della risorsa sono impostati nell'intestazione utilizzando un separatore barra (/). L'intestazione è creata combinando tutte le coppie ID file e chiavi risorsa mediante separatori della virgola (,).

Ad esempio, potresti ricevere una richiesta di spostamento del file fileId1 dalla cartella fileId2 alla cartella fileId3. Supponiamo che le chiavi delle risorse per questi tre file siano rispettivamente resourceKey1, resourceKey2 e resourceKey3. L'intestazione creata a partire da questi valori utilizzando una barra e una virgola come separatore è:

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