Todos los archivos, las carpetas y las unidades compartidas de Google Drive tienen
permissions. Cada recurso
Identifica el permiso para un type
específico (usuario, grupo, dominio, cualquiera)
y role
, como "comentarista" o "lector". Por ejemplo, un archivo puede tener una
permiso que otorga acceso de solo lectura a un usuario específico (type=user
)
(role=reader
), mientras que otro permiso otorga a los miembros de un grupo específico
(type=group
) la capacidad de agregar comentarios a un archivo (role=commenter
).
Para obtener una lista completa de los roles y las operaciones que permite cada uno, consulta Roles y permisos.
Situaciones para compartir recursos de Drive
Existen cinco tipos diferentes de situaciones de uso compartido:
Para compartir un archivo en Mi unidad, el usuario debe tener
role=writer
orole=owner
.Si el valor booleano
writersCanShare
se configura comoFalse
para el archivo, el usuario debe tenerrole=owner
.Si el usuario con
role=writer
tiene acceso temporal regido por un fecha y hora de vencimiento, no podrá compartir el archivo. Para ver más consulta Establece una fecha de vencimiento para limitar acceso.
Para compartir una carpeta en Mi unidad, el usuario debe tener
role=writer
orole=owner
.Si el valor booleano
writersCanShare
se establece enFalse
para el archivo, el usuario debe tener el elementorole=owner
más permisivo.No se permite el acceso temporal (controlado por una fecha y hora de vencimiento). en carpetas de Mi unidad con
role=writer
. Para ver más información, consulta Establece una fecha de vencimiento para limitar el acceso a los archivos.
Para compartir un archivo en una unidad compartida, el usuario debe tener
role=writer
,role=fileOrganizer
orole=organizer
.- El parámetro de configuración
writersCanShare
no se aplica a los elementos de las unidades compartidas. Se trata como si siempre estuviera configurada enTrue
.
- El parámetro de configuración
Para compartir una carpeta en una unidad compartida, el usuario debe tener
role=organizer
.- Si la restricción
sharingFoldersRequiresOrganizerPermission
en un La unidad compartida se estableció enFalse
, los usuarios conrole=fileOrganizer
pueden compartir carpetas en esa unidad.
- Si la restricción
Para administrar la membresía de las unidades compartidas, el usuario debe tener
role=organizer
. Solo los usuarios y grupos pueden ser miembros de unidades compartidas.
Establece una fecha de vencimiento para limitar el acceso a los archivos
Cuando trabajes con personas en un proyecto delicado, es posible que desees restringir su acceso a ciertos archivos en Drive después de un tiempo. Para los archivos en Mi unidad, puedes establecer una fecha de vencimiento para limitar o quitar el acceso a ese archivo.
Para establecer la fecha de vencimiento, sigue estos pasos:
- Usa la
permissions.create
. y establece lapermissions.expirationTime
(junto con otros campos obligatorios). Para obtener más información, consulta Crea un permiso. - Usa la
permissions.update
. y establece el campopermissions.expirationTime
(junto con las otras campos obligatorios). Para obtener más información, consulta Cambia permisos.
El campo expirationTime
indica cuándo vence el permiso mediante RFC 3339.
fecha-hora
de Google Cloud. Las fechas de vencimiento tienen las siguientes restricciones:
- Solo se pueden configurar en los permisos de usuario y grupo.
- La hora debe ser futura.
- El tiempo no puede ser superior a un año en el futuro.
Para obtener más información sobre la fecha de vencimiento, consulta los siguientes artículos:
- Cómo establecer una fecha de vencimiento para acceder a un archivo
- Agrega una fecha de vencimiento de Google Cloud.
Propagación de permisos
Las listas de permisos de una carpeta se propagan hacia abajo, y todos los archivos secundarios y heredan los permisos del elemento superior. Siempre que los permisos se modifica la jerarquía, la propagación ocurre de manera recursiva a través de todas individuales. Por ejemplo, si un archivo existe en una carpeta y esta se mueve, dentro de otra carpeta, los permisos de la carpeta nueva se propagan al archivo. Si la carpeta nueva otorga al usuario del archivo un nuevo rol, como “escritor”, it anula su rol anterior.
Por el contrario, si un archivo hereda role=writer
de una carpeta y se mueve a
otra carpeta que proporciona un "lector" el archivo ahora hereda
role=reader
No se pueden quitar los permisos heredados de un archivo o una carpeta en una unidad compartida. En cambio, estos permisos deben ajustarse en el publicador superior directo o indirecto de que se heredaron. Los permisos heredados se pueden quitar de los elementos en "Mi unidad" o "Compartidos conmigo".
Por el contrario, los permisos heredados se pueden anular en un archivo o carpeta en Mi
Drive Por lo tanto, si un archivo hereda role=writer
de una
carpeta de Drive, puedes configurar role=reader
en el archivo para que baje la
nivel de permiso.
Funciones
El recurso Permissions no determina en última instancia
Determinan la capacidad del usuario actual de realizar acciones en un archivo o una carpeta.
Un recurso Files contiene una colección de
booleanos capabilities
que se usan para indicar si una acción puede
realizar en un archivo o carpeta. La API de Google Drive establece estos campos según
el recurso de permisos del usuario actual asociado con el archivo o la carpeta.
Por ejemplo, cuando Alex accede a tu app y trata de compartir un archivo, el rol de Alex
esté verificado los permisos en el archivo. Si el rol les permite compartir un archivo,
Se completan los capabilities
relacionados con el archivo, como canShare
.
en relación con el rol. Si Alejandro quiere compartir el archivo, tu app revisa la
capabilities
para asegurarte de que canShare
esté configurado como true
Para ver un ejemplo de cómo recuperar el archivo capabilities
, consulta Verificar usuario
permisos.
Crea un permiso
Los dos campos siguientes son necesarios cuando se crea un permiso:
type
:type
identifica el alcance del permiso (user
,group
,domain
oanyone
). Un permiso contype=user
se aplica a un usuario específico, mientras que un permiso contype=domain
se aplica a todos los usuarios de un dominio específico.role
: El camporole
. identifica las operaciones que puede realizartype
. Por ejemplo, un el permiso contype=user
yrole=reader
otorga a un usuario específico acceso de solo lectura al archivo o a la carpeta. O bien, un permiso contype=domain
yrole=commenter
permite que todos los usuarios del dominio agreguen comentarios a un archivo. Para para obtener una lista completa de los roles y las operaciones que permite cada uno, consulta Roles y permisos.
Cuando creas un permiso en el que type=user
o type=group
, también debes
proporciona un emailAddress
para vincular
el usuario o grupo específico al permiso.
Cuando creas un permiso en el que type=domain
, también debes proporcionar un
domain
para vincular un dominio específico
al permiso.
Para crear un permiso, sigue estos pasos:
- Usa el método
permissions.create
. confileId
para el archivo o la carpeta asociados. - En el cuerpo de la solicitud, especifica
type
yrole
. - Si es
type=user
otype=group
, proporciona unemailAddress
. Si estype=domain
, proporciona undomain
.
Mostrar un ejemplo
En la siguiente muestra de código, se indica cómo crear un permiso. La respuesta muestra una instancia de un recurso Permission
, incluido el permissionId
asignado.
Solicitud
POST https://www.googleapis.com/drive/v3/files/FILE_ID
/permissions
{ "requests": [ { "type": "user", "role": "commenter", "emailAddress": "alex@altostrat.com" } ] }
Respuesta
{
"kind": "drive#permission",
"id": "PERMISSION_ID
",
"type": "user",
"role": "commenter"
}
Usar usuarios objetivo
Los usuarios objetivo son grupos de personas, como departamentos o equipos, que puedes recomendar para que los usuarios compartan sus artículos con ellos. Puedes alentar a los usuarios a compartir con un público más específico o limitado, en lugar de todo para que se adapten a las necesidades de tu organización. Los usuarios objetivo pueden ayudarte a mejorar la seguridad y privacidad de tus datos y facilitar que los usuarios los compartan de manera apropiada. Para ver más consulta Acerca del objetivo públicos de Google Cloud.
Para utilizar los usuarios objetivo, haz lo siguiente:
En la Consola del administrador de Google, ve a Menú > Directorio > Usuarios objetivo.
Para realizar esta tarea, debes acceder con una cuenta que tenga privilegios de administrador avanzado.
En la lista de usuarios objetivo, haz clic en el nombre del público objetivo. Para crear un público objetivo, consulta Crea un público objetivo público
Copia el ID único de la URL del público objetivo:
https://admin.google.com/ac/targetaudiences/ID
.Crea un permiso con
type=domain
y establece el campodomain
enID.audience.googledomains.com
.
Para ver cómo interactúan los usuarios con los usuarios objetivo, consulta Experiencia del usuario para el vínculo uso compartido de Google Cloud.
Recupera todos los permisos de un archivo, una carpeta o una unidad compartida
Usa el método permissions.list
para
Recuperar todos los permisos de un archivo, una carpeta o una unidad compartida
Mostrar un ejemplo
En la siguiente muestra de código, se indica cómo obtener todos los permisos. La respuesta muestra una lista de permisos.
Solicitud
GET https://www.googleapis.com/drive/v3/files/FILE_ID
/permissions
Respuesta
{
"kind": "drive#permissionList",
"permissions": [
{
"id": "PERMISSION_ID
",
"type": "user",
"kind": "drive#permission",
"role": "commenter"
}
]
}
Verifica los permisos del usuario
Cuando tu app abre un archivo, debe verificar las capacidades de este y renderizarse
la IU para reflejar los permisos del usuario actual. Por ejemplo, si el usuario
no tiene una función canComment
en el archivo, la capacidad de comentar
deben inhabilitarse en la IU.
Para obtener más información sobre capabilities
, consulta Funciones.
sección anterior.
Para verificar las capacidades, llama a files.get
con
fileId
y el parámetro fields
establecidos en el campo capabilities
. Para
más información sobre cómo mostrar campos con el parámetro fields
, consulta
Muestra campos específicos para un archivo.
Mostrar un ejemplo
En la siguiente muestra de código, se indica cómo verificar los permisos del usuario. La respuesta muestra una lista de las capacidades que el usuario tiene en el archivo. Cada función corresponde a una acción detallada que un usuario puede realizar. Algunos campos solo se propagan para los elementos de las unidades compartidas.
Solicitud
GET https://www.googleapis.com/drive/v3/files/FILE_ID
?fields=capabilities
Respuesta
{ "capabilities": { "canAcceptOwnership": false, "canAddChildren": false, "canAddMyDriveParent": false, "canChangeCopyRequiresWriterPermission": true, "canChangeSecurityUpdateEnabled": false, "canComment": true, "canCopy": true, "canDelete": true, "canDownload": true, "canEdit": true, "canListChildren": false, "canModifyContent": true, "canModifyContentRestriction": true, "canModifyLabels": true, "canMoveChildrenWithinDrive": false, "canMoveItemOutOfDrive": true, "canMoveItemWithinDrive": true, "canReadLabels": true, "canReadRevisions": true, "canRemoveChildren": false, "canRemoveMyDriveParent": true, "canRename": true, "canShare": true, "canTrash": true, "canUntrash": true } }
Determinar la fuente del rol de los archivos de unidades compartidas y carpetas
Para cambiar el rol en un archivo o carpeta, debes conocer la fuente del rol. En el caso de las unidades compartidas, el origen de un rol puede basarse en la membresía del en la unidad de disco, el rol en una carpeta o el rol en un archivo.
Para determinar la fuente del rol de una unidad compartida o los elementos de esa
Drive, llama a permissions.get
con el
fileId
, permissionId
y el parámetro fields
establecidos en
permissionDetails
. Para encontrar el permissionId
, usa
permissions.list
con el fileId
Para
recupera el campo permissionDetails
en la solicitud permissions.list
, configura la
fields
como permissions/permissionDetails
.
En este campo se enumeran todos los permisos de archivo heredados y directos del usuario, grupo o dominio.
Mostrar un ejemplo
En la siguiente muestra de código, se indica cómo determinar la fuente del rol. La respuesta muestra el permissionDetails
de un recurso Permission
. El campo inheritedFrom
proporciona el ID del elemento del que se hereda el permiso.
Solicitud
GET https://www.googleapis.com/drive/v3/files/FILE_ID
/permissions/PERMISSION_ID
?fields=permissionDetails&supportsAllDrives=true
Respuesta
{
"permissionDetails": [
{
"permissionType": "member",
"role": "commenter",
"inheritedFrom": "INHERITED_FROM_ID
",
"inherited": true
},
{
"permissionType": "file",
"role": "writer",
"inherited": false
}
]
}
Cambiar permisos
Para cambiar los permisos de un archivo o una carpeta, puedes cambiar el rol asignado:
Llama a
permissions.update
con elpermissionId
del permiso para cambiar yfileId
del permiso el archivo, la carpeta o la unidad compartida asociados. Para encontrar elpermissionId
, usapermissions.list
con elfileId
En la solicitud, identifica el
role
nuevo.
Puedes otorgar permisos a archivos individuales o carpetas de una unidad compartida, incluso
si el usuario o el grupo ya es miembro. Por ejemplo, Alejandro tiene role=commenter
como parte de su membresía a una unidad compartida. Sin embargo, tu app puede otorgarle a Alex
role=writer
para un archivo en una unidad compartida. En este caso, como el rol nuevo
es más permisivo que el rol otorgado por la membresía, el nuevo
el permiso se convierte en el rol efectivo del archivo o la carpeta.
Mostrar un ejemplo
En la siguiente muestra de código, se indica cómo cambiar los permisos de un archivo o una carpeta de comentarista a escritor. La respuesta muestra una instancia de un recurso Permission
.
Solicitud
PATCH https://www.googleapis.com/drive/v3/files/FILE_ID
/permissions/PERMISSION_ID
{ "requests": [ { "role": "writer" } ] }
Respuesta
{
"kind": "drive#permission",
"id": "PERMISSION_ID
",
"type": "user",
"role": "writer"
}
Cómo revocar el acceso a un archivo o una carpeta
Para revocar el acceso a un archivo o una carpeta, llama
delete
por el fileId
y el
permissionId
para borrar el permiso.
Para los elementos de “Mi unidad”, es posible borrar una configuración permiso. Eliminar un permiso heredado revoca el acceso al elemento y elementos secundarios, si los hay.
No se pueden revocar los permisos heredados de los elementos de una unidad compartida. Actualizar o revocar el permiso del archivo o la carpeta superior.
La operación delete
también se usa para borrar los permisos que se aplican directamente a un
archivo o carpeta de la unidad compartida.
Mostrar un ejemplo
En la siguiente muestra de código, se indica cómo borrar un permissionId
para revocar el acceso. Si se ejecuta correctamente, el cuerpo de la respuesta está vacío. Para confirmar que se quitó el permiso, usa permissions.list
con fileId
.
Solicitud
DELETE https://www.googleapis.com/drive/v3/files/FILE_ID
/permissions/PERMISSION_ID
Transfiere la propiedad de un archivo a otra cuenta de Google Workspace de la misma organización
Propiedad de los archivos existentes en “Mi unidad” se pueden transferir desde una cuenta de Google Workspace con otra cuenta de la misma organización. Una organización que es propietaria de un Drive es propietario de los archivos que contiene. Por lo tanto, no se admiten las transferencias de propiedad para los archivos y las carpetas de las unidades compartidas. Los organizadores de una unidad compartida pueden moverse los elementos de esa unidad compartida y en su propia unidad de “Mi unidad”. cuál les transfiera la propiedad.
Para transferir la propiedad de un archivo de "Mi unidad", realiza una de las siguientes acciones: lo siguiente:
Crea un archivo de permisos que otorgue un usuario específico. (
type=user
) acceso de propietario (role=owner
).Actualiza el permiso de un archivo existente con
role=owner
y transfiere el archivo la propiedad al usuario especificado (transferOwnership=true
).
Transferir la propiedad de los archivos de una cuenta personal a otra
La propiedad de los archivos se puede transferir de una cuenta personal a otra. Sin embargo, Drive no transfiere la propiedad de un archivo entre dos consumidor cuentas hasta que el nuevo propietario potencial dé su consentimiento explícito para la transferencia. Para realizar la transferencia la propiedad de un archivo de una cuenta personal a otra:
El propietario actual inicia una transferencia de propiedad mediante la creación o actualización el permiso del archivo del posible nuevo propietario. El permiso debe incluir esta configuración:
role=writer
,type=user
ypendingOwner=true
. Si el botón nuevo propietario está creando un permiso para el posible propietario, un correo electrónico se envía una notificación al nuevo propietario potencial para indicar que está a la que se le pide que asuma la propiedad del archivo.El nuevo propietario crea o actualiza la solicitud de transferencia de propiedad para aceptarla el permiso de acceso a los archivos. El permiso debe incluir estos parámetros de configuración:
role=owner
ytransferOwnership=true
. Si el nuevo propietario crea una permiso nuevo, se enviará una notificación por correo electrónico al propietario anterior que indique que se transfirió la propiedad.
Cuando se transfiere un archivo, el rol del propietario anterior cambia a writer
.
Cómo cambiar varios permisos con solicitudes por lotes
Te recomendamos que utilices solicitudes por lotes para modificar varias permisos.
El siguiente es un ejemplo de cómo realizar una modificación de permisos por lotes con un biblioteca cliente.