Puedes compartir archivos y carpetas de Google Drive con otras personas mediante la IU de Drive o la API de Google Drive. Cuando compartes desde Drive, puedes controlar si las personas pueden editar, comentar o solo abrir el archivo.
Una clave de recurso ayuda a proteger tu archivo de accesos no deseados. Las claves de recursos son un parámetro adicional que se pasa para que los usuarios puedan acceder a ciertos archivos que se compartieron mediante un vínculo. Los usuarios que no vieron el archivo antes deben proporcionar la clave de recurso para obtener acceso. Quienes hayan visto el archivo recientemente o tengan acceso directo no necesitan la clave de recursos para acceder al archivo.
Un archivo de Drive que se comparte con un vínculo solo puede ser descubierto por los usuarios que puedan acceder a él como resultado de un recurso type=user
o type=group
permissions
. Las solicitudes de usuarios que solo tienen acceso a estos archivos compartidos por vínculos con un permiso type=domain
o type=anyone
pueden requerir una clave de recurso.
Para obtener más información sobre los permisos, consulta Comparte archivos, carpetas y unidades. Para obtener una lista completa de las funciones y las operaciones que permite cada una, consulta Funciones y permisos.
Lee la clave de recurso del archivo
La API de Drive muestra la clave de recurso de un archivo en el campo de solo lectura resourceKey
del recurso files
.
Si el archivo es un acceso directo de Drive, la clave de recurso para el destino del acceso directo se muestra en el campo de solo lectura shortcutDetails.targetResourceKey
.
Los campos del recurso files
que muestran URLs, como exportLinks
, webContentLink
y webViewLink
, también incluyen resourceKey
. Los clientes que se integran con la IU de Drive también pueden usar resourceKeys
dentro del parámetro state
. Para obtener más información, consulta Descarga y exporta archivos.
Configura la clave de recurso en la solicitud
Las claves de recursos de los archivos a los que hacen referencia las solicitudes a la API de Drive se configuran en el encabezado HTTP X-Goog-Drive-Resource-Keys
.
Las solicitudes a la API de Drive pueden especificar una o más claves de recursos con el encabezado HTTP X-Goog-Drive-Resource-Keys
.
Sintaxis
Se establece un ID de archivo y un par de claves de recurso en el encabezado mediante un separador de barra diagonal (/
). El encabezado se crea mediante la combinación de todos los ID de archivo y pares de claves de recursos con separadores de coma (,
).
Por ejemplo, considera una solicitud para mover el archivo fileId1
de la carpeta fileId2
a la fileId3
. Supongamos que las claves de recursos de estos tres archivos son resourceKey1
, resourceKey2
y resourceKey3
, respectivamente. El encabezado creado a partir de estos valores con una barra diagonal y separadores de coma es el siguiente:
X-Goog-Drive-Resource-Keys: fileId1/resourceKey1,fileId2/resourceKey2,fileId3/resourceKey3
Temas relacionados
- Comparte archivos, carpetas y unidades
- Descarga y exporta archivos
- Cómo proteger el contenido de los archivos
- Configura una integración con la IU de Drive