REST Resource: permissions

Recurso: Permiso

Un permiso para un archivo. Un permiso concede a un usuario, grupo, dominio o al mundo acceso 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,
  "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
}
Campos
id

string

Solo salida. El ID de este permiso. Este es un identificador único para el beneficiario y se publica en Recursos de usuario como permissionId. Los IDs se deben tratar como valores opacos.

displayName

string

Solo salida. El nombre "bonito" del valor del permiso. La siguiente es una lista de ejemplos para cada tipo de permiso:

  • user: Es el nombre completo del usuario, según se define para su Cuenta de Google; por ejemplo, "Juan Pérez".
  • group: Es el nombre del Grupo de Google, como "Los administradores de la empresa".
  • domain: Es el nombre de dominio de la cadena, como "laempresa.com".
  • anyone: No hay displayName.
type

string

Es el tipo de beneficiario. Estos son los valores válidos:

  • user
  • group
  • domain
  • anyone

Cuando se crea un permiso, si type es user o group, debes proporcionar un emailAddress para el usuario o grupo. Cuando type es domain, debes proporcionar un domain. No se requiere información adicional para un tipo anyone.

kind

string

Solo salida. Identifica qué tipo de recurso es este. Valor: la cadena fija "drive#permission".

permissionDetails[]

object

Solo salida. Detalles sobre si los permisos de este elemento de la unidad compartida son heredados o directamente en este elemento. Este es un campo de solo salida que está presente únicamente para los elementos de las unidades compartidas.

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, en este momento sucede lo siguiente:

  • file
  • member
permissionDetails[].inheritedFrom

string

Solo salida. El ID del elemento desde el que se hereda este permiso. Este es un campo de solo resultados.

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 es posible hacer lo siguiente:

  • organizer
  • fileOrganizer
  • writer
  • commenter
  • reader
permissionDetails[].inherited

boolean

Solo salida. Indica si este permiso es heredado. Este campo siempre se propaga. Este es un campo de solo resultados.

emailAddress

string

La dirección de correo electrónico del usuario o grupo al que hace referencia este permiso.

role

string

El rol que otorga este permiso. Si bien es posible que en el futuro se admitan valores nuevos, actualmente se permiten los siguientes valores:

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

boolean

Indica si el permiso permite que el archivo se descubra mediante la búsqueda. Esto solo se aplica a permisos de tipo domain o anyone.

domain

string

Indica el dominio al que hace referencia este permiso.

expirationTime

string

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

  • Solo se pueden configurar en los permisos de usuario y grupo.
  • La hora debe ser futura.
  • La fecha no puede ser superior a un año a partir de la fecha actual.
teamDrivePermissionDetails[]
(deprecated)

object

Solo salida. Obsoleto: solo salida. Usa permissionDetails en su lugar.

teamDrivePermissionDetails[]
(deprecated).teamDrivePermissionType
(deprecated)

string

Obsoleto: solo salida. Usa permissionDetails/permissionType en su lugar.

teamDrivePermissionDetails[]
(deprecated).inheritedFrom
(deprecated)

string

Obsoleto: solo salida. Usa permissionDetails/inheritedFrom en su lugar.

teamDrivePermissionDetails[]
(deprecated).role
(deprecated)

string

Obsoleto: solo salida. Usa permissionDetails/role en su lugar.

teamDrivePermissionDetails[]
(deprecated).inherited
(deprecated)

boolean

Obsoleto: solo salida. Usa permissionDetails/inherited en su lugar.

deleted

boolean

Solo salida. Indica si se borró la cuenta asociada con este permiso. Este campo solo corresponde a los permisos de usuario y grupo.

view

string

Indica la vista para este permiso. Solo se propaga para los permisos que pertenecen a una vista. 'publicado' es el único valor admitido.

pendingOwner

boolean

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

Métodos

create

Crea un permiso para un archivo o una unidad compartida.

delete

Borra un permiso.

get

Obtiene un permiso por ID.

list

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

update

Actualiza un permiso con semántica de parches.