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 |
Solo salida. El ID de este permiso. Este es un identificador único para el beneficiario y se publica en Recursos de usuario como |
displayName |
Solo salida. El nombre "bonito" del valor del permiso. La siguiente es una lista de ejemplos para cada tipo de permiso:
|
type |
Es el tipo de beneficiario. Estos son los valores válidos:
Cuando se crea un permiso, si |
kind |
Solo salida. Identifica qué tipo de recurso es este. Valor: la cadena fija |
permissionDetails[] |
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 |
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:
|
permissionDetails[].inheritedFrom |
Solo salida. El ID del elemento desde el que se hereda este permiso. Este es un campo de solo resultados. |
permissionDetails[].role |
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:
|
permissionDetails[].inherited |
Solo salida. Indica si este permiso es heredado. Este campo siempre se propaga. Este es un campo de solo resultados. |
photoLink |
Solo salida. Es un vínculo a la foto de perfil del usuario, si está disponible. |
emailAddress |
La dirección de correo electrónico del usuario o grupo al que hace referencia este permiso. |
role |
El rol que otorga este permiso. Si bien es posible que en el futuro se admitan valores nuevos, actualmente se permiten los siguientes valores:
|
allowFileDiscovery |
Indica si el permiso permite que el archivo se descubra mediante la búsqueda. Esto solo se aplica a permisos de tipo |
domain |
Indica el dominio al que hace referencia este permiso. |
expirationTime |
El momento en el que vencerá este permiso (fecha y hora de RFC 3339). Las fechas de vencimiento tienen las siguientes restricciones:
|
teamDrivePermissionDetails[] |
Solo salida. Obsoleto: solo salida. Usa |
teamDrivePermissionDetails[] |
Obsoleto: solo salida. Usa |
teamDrivePermissionDetails[] |
Obsoleto: solo salida. Usa |
teamDrivePermissionDetails[] |
Obsoleto: solo salida. Usa |
teamDrivePermissionDetails[] |
Obsoleto: solo salida. Usa |
deleted |
Solo salida. Indica si se borró la cuenta asociada con este permiso. Este campo solo corresponde a los permisos de usuario y grupo. |
view |
Indica la vista para este permiso. Solo se propaga para los permisos que pertenecen a una vista. 'publicado' es el único valor admitido. |
pendingOwner |
Si la cuenta asociada con este permiso es un propietario pendiente. Solo se propaga para los permisos de tipo |
Métodos |
|
---|---|
|
Crea un permiso para un archivo o una unidad compartida. |
|
Borra un permiso. |
|
Obtiene un permiso por ID. |
|
Muestra una lista con los permisos de un archivo o una unidad compartida. |
|
Actualiza un permiso con semántica de parches. |