REST Resource: permissions

Recurso: Permission

Es un permiso para un archivo. Un permiso otorga a un usuario, grupo, dominio o acceso global a un archivo o una jerarquía de carpetas.

Algunos métodos de recursos (como permissions.update) requieren un permissionId. Usa el método permissions.list para recuperar el ID de un archivo, una carpeta o una unidad compartida.

Representación 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
}
Campos
id

string

Es el ID del usuario al que hace referencia este permiso. Es idéntico al permissionId en los recursos Acerca de y Archivos. Cuando se realiza una solicitud drive.permissions.insert, se debe especificar exactamente uno de los campos id o value, a menos que el tipo de permiso sea anyone, en cuyo caso se ignorarán id y value.
name

string

Solo salida. Es el nombre de este permiso.
type

string

El tipo de cuenta. Los valores permitidos son los siguientes:

  • user
  • group
  • domain
  • anyone
role

string

Es el rol principal de este usuario. Si bien es posible que se admitan nuevos valores en el futuro, por el momento, se permite lo siguiente:

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

string

Roles adicionales para este usuario. Por el momento, solo se permite el uso de commenter, aunque es posible que se admitan más en el futuro.
authKey
(deprecated)

string

Solo salida. Obsoleta.
value

string

Es la dirección de correo electrónico o el nombre de dominio de la entidad. Se usa durante las inserciones y no se propaga en las respuestas. Cuando se realiza una solicitud drive.permissions.insert, se debe especificar exactamente uno de los campos id o value, a menos que el tipo de permiso sea anyone, en cuyo caso se ignorarán id y value.
kind

string

Solo salida. Siempre es drive#permission.
emailAddress

string

Solo salida. La dirección de correo electrónico del usuario o grupo al que hace referencia este permiso. Este es un campo de solo salida que está presente cuando el tipo de permiso es user o group.
domain

string

Solo salida. El nombre de dominio de la entidad a la que hace referencia este permiso. Este es un campo de solo salida que está presente cuando el tipo de permiso es user, group o domain.
etag

string

Solo salida. La ETag del permiso.
permissionDetails[]

object

Solo salida. Detalles que indican si los permisos de este elemento de unidad compartida se heredan o directamente en este elemento. Este campo es de solo salida y está presente únicamente para los elementos de unidades compartidas.
permissionDetails[].permissionType

string

Solo salida. Es el tipo de permiso para este usuario. Si bien es posible que se agreguen valores nuevos en el futuro, por el momento, es posible hacer lo siguiente:

  • file
  • member
permissionDetails[].role

string

Solo salida. Es el rol principal de este usuario. Si bien es posible que se agreguen valores nuevos en el futuro, por el momento, es posible hacer lo siguiente:

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

string

Solo salida. Roles adicionales para este usuario. Por el momento, solo es posible usar commenter, aunque es posible que se admitan más en el futuro.
permissionDetails[].inheritedFrom

string

Solo salida. Es el ID del elemento del que se hereda este permiso. Este es un campo de solo salida.
permissionDetails[].inherited

boolean

Solo salida. Si este permiso se hereda o no. Este campo siempre está propagado. Este es un campo de solo salida.
expirationDate

string

El momento en que caducará este permiso (fecha y hora RFC 3339). Las fechas de vencimiento tienen las siguientes restricciones:

  • Solo se pueden configurar en los permisos de usuarios y grupos.
  • La fecha debe ser posterior a la actual
  • La fecha no puede ser más de un año después de la fecha actual
teamDrivePermissionDetails[]
(deprecated)

object

Solo salida. Obsoleto: Usa permissionDetails en su lugar.
teamDrivePermissionDetails[]
(deprecated).teamDrivePermissionType
(deprecated)

string

Solo salida. Obsoleto: Usa permissionDetails/permissionType en su lugar.
teamDrivePermissionDetails[]
(deprecated).role
(deprecated)

string

Solo salida. Obsoleto: Usa permissionDetails/role en su lugar.
teamDrivePermissionDetails[]
(deprecated).additionalRoles[]
(deprecated)

string

Solo salida. Obsoleto: Usa permissionDetails/additionalRoles en su lugar.
teamDrivePermissionDetails[]
(deprecated).inheritedFrom
(deprecated)

string

Solo salida. Obsoleto: Usa permissionDetails/inheritedFrom en su lugar.
teamDrivePermissionDetails[]
(deprecated).inherited
(deprecated)

boolean

Solo salida. Obsoleto: Usa permissionDetails/inherited en su lugar.
deleted

boolean

Solo salida. Si se borró la cuenta asociada con este permiso Este campo solo corresponde a los permisos de usuarios y grupos.
view

string

Indica la vista de este permiso. Solo se completa para los permisos que pertenecen a una vista. published es el único valor admitido.
pendingOwner

boolean

Indica si la cuenta asociada con este permiso es de propietario pendiente. Solo se completa para los permisos de tipo user para los archivos que no están en una unidad compartida.

Métodos

delete

 Borra un permiso de un archivo o una unidad compartida.

get

 Obtiene un permiso por ID.

getIdForEmail

 Muestra el ID de permiso de una dirección de correo electrónico.

insert

 Inserta un permiso para un archivo o una unidad compartida.

list

 Enumera los permisos de un archivo o una unidad compartida.

patch

 Actualiza un permiso con la semántica de parches.

update

 Actualiza un permiso.