REST Resource: permissions

Recurso: Permiso

Es un permiso para un archivo. Un permiso otorga a un usuario, grupo, dominio o a todos acceso a un archivo o a 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 un viaje compartido.

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,
  "inheritedPermissionsDisabled": boolean
}
Campos
id

string

Es el ID del usuario al que se refiere este permiso y es idéntico al permissionId de 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 ignoran 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 valores nuevos en el futuro, actualmente se permiten los siguientes:

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

string

Roles adicionales para este usuario. Actualmente, solo se permite 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 ignoran id y value.
kind

string

Solo salida. Siempre es drive#permission.
emailAddress

string

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

string

Solo salida. Es 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 sobre si los permisos de este elemento se heredan o se aplican directamente a él.
permissionDetails[].permissionType

string

Solo salida. Es el tipo de permiso de este usuario. Si bien es posible que se agreguen valores nuevos en el futuro, actualmente se pueden usar los siguientes:

  • 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, actualmente se pueden usar los siguientes:

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

string

Solo salida. Roles adicionales para este usuario. Actualmente, 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. Solo se propaga para los elementos de las unidades compartidas.
permissionDetails[].inherited

boolean

Solo salida. Indica si este permiso se hereda. Este campo siempre se propaga.
expirationDate

string

La hora a la que vencerá 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 futura
  • La fecha no puede ser superior a un año en el futuro.
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. Indica si se borró la cuenta asociada con este permiso. Este campo solo se refiere a los permisos de los usuarios y los grupos.
view

string

Indica la vista de este permiso. Solo se completa para los permisos que pertenecen a una vista.

published

y

metadata

son los únicos valores admitidos.

  • published

    : El rol del permiso es publicador.

  • metadata

    : El elemento solo es visible para la vista de metadatos porque tiene acceso limitado y el alcance tiene al menos acceso de lectura al elemento superior. Nota:

    metadata

    Actualmente, solo se admite la vista de cuadrícula en las carpetas.

pendingOwner

boolean

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

boolean

Cuando es verdadero, solo los organizadores, los propietarios y los usuarios con permisos agregados directamente en el elemento pueden acceder a él.

Métodos

delete

 Borra un permiso de un archivo o una unidad compartida.

get

 Obtiene un permiso por ID.

getIdForEmail

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

insert

 Inserta un permiso para un archivo o una unidad compartida.

list

 Muestra una lista de los permisos de un archivo o una unidad compartida.

patch

 Actualiza un permiso con semántica de parche.

update

 Actualiza un permiso.