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.

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 
{
  "additionalRoles": [
    string
  ],
  "permissionDetails": [
    {
      "permissionType": string,
      "role": string,
      "additionalRoles": [
        string
      ],
      "inheritedFrom": string,
      "inherited": boolean
    }
  ],
  "teamDrivePermissionDetails": [
    {
      "teamDrivePermissionType": string,
      "role": string,
      "additionalRoles": [
        string
      ],
      "inheritedFrom": string,
      "inherited": boolean
    }
  ],
  "id": string,
  "name": string,
  "type": string,
  "role": string,
  "authKey": string,
  "value": string,
  "kind": string,
  "withLink": boolean,
  "photoLink": string,
  "selfLink": string,
  "emailAddress": string,
  "domain": string,
  "etag": string,
  "expirationDate": string,
  "deleted": boolean,
  "view": string,
  "pendingOwner": boolean,
  "inheritedPermissionsDisabled": boolean
}
Campi
additionalRoles[]

string

Altri ruoli per questo utente. Al momento è consentito solo commenter, anche se in futuro potrebbero essere supportate altre lingue.
permissionDetails[]

object

Solo output. Dettagli su se le autorizzazioni per questo elemento sono ereditate o direttamente su questo elemento.
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[].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
  • reader
permissionDetails[].additionalRoles[]

string

Solo output. Altri ruoli per questo utente. Al momento è possibile utilizzare solo commenter, anche se in futuro potrebbero essere supportate altre lingue.
permissionDetails[].inheritedFrom

string

Solo output. L'ID dell'elemento da cui viene ereditata questa autorizzazione. Questo campo viene compilato solo per gli elementi dei Drive condivisi.
permissionDetails[].inherited

boolean

Solo output. Indica se questa autorizzazione viene ereditata. Questo campo viene sempre compilato.
teamDrivePermissionDetails[]
(deprecated)

object

Solo output. Deprecato: utilizza permissionDetails.
teamDrivePermissionDetails[]
(deprecated).teamDrivePermissionType
(deprecated)

string

Solo output. Deprecato: utilizza permissionDetails/permissionType.
teamDrivePermissionDetails[]
(deprecated).role
(deprecated)

string

Solo output. Deprecato: utilizza permissionDetails/role.
teamDrivePermissionDetails[]
(deprecated).additionalRoles[]
(deprecated)

string

Solo output. Deprecato: utilizza permissionDetails/additionalRoles.
teamDrivePermissionDetails[]
(deprecated).inheritedFrom
(deprecated)

string

Solo output. Deprecato: utilizza permissionDetails/inheritedFrom.
teamDrivePermissionDetails[]
(deprecated).inherited
(deprecated)

boolean

Solo output. Deprecato: utilizza permissionDetails/inherited.
id

string

L'ID dell'utente a cui si riferisce questa autorizzazione e identico a permissionId nelle risorse Informazioni e File. Quando viene effettuata una richiesta drive.permissions.insert, deve essere specificato esattamente uno dei campi id o value, a meno che il tipo di autorizzazione non sia anyone, nel qual caso sia id che value vengono ignorati.
name

string

Solo output. Il nome di questa autorizzazione.
type

string

Il tipo di account. I valori ammessi sono:

  • user
  • group
  • domain
  • anyone
role

string

Il ruolo principale per questo utente. Sebbene in futuro possano essere supportati nuovi valori, al momento sono consentiti i seguenti:

  • owner
  • organizer
  • fileOrganizer
  • writer
  • reader
authKey
(deprecated)

string

Solo output. Deprecato.
value

string

L'indirizzo email o il nome di dominio dell'entità. Viene utilizzato durante gli inserimenti e non viene compilato nelle risposte. Quando viene effettuata una richiesta drive.permissions.insert, deve essere specificato esattamente uno dei campi id o value, a meno che il tipo di autorizzazione non sia anyone, nel qual caso sia id che value vengono ignorati.
kind

string

Solo output. Questo valore è sempre drive#permission.
emailAddress

string

Solo output. L'indirizzo email dell'utente o del gruppo a cui fa riferimento questa autorizzazione. Si tratta di un campo di sola uscita presente quando il tipo di autorizzazione è user o group.
domain

string

Solo output. Il nome di dominio dell'entità a cui fa riferimento questa autorizzazione. Si tratta di un campo di sola uscita presente quando il tipo di autorizzazione è user, group o domain.
etag

string

Solo output. L'ETag dell'autorizzazione.
expirationDate

string

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

  • Possono essere impostate solo sulle autorizzazioni utente e gruppo
  • La data deve essere futura
  • La data non può essere a più di un anno nel futuro
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 vista per questa autorizzazione. Viene compilato solo per le autorizzazioni che appartengono a una visualizzazione.

published

e

metadata

sono gli unici valori supportati.

  • published

    : il ruolo dell'autorizzazione è published_reader.

  • metadata

    : l'elemento è visibile solo alla visualizzazione dei metadati perché ha accesso limitato e l'ambito ha almeno accesso in lettura all'elemento principale. Nota:

    metadata

    Al momento è supportata solo per le cartelle.

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.
inheritedPermissionsDisabled

boolean

Se il valore è true, solo gli organizzatori, i proprietari e gli utenti con autorizzazioni aggiunte direttamente all'elemento possono accedervi.

Metodi

delete

 Consente di eliminare un'autorizzazione da un file o da un Drive condiviso.

get

 Recupera un'autorizzazione tramite ID.

getIdForEmail

 Restituisce l'ID autorizzazione per un indirizzo email.

insert

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

list

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

patch

 Aggiorna un'autorizzazione utilizzando la semantica delle patch.

update

 Aggiorna un'autorizzazione.