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,
  "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 y 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. 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 en el futuro se admitan valores nuevos, actualmente se permiten los siguientes valores:

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

string

Roles adicionales para este usuario. Por el momento, solo se permiten commenter, aunque es posible que se admitan más en el futuro.

authKey
(deprecated)

string

Solo salida. Ya no está disponible.

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. 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 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[].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
  • 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. El ID del elemento desde el que se hereda este permiso. Este es un campo de solo resultados.

permissionDetails[].inherited

boolean

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

expirationDate

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 fecha debe ser posterior a la fecha actual
  • La fecha no puede ser posterior a un año
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 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. published 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

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

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

patch

Actualiza un permiso mediante la semántica de parches.

update

Actualiza un permiso.