REST Resource: permissions

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,
  "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

string

Solo output. L'ID di questa autorizzazione. Questo è un identificatore univoco per il beneficiario, pubblicato nelle Risorse utente con il nome permissionId. Gli ID devono essere trattati come valori opachi.

displayName

string

Solo output. La "cara" del valore dell'autorizzazione. Di seguito è riportato un elenco di esempi per ciascun tipo di autorizzazione:

  • user - Il nome completo dell'utente, come definito per il suo Account Google, ad esempio "Mario Rossi".
  • group - Nome del gruppo Google, ad esempio "Gli amministratori aziendali".
  • domain - Nome di dominio della stringa, ad esempio "azienda.com".
  • anyone: nessuna displayName presente.
type

string

Il tipo di beneficiario. I valori validi sono:

  • user
  • group
  • domain
  • anyone

Quando crei un'autorizzazione, se type è user o group, devi fornire un emailAddress per l'utente o il gruppo. Se type è domain, devi fornire un domain. Non sono necessarie informazioni aggiuntive per un tipo anyone.

kind

string

Solo output. Identifica di che tipo di risorsa si tratta. Valore: la stringa fissa "drive#permission".

permissionDetails[]

object

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

string

Solo output. Il tipo di autorizzazione per questo utente. In futuro sarà possibile aggiungere nuovi valori, ma al momento è possibile:

  • file
  • member
permissionDetails[].inheritedFrom

string

Solo output. L'ID dell'elemento da cui viene ereditata questa autorizzazione. Questo è un campo di solo output.

permissionDetails[].role

string

Solo output. Il ruolo principale di questo utente. In futuro è possibile aggiungere nuovi valori, ma al momento è possibile:

  • organizer
  • fileOrganizer
  • writer
  • commenter
  • reader
permissionDetails[].inherited

boolean

Solo output. Indica se questa autorizzazione viene ereditata. Questo campo viene sempre compilato. Questo è un campo di solo output.

emailAddress

string

L'indirizzo email dell'utente o del gruppo a cui fa riferimento questa autorizzazione.

role

string

Il ruolo concesso da questa autorizzazione. In futuro potrebbero essere supportati nuovi valori, ma al momento sono consentiti i seguenti valori:

  • owner
  • organizer
  • fileOrganizer
  • writer
  • commenter
  • reader
allowFileDiscovery

boolean

Indica se l'autorizzazione consente il rilevamento del file tramite la ricerca. Si applica solo per le autorizzazioni di tipo domain o anyone.

domain

string

Il dominio a cui si riferisce questa autorizzazione.

expirationTime

string

L'ora in cui scadrà questa autorizzazione (data-ora RFC 3339). Le date di scadenza sono soggette alle seguenti restrizioni:

  • Possono essere impostate solo sulle autorizzazioni utente e gruppo.
  • L'ora deve essere nel futuro.
  • Non può essere più di un anno nel futuro.
teamDrivePermissionDetails[]
(deprecated)

object

Solo output. Deprecato: solo output. Usa invece il criterio permissionDetails.

teamDrivePermissionDetails[]
(deprecated).teamDrivePermissionType
(deprecated)

string

Deprecato: solo output. Usa invece il criterio permissionDetails/permissionType.

teamDrivePermissionDetails[]
(deprecated).inheritedFrom
(deprecated)

string

Deprecato: solo output. Usa invece il criterio permissionDetails/inheritedFrom.

teamDrivePermissionDetails[]
(deprecated).role
(deprecated)

string

Deprecato: solo output. Usa invece il criterio permissionDetails/role.

teamDrivePermissionDetails[]
(deprecated).inherited
(deprecated)

boolean

Deprecato: solo output. Usa invece il criterio permissionDetails/inherited.

deleted

boolean

Solo output. Indica se l'account associato a questa autorizzazione è stato eliminato. Questo campo riguarda solo le autorizzazioni di utenti e gruppi.

view

string

Indica la visualizzazione per questa autorizzazione. Compilato solo per le autorizzazioni che appartengono a una vista. 'pubblicato' è l'unico valore supportato.

pendingOwner

boolean

Indica se l'account associato a questa autorizzazione è un proprietario in sospeso. Compilate solo per le autorizzazioni di tipo user per i file che non si trovano in un Drive condiviso.

Metodi

create

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

delete

Elimina un'autorizzazione.

get

Riceve un'autorizzazione in base all'ID.

list

Elenca le autorizzazioni di un file o di un Drive condiviso.

update

Aggiorna un'autorizzazione con la semantica della patch.