Puoi condividere file e cartelle di Google Drive con altre persone utilizzando l' UI di Drive o tramite l' API Google Drive. Quando condividi da Drive, puoi decidere se le persone possono modificare, commentare o aprire solo il file.
Una chiave della risorsa consente di proteggere il file da accessi indesiderati. Le chiavi delle risorse sono un parametro aggiuntivo che viene passato 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 della risorsa per ottenere l'accesso. Gli utenti che di recente hanno visualizzato il file o che hanno 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 accedere al file come risultato di una risorsa permissions
type=user
o type=group
. 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 della 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 della risorsa di un file nel campo resourceKey
di sola lettura della risorsa files
.
Se il file è una scorciatoia di Drive, la
chiave della risorsa per la 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 la UI di Drive possono anche
utilizzare resourceKeys
all'interno del
parametro state
. Per ulteriori informazioni, vedi Scaricare ed esportare file.
Imposta la chiave della risorsa sulla richiesta
Le chiavi delle risorse per 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
Un ID file e una coppia di chiavi della risorsa vengono impostati nell'intestazione utilizzando una barra
(/
) separatore. L'intestazione viene creata combinando tutte le coppie di ID file e chiavi delle risorse tramite separatori di virgola (,
).
Ad esempio, si considera una richiesta di spostamento del file fileId1
dalla cartella fileId2
alla cartella fileId3
. Supponi 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 dei separatori di virgola è:
X-Goog-Drive-Resource-Keys: fileId1/resourceKey1,fileId2/resourceKey2,fileId3/resourceKey3
Argomenti correlati
- Condividere file, cartelle e Drive
- Scaricare ed esportare file
- Proteggere i contenuti dei file
- Configurare un'integrazione nella UI di Drive