Risorsa: autorizzazione
L'autorizzazione per un file. Un'autorizzazione concede a un utente, un gruppo, un dominio o un altro utente l'accesso a un file o a una gerarchia di cartelle.
Alcuni metodi delle risorse (come permissions.update
) richiedono un permissionId
. Utilizza il metodo permissions.list
per recuperare l'ID di un file, una cartella o un Drive condiviso.
Rappresentazione JSON |
---|
{ "id": string, "displayName": string, "type": string, "kind": string, "permissionDetails": [ { "permissionType": string, "inheritedFrom": string, "role": string, "inherited": boolean } ], "photoLink": string, "emailAddress": string, "role": string, "allowFileDiscovery": boolean, "domain": string, "expirationTime": string, "teamDrivePermissionDetails": [ { "teamDrivePermissionType": string, "inheritedFrom": string, "role": string, "inherited": boolean } ], "deleted": boolean, "view": string, "pendingOwner": boolean } |
Campi | |
---|---|
id |
Solo output. L'ID di questa autorizzazione. Si tratta di un identificatore univoco del beneficiario e viene pubblicato nelle risorse utente come |
displayName |
Solo output. Il nome "pretty" del valore dell'autorizzazione. Di seguito è riportato un elenco di esempi per ciascun tipo di autorizzazione:
|
type |
Il tipo di beneficiario. I valori validi sono:
Quando crei un'autorizzazione, se |
kind |
Solo output. Identifica il tipo di risorsa. Valore: la stringa fissa |
permissionDetails[] |
Solo output. Dettagli relativi all'ereditarietà delle autorizzazioni per questo elemento del Drive condiviso o direttamente all'elemento stesso. Questo è un campo di solo output presente solo per gli elementi dei Drive condivisi. |
permissionDetails[].permissionType |
Solo output. Il tipo di autorizzazione per l'utente. Al momento è possibile aggiungere nuovi valori, ma al momento è possibile:
|
permissionDetails[].inheritedFrom |
Solo output. L'ID dell'elemento da cui viene ereditata questa autorizzazione. Questo è un campo di solo output. |
permissionDetails[].role |
Solo output. Il ruolo principale di questo utente. Al momento è possibile aggiungere nuovi valori in futuro, ma è possibile:
|
permissionDetails[].inherited |
Solo output. Indica se questa autorizzazione viene ereditata. Questo campo viene sempre compilato. Questo è un campo di solo output. |
photoLink |
Solo output. Un link alla foto del profilo dell'utente, se disponibile. |
emailAddress |
L'indirizzo email dell'utente o del gruppo a cui si riferisce questa autorizzazione. |
role |
Il ruolo concesso da questa autorizzazione. In futuro potrebbero essere supportati nuovi valori, ma al momento è consentito quanto segue:
|
allowFileDiscovery |
Indica se l'autorizzazione consente il rilevamento del file tramite la ricerca. Si applica solo alle autorizzazioni di tipo |
domain |
Il dominio a cui si riferisce questa autorizzazione. |
expirationTime |
L'ora di scadenza dell'autorizzazione (data e ora RFC 3339). I tempi di scadenza sono soggetti alle seguenti limitazioni:
|
teamDrivePermissionDetails[] |
Solo output. Deprecato: solo output. Usa invece il criterio |
teamDrivePermissionDetails[] |
Deprecato: solo output. Usa invece il criterio |
teamDrivePermissionDetails[] |
Deprecato: solo output. Usa invece il criterio |
teamDrivePermissionDetails[] |
Deprecato: solo output. Usa invece il criterio |
teamDrivePermissionDetails[] |
Deprecato: solo output. Usa invece il criterio |
deleted |
Solo output. Indica se l'account associato a questa autorizzazione è stato eliminato. Questo campo riguarda esclusivamente le autorizzazioni utente e gruppo. |
view |
Indica la visualizzazione per questa autorizzazione. Compilato solo per le autorizzazioni che appartengono a una vista. 'pubblicato' è l'unico valore supportato. |
pendingOwner |
Indica se l'account associato a questa autorizzazione è un proprietario in sospeso. Compilato solo per le autorizzazioni di tipo |
Metodi |
|
---|---|
|
Crea un'autorizzazione per un file o un Drive condiviso. |
|
Elimina un'autorizzazione. |
|
Ottieni un'autorizzazione in base all'ID. |
|
Elenca le autorizzazioni di un file o di un Drive condiviso. |
|
Aggiorna un'autorizzazione con la semantica della patch. |