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

Puoi condividere file e cartelle di Google Drive con altre persone utilizzando lo UI di Drive o tramite la 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. Chiavi delle risorse sono un parametro aggiuntivo che viene passato in modo che gli utenti possano accedere a determinati file che sono stati condivisi tramite link. Utenti che non hanno mai visualizzato il file deve fornire la chiave della risorsa per ottenere l'accesso. Gli utenti che di recente hanno visualizzato o avere accesso diretto, non necessitano della chiave della risorsa per accedere al file.

Un file di Drive condiviso con un link può essere rilevato solo da utenti che possono accedere al file come risultato di un errore type=user o type=group permissions. Richieste degli utenti che hanno accesso solo a questi file condivisi tramite link utilizzando un type=domain o L'autorizzazione type=anyone potrebbe 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 autorizzati da ciascuno, consulta Ruoli e autorizzazioni.

Leggi la chiave della risorsa dal file

L'API Drive restituisce la chiave risorsa di un file nell'interfaccia Campo resourceKey della risorsa files.

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

I campi della risorsa files che restituiscono URL. come exportLinks, webContentLink e webViewLink, includono anche i resourceKey. I client che si integrano con la UI di Drive possono inoltre usa resourceKeys in state . Per ulteriori informazioni, vedi Scaricare ed esportare file.

Imposta la chiave della risorsa sulla richiesta

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 sono impostati nell'intestazione utilizzando una barra Separatore (/). L'intestazione viene creata combinando tutti gli ID file e le risorse coppie di chiavi utilizzando una virgola (,) come separatore.

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

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