Cómo crear un acceso directo a un archivo de Drive

Los accesos directos son archivos que se vinculan a otros archivos o carpetas de Google Drive. Los accesos directos tienen las siguientes características:

  • Un tipo de MIME application/vnd.google-apps.shortcut Para obtener más información, consulta Tipos de MIME compatibles con Google Workspace y Google Drive.

  • La LCA de un acceso directo hereda la LCA del elemento superior. La LCA del acceso directo no se puede cambiar directamente.

  • Es un targetId que apunta al archivo o la carpeta de destino, también conocido como "destino".

  • Una targetMimeType que indica el tipo de MIME del destino. targetMimeType se usa para determinar el ícono de tipo que se mostrará. El tipo de MIME del destino se copia en el campo targetMimeType cuando se crea el acceso directo.

  • Los campos targetId y targetMimeType forman parte del campo shortcutDetails dentro del recurso de archivo.

  • Un acceso directo solo puede tener un elemento superior. Si se requiere un archivo de acceso directo en otras ubicaciones de Drive, este se puede copiar en las ubicaciones adicionales.

  • Cuando se borra el destino o cuando el usuario actual pierde el acceso a este, se interrumpe el atajo del usuario que apunta al objetivo.

  • El título de un acceso directo puede diferir del destino. Cuando se crea un acceso directo, el título del destino se usa como el título del acceso directo. Después de la creación, el título del acceso directo y el título del destino se pueden cambiar de forma independiente. Si se cambia el nombre del destino, los atajos creados anteriormente conservarán el título anterior.

  • El tipo de MIME de un acceso directo puede quedar inactivo. Aunque es poco común, el tipo de MIME de un archivo BLOB cambia cuando se sube una revisión de un tipo diferente, pero los accesos directos que apuntan al archivo actualizado conservan el tipo de MIME original. Por ejemplo, si subes un archivo JPG a Drive y, luego, subes una revisión de AVI, Drive identifica el cambio y actualiza la miniatura del archivo real. Sin embargo, el acceso directo sigue teniendo una miniatura JPG.

  • En la exportación de datos de una Cuenta de Google, también conocida como Google Takeout, los accesos directos se representan como archivos de favoritos de Netscape que contienen vínculos al destino.

Para obtener más información, consulta Cómo buscar archivos y carpetas con accesos directos de Google Drive.

Crear un acceso directo

Para crear un acceso directo, establece el tipo de MIME en application/vnd.google-apps.shortcut, establece targetId en el archivo o la carpeta al que debe vincularse el acceso directo y llama a files.create para crear un acceso directo.

En los siguientes ejemplos, se muestra cómo crear un acceso directo con una biblioteca cliente:

Python

file_metadata = {
    'name': 'FILE_NAME',
    'mimeType': 'text/plain'
}
file = drive_service.files().create(body=file_metadata, fields='id').execute()
print('File ID: %s' % file.get('id'))
shortcut_metadata = {
     'Name': 'SHORTCUT_NAME',
     'mimeType': 'application/vnd.google-apps.shortcut',
     'shortcutDetails': {
        'targetId': file.get('id')
     }
}
shortcut = drive_service.files().create(body=shortcut_metadata,
                                    fields='id,shortcutDetails').execute()
print('File ID: %s, Shortcut Target ID: %s, Shortcut Target MIME type: %s' % (
    shortcut.get('id'),
    shortcut.get('shortcutDetails').get('targetId'),
    shortcut.get('shortcutDetails').get('targetMimeType')))

Node.js

var fileMetadata = {
  'name': 'FILE_NAME',
  'mimeType': 'text/plain'
};
drive.files.create({
  'resource': fileMetadata,
  'fields': 'id'
}, function (err, file) {
  if (err) {
    // Handle error
    console.error(err);
  } else {
    console.log('File Id: ' + file.id);
    shortcutMetadata = {
      'name': 'SHORTCUT_NAME',
      'mimeType': 'application/vnd.google-apps.shortcut'
      'shortcutDetails': {
        'targetId': file.id
      }
    };
    drive.files.create({
      'resource': shortcutMetadata,
      'fields': 'id,name,mimeType,shortcutDetails'
    }, function(err, shortcut) {
      if (err) {
        // Handle error
        console.error(err);
      } else {
        console.log('Shortcut Id: ' + shortcut.id +
                    ', Name: ' + shortcut.name +
                    ', target Id: ' + shortcut.shortcutDetails.targetId +
                    ', target MIME type: ' + shortcut.shortcutDetails.targetMimeType);
      }
    }
  }
});

Reemplaza lo siguiente:

  • FILE_NAME: Es el nombre del archivo que requiere un acceso directo.
  • SHORTCUT_NAME: Es el nombre de este acceso directo.

De forma predeterminada, se crean los accesos directos en la sección Mi unidad del usuario actual y solo se crean para los archivos o las carpetas a los que el usuario actual tiene acceso.

Busca un atajo

Si quieres buscar un atajo, usa la cadena de consulta q con files.list para filtrar los atajos que se mostrarán.

mimeType operator values

Donde:

  • query_term es el término de búsqueda o el campo que se buscará. Si quieres ver los términos de la consulta que se pueden usar para filtrar unidades compartidas, consulta Términos de la consulta de búsqueda.
  • operador especifica la condición del término de consulta. A fin de ver qué operadores puedes usar con cada término de consulta, consulta Operadores de consulta.
  • Los valores son los valores específicos que quieres usar para filtrar tus resultados de la búsqueda.

Por ejemplo, la siguiente cadena de consulta filtra la búsqueda para mostrar todos los accesos directos a archivos de hoja de cálculo:

q: mimeType='application/vnd.google-apps.shortcut' AND shortcutDetails.targetMimeType='application/vnd.google-apps.spreadsheet'