Method: permissions.create

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

Avviso: le operazioni di autorizzazione in parallelo sullo stesso file non sono supportate; viene applicato solo l'ultimo aggiornamento.

Richiesta HTTP

POST https://www.googleapis.com/drive/v3/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 ricerca

Parametri
emailMessage

string

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

boolean

Obsoleto: vedi moveToNewOwnersRoot per i dettagli.
moveToNewOwnersRoot

boolean

Questo parametro avrà effetto solo se l'elemento non si trova in un Drive condiviso e la richiesta tenta di trasferire la proprietà dell'elemento. Se il criterio viene impostato su true, l'elemento verrà spostato nella cartella principale di Il mio Drive del nuovo proprietario e verranno rimossi tutti gli elementi principali precedenti. Se viene impostato su false, i genitori non vengono modificati.
sendNotificationEmail

boolean

Indica se inviare un'email di notifica durante la condivisione con utenti o gruppi. Il valore predefinito è true per utenti e gruppi e non è consentito per altre richieste. Non deve essere disattivato per i trasferimenti di proprietà.
supportsAllDrives

boolean

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

boolean

Obsoleto: utilizza supportsAllDrives.
transferOwnership

boolean

Se trasferire la proprietà all'utente specificato ed eseguire il downgrade del proprietario corrente a un autore. Questo parametro è obbligatorio per confermare l'effetto collaterale.
useDomainAdminAccess

boolean

Invia la richiesta in qualità di amministratore di dominio. Se il criterio è impostato su true, al richiedente verrà concesso l'accesso se il parametro ID file si riferisce a un Drive condiviso e il richiedente è un amministratore del dominio a cui appartiene il Drive condiviso.

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/drive
  • https://www.googleapis.com/auth/drive.file

Alcuni ambiti sono limitati e richiedono una valutazione di sicurezza affinché l'app li utilizzi. Per ulteriori informazioni, consulta la Guida alle autorizzazioni.