Method: permissions.create

Crea un'autorizzazione per un file o un Drive condiviso. Per ulteriori informazioni, vedi Condividere file, cartelle e unità.

Avviso:le operazioni simultanee sulle autorizzazioni per lo 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 query

Parametri
emailMessage

string

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

boolean

Ritirato: per maggiori dettagli, vedi moveToNewOwnersRoot.
moveToNewOwnersRoot

boolean

Questo parametro ha effetto 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 viene spostato nella cartella radice di Il mio Drive del nuovo proprietario e tutti i genitori precedenti vengono rimossi. Se è impostato su false, i genitori non vengono modificati.
sendNotificationEmail

boolean

Se inviare un'email di notifica quando la condivisione viene eseguita con utenti o gruppi. Il valore predefinito è true per utenti e gruppi e non è consentito per altre richieste. Non deve essere disattivata per i trasferimenti di proprietà.
supportsAllDrives

boolean

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

boolean

Deprecato: utilizza supportsAllDrives.
transferOwnership

boolean

Se trasferire la proprietà all'utente specificato ed eseguire il downgrade del proprietario attuale a autore. Questo parametro è obbligatorio come conferma dell'effetto collaterale. Per saperne di più, consulta Trasferire la proprietà dei file.
useDomainAdminAccess

boolean

Invia la richiesta come amministratore di dominio.

Se è impostato su true e se sono soddisfatte le seguenti condizioni aggiuntive, al richiedente viene concesso l'accesso:

  1. Il parametro ID file fa riferimento a un Drive condiviso.
  2. Il richiedente è un amministratore del dominio a cui appartiene il Drive condiviso.

Per saperne di più, vedi Gestire i Drive condivisi come amministratori di dominio.
enforceExpansiveAccess
(deprecated)

boolean

Ritirato: tutte le richieste utilizzano le regole di accesso estese.

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 soggetti a limitazioni e richiedono una valutazione della sicurezza per poter essere utilizzati dalla tua app. Per ulteriori informazioni, consulta la Guida all'autorizzazione.