REST Resource: permissions

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

string

L'ID dell'utente a cui fa riferimento questa autorizzazione è identico a permissionId nelle risorse Informazioni e File. Quando si effettua una richiesta drive.permissions.insert, è necessario specificare esattamente uno dei campi id o value, a meno che il tipo di autorizzazione non sia anyone. In questo caso, id e 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 di questo utente. In futuro potrebbero essere supportati nuovi valori, ma al momento è consentito quanto segue:

  • owner
  • organizer
  • fileOrganizer
  • writer
  • reader
additionalRoles[]

string

Ruoli aggiuntivi per questo utente. Al momento è consentito solo commenter, anche se in futuro potrebbero essere supportati altri tipi.

authKey
(deprecated)

string

Solo output. Deprecato.

value

string

L'indirizzo email o il nome di dominio dell'entità. Questo viene utilizzato durante gli inserti e non viene inserito nelle risposte. Quando si effettua una richiesta drive.permissions.insert, è necessario specificare esattamente uno dei campi id o value, a meno che il tipo di autorizzazione non sia anyone. In questo caso, id e value vengono ignorati.

kind

string

Solo output. È 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 solo output 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 solo output presente quando il tipo di autorizzazione è user, group o domain.

etag

string

Solo output. L'ETag dell'autorizzazione.

permissionDetails[]

object

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

string

Solo output. Il tipo di autorizzazione per l'utente. Al momento è possibile aggiungere nuovi valori, ma al momento è possibile:

  • file
  • member
permissionDetails[].role

string

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

  • organizer
  • fileOrganizer
  • writer
  • reader
permissionDetails[].additionalRoles[]

string

Solo output. Ruoli aggiuntivi per questo utente. Al momento è possibile solo commenter, anche se in futuro potrebbero essere supportati altri tipi.

permissionDetails[].inheritedFrom

string

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

permissionDetails[].inherited

boolean

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

expirationDate

string

L'ora di scadenza dell'autorizzazione (data e ora RFC 3339). Le date di scadenza hanno le seguenti limitazioni:

  • Possono essere impostate solo in base alle autorizzazioni per utenti e gruppi
  • La data deve essere una data futura
  • La data non può essere più di un anno nel futuro
teamDrivePermissionDetails[]
(deprecated)

object

Solo output. Obsoleto: utilizza permissionDetails.

teamDrivePermissionDetails[]
(deprecated).teamDrivePermissionType
(deprecated)

string

Solo output. Obsoleto: utilizza permissionDetails/permissionType.

teamDrivePermissionDetails[]
(deprecated).role
(deprecated)

string

Solo output. Obsoleto: utilizza permissionDetails/role.

teamDrivePermissionDetails[]
(deprecated).additionalRoles[]
(deprecated)

string

Solo output. Obsoleto: utilizza permissionDetails/additionalRoles.

teamDrivePermissionDetails[]
(deprecated).inheritedFrom
(deprecated)

string

Solo output. Obsoleto: utilizza permissionDetails/inheritedFrom.

teamDrivePermissionDetails[]
(deprecated).inherited
(deprecated)

boolean

Solo output. Obsoleto: utilizza permissionDetails/inherited.

deleted

boolean

Solo output. Indica se l'account associato a questa autorizzazione è stato eliminato. Questo campo riguarda esclusivamente le autorizzazioni utente e gruppo.

view

string

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

pendingOwner

boolean

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

Metodi

delete

Elimina un'autorizzazione da un file o da un Drive condiviso.

get

Ottieni un'autorizzazione in base all'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 della patch.

update

Aggiorna un'autorizzazione.