REST Resource: permissions

Risorsa: autorizzazione

Un'autorizzazione per un file. Un'autorizzazione concede a un utente, a un gruppo, a un dominio o a tutti l'accesso a un file o a una gerarchia di cartelle.

Per impostazione predefinita, le richieste di autorizzazione restituiscono solo un sottoinsieme di campi. Vengono sempre restituiti il tipo di autorizzazione, l'ID, il tipo e il ruolo. Per recuperare campi specifici, consulta la pagina https://developers.google.com/drive/api/guides/fields-parameter.

Alcuni metodi delle risorse (ad esempio permissions.update) richiedono un permissionId. Utilizza il metodo permissions.list per recuperare l'ID di un file, di una cartella o di 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. Si tratta di un identificatore univoco per il beneficiario e viene pubblicato nelle Risorse utente come permissionId. Gli ID devono essere considerati valori opachi.
displayName

string

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

  • user: nome completo dell'utente, come definito per il suo Account Google, ad esempio "Mario Rossi".
  • group: il nome del gruppo Google, ad esempio "Amministratori dell'azienda".
  • domain: nome di dominio della stringa, ad esempio "lacompagnia.com".
  • anyone: non è presente displayName.
type

string

Il tipo di concessore. 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. Quando type è domain, devi fornire un domain. Non sono necessarie informazioni aggiuntive per un tipo anyone.
kind

string

Solo output. Identifica il tipo di risorsa. Valore: la stringa fissa "drive#permission".
permissionDetails[]

object

Solo output. Dettagli su se le autorizzazioni per questo elemento del Drive condiviso sono ereditate o direttamente su questo elemento. Si tratta di un campo di sola uscita presente solo per gli elementi di Drive condivisi.
permissionDetails[].permissionType

string

Solo output. Il tipo di autorizzazione per questo utente. Sebbene in futuro possano essere aggiunti nuovi valori, al momento sono possibili i seguenti:

  • file
  • member
permissionDetails[].inheritedFrom

string

Solo output. L'ID dell'elemento da cui viene ereditata questa autorizzazione. Questo è un campo di sola uscita.
permissionDetails[].role

string

Solo output. Il ruolo principale per questo utente. Sebbene in futuro possano essere aggiunti nuovi valori, al momento sono possibili i seguenti:

  • 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 sola uscita.
emailAddress

string

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

string

Il ruolo concesso da questa autorizzazione. Sebbene in futuro possano essere supportati nuovi valori, al momento sono consentiti i seguenti:

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

boolean

Indica se l'autorizzazione consente di trovare il file tramite la ricerca. Questo vale solo per le autorizzazioni di tipo domain o anyone.
domain

string

Il dominio a cui fa riferimento questa autorizzazione.
expirationTime

string

L'ora in cui questa autorizzazione scadrà (data e ora RFC 3339). I tempi di scadenza presentano le seguenti limitazioni:

  • Possono essere impostati solo sulle autorizzazioni utente e gruppo.
  • L'ora deve essere futura.
  • L'ora non può essere successiva a quella corrente di più di un anno.
teamDrivePermissionDetails[]
(deprecated)

object

Solo output. Non più supportato: solo output. Utilizza invece permissionDetails.
teamDrivePermissionDetails[]
(deprecated).teamDrivePermissionType
(deprecated)

string

Non più supportato: solo output. Utilizza invece permissionDetails/permissionType.
teamDrivePermissionDetails[]
(deprecated).inheritedFrom
(deprecated)

string

Non più supportato: solo output. Utilizza invece permissionDetails/inheritedFrom.
teamDrivePermissionDetails[]
(deprecated).role
(deprecated)

string

Ritiro: solo output. Utilizza invece permissionDetails/role.
teamDrivePermissionDetails[]
(deprecated).inherited
(deprecated)

boolean

Ritiro: solo output. Utilizza invece permissionDetails/inherited.
deleted

boolean

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

string

Indica la visualizzazione per questa autorizzazione. Viene compilato solo per le autorizzazioni che appartengono a una visualizzazione. "published" è l'unico valore supportato.
pendingOwner

boolean

Indica se l'account associato a questa autorizzazione è un proprietario in attesa. Viene compilato 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

 Consente di eliminare un'autorizzazione.

get

 Recupera un'autorizzazione tramite ID.

list

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

update

 Aggiorna un'autorizzazione con la semantica della patch.