Method: permissions.insert

Inserisce un'autorizzazione per un file o un Drive condiviso.

Attenzione:le operazioni di assegnazione delle autorizzazioni simultanee sullo stesso file non sono supportate; viene applicato solo l'ultimo aggiornamento.

Richiesta HTTP

POST https://www.googleapis.com/drive/v2/files/{fileId}/permissions

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
fileId

string

L'ID del file o del Drive condiviso.

Parametri di query

Parametri
emailMessage

string

Un messaggio personalizzato in testo normale da includere nelle email di notifica.
enforceSingleParent
(deprecated)

boolean

Ritiro: per maggiori dettagli, visita la pagina moveToNewOwnersRoot.
moveToNewOwnersRoot

boolean

Questo parametro viene applicato solo se l'elemento non si trova in un Drive condiviso e la richiesta tenta di trasferirne la proprietà. Se impostato su true, l'elemento verrà spostato nella cartella principale di Il mio Drive del nuovo proprietario e tutte le cartelle principali precedenti verranno rimosse. Se impostato su false, i gruppi di base non vengono modificati.
sendNotificationEmails

boolean

Indica se inviare email di notifica quando la condivisione avviene con utenti o gruppi. Questo parametro viene ignorato e viene inviata un'email se role è owner.
supportsAllDrives

boolean

Indica se l'applicazione richiedente supporta sia Il mio Drive sia i Drive condivisi.
supportsTeamDrives
(deprecated)

boolean

Deprecato: utilizza supportsAllDrives.
useDomainAdminAccess

boolean

Invia la richiesta come amministratore di dominio. Se impostata su true, al richiedente verrà concesso l'accesso se il parametro ID file fa riferimento a un Drive condiviso e il richiedente è un amministratore del dominio a cui appartiene il Drive condiviso.
enforceExpansiveAccess

boolean

Indica se la richiesta deve applicare regole di accesso espansive.

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di Permission.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Permission appena creata.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/docs
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file

Alcuni ambiti sono soggetti a restrizioni e richiedono una valutazione di sicurezza per poter essere utilizzati dalla tua app. Per ulteriori informazioni, consulta la Guida all'autorizzazione.