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 la API de Google Drive. Cuando compartes contenido desde Drive, puedes 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 recursos son un parámetro adicional que se pasa para que los usuarios puedan acceder a ciertos archivos que se compartieron a través de un vínculo. Los usuarios que no hayan visto el archivo antes deben proporcionar la clave del 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.

Los usuarios solo pueden descubrir los archivos de Drive que se comparten con un vínculo si pueden acceder a ellos como resultado de un recurso type=user o type=group permissions. Es posible que las solicitudes de los usuarios que solo tienen acceso a estos archivos compartidos por vínculo con un permiso de 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 permitidas por cada uno, consulta Roles y permisos.

Lee la clave del recurso del archivo

La API de Drive devuelve 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 devuelve en el campo shortcutDetails.targetResourceKey de solo lectura.

Los campos del recurso files que devuelven 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 Cómo descargar y exportar archivos.

Establece la clave del recurso en la solicitud

Las claves de recursos para los archivos a los que se hace referencia en 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

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

Por ejemplo, considera una solicitud para mover el archivo fileId1 de la carpeta fileId2 a la carpeta fileId3. Supón que las claves de recursos para estos tres archivos son resourceKey1, resourceKey2 y resourceKey3, respectivamente. El encabezado creado a partir de estos valores con barras diagonales y comas como separadores es el siguiente:

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