REST Resource: permissions

Recurso: Permission

Un permiso para un archivo Un permiso le otorga a un usuario, grupo, dominio o el mundo acceso a un archivo o a una jerarquía de carpetas.

Algunos métodos de recursos (como permissions.update) requieren una 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. Es el ID de este permiso. Este es un identificador único del beneficiario y se publica en Recursos del usuario como permissionId. Los ID 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, como se define en su Cuenta de Google (por ejemplo, "Juan Pérez").
  • group: Es el nombre del grupo de Google, como "Administradores de la empresa".
  • domain: Es el nombre de dominio de la string, como "thecompany.com".
  • anyone: No hay displayName presentes.
type

string

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

  • user
  • group
  • domain
  • anyone

Cuando creas 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 string fija "drive#permission".
permissionDetails[]

object

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

string

Solo salida. El tipo de permiso para este usuario. Si bien se pueden agregar valores nuevos en el futuro, es posible realizar lo siguiente:

  • file
  • member
permissionDetails[].inheritedFrom

string

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

string

Solo salida. El rol principal de este usuario. Si bien es posible que se agreguen valores nuevos en el futuro, es posible realizar 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 salida.
emailAddress

string

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

string

La función otorgada por este permiso. Si bien es posible que se admitan valores nuevos en el futuro, se permite lo siguiente:

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

boolean

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

string

El dominio al que hace referencia este permiso.
expirationTime

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 permisos de usuarios y grupos.
  • La hora debe ser futura.
  • La hora no puede ser posterior a un año.
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 a este permiso. Este campo solo corresponde a los permisos de usuarios y grupos.
view

string

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

boolean

Indica si la cuenta asociada a este permiso es un propietario pendiente. Solo se propaga para los permisos de tipo user en 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

 Enumera los permisos de un archivo o una unidad compartida.

update

 Actualiza un permiso con semántica de parches.