Risorsa: autorizzazione
L'autorizzazione per un file. Un'autorizzazione concede a un utente, un gruppo, un dominio o tutto il mondo l'accesso a una gerarchia di file o 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, "name": string, "type": string, "role": string, "additionalRoles": [ string ], "authKey": string, "value": string, "kind": string, "withLink": boolean, "photoLink": string, "selfLink": string, "emailAddress": string, "domain": string, "etag": string, "permissionDetails": [ { "permissionType": string, "role": string, "additionalRoles": [ string ], "inheritedFrom": string, "inherited": boolean } ], "expirationDate": string, "teamDrivePermissionDetails": [ { "teamDrivePermissionType": string, "role": string, "additionalRoles": [ string ], "inheritedFrom": string, "inherited": boolean } ], "deleted": boolean, "view": string, "pendingOwner": boolean } |
Campi | |
---|---|
id |
L'ID dell'utente a cui fa riferimento questa autorizzazione ed è identico al |
name |
Solo output. Il nome di questa autorizzazione. |
type |
Il tipo di account. I valori ammessi sono:
|
role |
Il ruolo principale di questo utente. In futuro potrebbero essere supportati nuovi valori, ma al momento sono consentiti i seguenti valori:
|
additionalRoles[] |
Ruoli aggiuntivi per questo utente. Al momento è consentito solo |
authKey |
Solo output. Deprecato. |
value |
L'indirizzo email o il nome di dominio dell'entità. Viene utilizzato durante l'inserimento e non viene inserito nelle risposte. Quando effettui una richiesta |
kind |
Solo output. Il valore è sempre |
withLink |
Se il link è necessario per questa autorizzazione. |
photoLink |
Solo output. Un link alla foto del profilo, se disponibile. |
selfLink |
Solo output. Un link per tornare a questa autorizzazione. |
emailAddress |
Solo output. L'indirizzo email dell'utente o del gruppo a cui fa riferimento questa autorizzazione. Si tratta di un campo di solo output presente quando il tipo di autorizzazione è |
domain |
Solo output. Il nome di dominio dell'entità a cui fa riferimento questa autorizzazione. Si tratta di un campo di solo output presente quando il tipo di autorizzazione è |
etag |
Solo output. L'ETag dell'autorizzazione. |
permissionDetails[] |
Solo output. Dettagli che indicano se le autorizzazioni su questo elemento del Drive condiviso sono ereditate o direttamente su questo elemento. Si tratta di un campo di solo output presente solo per gli elementi del Drive condiviso. |
permissionDetails[].permissionType |
Solo output. Il tipo di autorizzazione per questo utente. In futuro sarà possibile aggiungere nuovi valori, ma al momento è possibile:
|
permissionDetails[].role |
Solo output. Il ruolo principale di questo utente. In futuro è possibile aggiungere nuovi valori, ma al momento è possibile:
|
permissionDetails[].additionalRoles[] |
Solo output. Ruoli aggiuntivi per questo utente. Al momento è possibile solo |
permissionDetails[].inheritedFrom |
Solo output. L'ID dell'elemento da cui viene ereditata questa autorizzazione. Questo è un campo di solo output. |
permissionDetails[].inherited |
Solo output. Indica se questa autorizzazione viene ereditata. Questo campo viene sempre compilato. Questo è un campo di solo output. |
expirationDate |
L'ora in cui scadrà questa autorizzazione (data-ora RFC 3339). Le date di scadenza sono soggette alle seguenti limitazioni:
|
teamDrivePermissionDetails[] |
Solo output. Deprecato: usa invece |
teamDrivePermissionDetails[] |
Solo output. Deprecato: usa invece |
teamDrivePermissionDetails[] |
Solo output. Deprecato: usa invece |
teamDrivePermissionDetails[] |
Solo output. Deprecato: usa invece |
teamDrivePermissionDetails[] |
Solo output. Deprecato: usa invece |
teamDrivePermissionDetails[] |
Solo output. Deprecato: usa invece |
deleted |
Solo output. Indica se l'account associato a questa autorizzazione è stato eliminato. Questo campo riguarda solo le autorizzazioni di utenti e gruppi. |
view |
Indica la visualizzazione per questa autorizzazione. Compilato solo per le autorizzazioni che appartengono a una vista. |
pendingOwner |
Indica se l'account associato a questa autorizzazione è un proprietario in sospeso. Compilate solo per le autorizzazioni di tipo |
Metodi |
|
---|---|
|
Elimina un'autorizzazione da un file o da un Drive condiviso. |
|
Riceve un'autorizzazione in base all'ID. |
|
Restituisce l'ID autorizzazione per un indirizzo email. |
|
Inserisce un'autorizzazione per un file o un Drive condiviso. |
|
Elenca le autorizzazioni di un file o di un Drive condiviso. |
|
Aggiorna un'autorizzazione utilizzando la semantica della patch. |
|
Aggiorna un'autorizzazione. |