Criar um atalho para um arquivo do Drive

Os atalhos são arquivos que fazem link para outros arquivos ou pastas no Google Drive. Os atalhos têm as seguintes características:

  • Um tipo MIME application/vnd.google-apps.shortcut. Para mais informações, consulte Tipos MIME compatíveis com o Google Workspace e o Google Drive.

  • A ACL de um atalho herda a ACL do pai. A ACL do atalho não pode ser alterada diretamente.

  • Um targetId que aponta para o arquivo ou a pasta de destino, também conhecido como "destino".

  • Um targetMimeType indicando o tipo MIME para o destino. O targetMimeType é usado para determinar o tipo de ícone a ser mostrado. O tipo MIME do destino é copiado para o campo targetMimeType quando o atalho é criado.

  • Os campos targetId e targetMimeType fazem parte do campo shortcutDetails no recurso file.

  • Um atalho só pode ter um pai. Se um arquivo de atalho for necessário em outros locais do Drive, ele poderá ser copiado para os outros locais.

  • Quando o destino é excluído ou quando o usuário atual perde o acesso ao destino, o atalho do usuário que aponta para o destino é quebrado.

  • O título de um atalho pode ser diferente do destino. Quando um atalho é criado, o título do destino é usado como o título do atalho. Após a criação, o título do atalho e o título do destino podem ser alterados de forma independente. Se o nome do destino for alterado, os atalhos criados anteriormente mantêm o título antigo.

  • O tipo MIME de um atalho pode ficar desatualizado. Embora seja raro, o tipo MIME de um arquivo blob muda quando uma revisão de outro tipo é enviada, mas os atalhos que apontam para o arquivo atualizado mantêm o tipo MIME original. Por exemplo, se você fizer upload de um arquivo JPG para o Drive e, em seguida, de uma revisão AVI, o Drive vai identificar a mudança e atualizar a miniatura do arquivo real. No entanto, o atalho continua tendo uma miniatura JPG.

  • Na exportação de dados da Conta do Google, também conhecida como Google Takeout, os atalhos são representados como arquivos de favoritos do Netscape que contêm links para o destino.

Para mais informações, consulte Encontrar arquivos e pastas com os atalhos do Google Drive.

Criar um atalho

Para criar um atalho, defina o tipo MIME como application/vnd.google-apps.shortcut, defina o targetId como o arquivo ou a pasta a que o atalho será vinculado e chame files.create para criar um atalho.

Os exemplos a seguir mostram como criar um atalho usando uma biblioteca de 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);
      }
    }
  }
});

Substitua:

  • FILE_NAME: o nome do arquivo que requer um atalho.
  • SHORTCUT_NAME: o nome desse atalho.

Por padrão, o atalho é criado no Meu Drive do usuário atual, e os atalhos são criados apenas para arquivos ou pastas a que o usuário atual tem acesso.

Pesquisar um atalho

Para pesquisar um atalho, use a string de consulta q com files.list para filtrar os atalhos a serem retornados.

mimeType operator values

Em que:

  • query_term é o campo ou termo de consulta para pesquisar. Para conferir os termos de consulta que podem ser usados para filtrar drives compartilhados, consulte Termos de consulta de pesquisa.
  • operador especifica a condição para o termo da consulta. Para saber quais operadores podem ser usados com cada termo de consulta, consulte Operadores de consulta.
  • Valores são os valores específicos que você quer usar para filtrar os resultados da pesquisa.

Por exemplo, a string de consulta a seguir filtra a pesquisa para retornar todos os atalhos para arquivos de planilha:

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