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 a través de la IU de Drive o de la API de Google Drive. Cuando compartes contenido desde Drive, tienes la posibilidad de controlar si las personas podrán editar, comentar o solo abrir el archivo.

Una clave de recurso ayuda a proteger tu archivo del acceso no deseado. Las claves de recurso son un parámetro adicional que se pasa para que los usuarios puedan acceder a ciertos archivos que se compartieron con un vínculo. Los usuarios que no hayan visto el archivo antes deben proporcionar la clave de recurso para obtener acceso. Aquellos que hayan visto el archivo recientemente o tengan acceso directo no necesitan la clave de recurso para acceder al archivo.

Los usuarios solo pueden descubrir un archivo de Drive que se comparte con un vínculo si pueden acceder a él como resultado de un recurso type=user o type=group permissions. Es posible que las solicitudes de usuarios que solo tienen acceso a estos archivos compartidos con vínculos mediante un permiso type=domain o type=anyone requieran una clave de recurso.

Para obtener 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 permitidas por cada una, consulta Funciones y permisos.

Cómo leer 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 del 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 state parámetro. Para obtener más información, consulta Cómo descargar y exportar archivos.

Cómo configurar la clave de recurso en la solicitud

Las claves de recurso para cualquier archivo al que hagan 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 recurso con el encabezado HTTP X-Goog-Drive-Resource-Keys.

Sintaxis

Un par de ID de archivo y clave de recurso se establece en el encabezado con una barra diagonal (/) como separador. El encabezado se crea combinando todos los pares de ID de archivo y clave de recurso con comas (,) como separadores.

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

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