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 a través de 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 del acceso no deseado. Las claves de recursos 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. Quienes hayan visto el archivo recientemente o tengan acceso directo no necesitarán la clave de recurso para acceder al archivo.

Solo los usuarios que pueden acceder al archivo como resultado de un recurso type=user o type=group permissions pueden descubrir un archivo de Drive que se comparte con un vínculo. Es posible que las solicitudes de los 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 los roles y las operaciones que cada uno permite, consulta Roles y permisos.

Lee la clave de recursos del archivo

La API de Drive muestra la clave de recurso de un archivo en el campo resourceKey de solo lectura 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 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 a 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.

Establece 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 establecen 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

Un ID de archivo y un par de claves de recursos se establecen en el encabezado con un separador de barra diagonal (/). Para compilar el encabezado, se combinan todos los pares de claves de ID de archivo y de recurso con separadores de coma (,).

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

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