Cómo acceder a archivos de Drive compartidos con vínculos mediante claves de recursos

Puedes compartir archivos y carpetas de Google Drive con otras personas mediante la IU de Drive o la API de Google Drive. Cuando compartes contenido desde Drive, puedes controlar si las personas pueden editar, comentar o solo abrir el archivo.

Una clave de recurso ayuda a proteger tu archivo contra 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 hayan visto el archivo antes deben proporcionar la clave de recurso para obtener acceso. Las personas que vieron el archivo recientemente o tienen acceso directo no necesitan la clave de recurso para acceder a él.

Solo los usuarios que pueden acceder a él pueden descubrir un archivo de Drive que se comparta con un vínculo como resultado de un recurso permissions type=user o type=group. Las solicitudes de los usuarios que solo tienen acceso a estos archivos compartidos mediante vínculos con un permiso type=domain o type=anyone pueden requerir una clave de recurso.

Si necesitas más información sobre los permisos, consulta Cómo compartir 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 acceso directo de destino se muestra en el campo shortcutDetails.targetResourceKey de solo lectura.

Los campos del recurso files que muestran URLs, como exportLinks, webContentLink y webViewLink, también incluyen resourceKey. Los clientes que se integran en la IU de Drive también pueden usar resourceKeys dentro del parámetro state. Para obtener más información, consulta Cómo descargar y exportar archivos.

Configura la clave de recurso en la solicitud

Las claves de recursos para cualquier archivo 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 configura un ID de archivo y un par de claves de recursos en el encabezado con un separador de barra diagonal (/). El encabezado se compila mediante la combinación de todos los pares de ID de archivo y claves de recurso con separadores de comas (,).

Por ejemplo, considera una solicitud para mover el archivo fileId1 de la carpeta fileId2 a la carpeta fileId3. Supongamos que las claves de recursos para estos tres archivos son resourceKey1, resourceKey2 y resourceKey3, respectivamente. El encabezado compilado a partir de estos valores mediante una barra diagonal y separadores por coma es el siguiente:

    X-Goog-Drive-Resource-Keys: fileId1/resourceKey1,fileId2/resourceKey2,fileId3/resourceKey3