Criar um atalho para um arquivo do Drive

Atalhos são arquivos vinculados a outros arquivos ou pastas no Google Drive. Os atalhos têm estas 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 do destino. O targetMimeType é usado para determinar o tipo de ícone a ser exibido. 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 de arquivo.

• Os atalhos só podem ter um familiar responsável. Se um arquivo de atalho for necessário em outros locais do Drive, ele poderá ser copiado para esses locais.

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

• 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 mudados de forma independente. Se o nome do destino mudar, os atalhos criados anteriormente manterão o título antigo.

• O tipo MIME de um atalho pode ficar obsoleto. Embora seja raro, o tipo MIME de um arquivo blob muda quando uma revisão de um tipo diferente é enviada, mas todos 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 depois enviar uma revisão AVI, o Drive 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 (link em inglês), 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 saber mais, consulte Encontrar arquivos e pastas com os atalhos do Google Drive.

Importante: anteriormente, atalhos eram o termo para arquivos que apontavam para o conteúdo armazenado por um app. Esse tipo de "atalho" foi renomeado como atalho de terceiros. Para mais informações, consulte Criar um arquivo de atalho para conteúdo armazenado pelo app.

Criar um atalho

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

Observação: se você estiver usando a V2 da API, use files.insert.

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 do 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 aos quais 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 termo de consulta ou campo a ser pesquisado. Confira os termos de consulta que podem ser usados para filtrar drives compartilhados em Termos de consulta de pesquisa.
• operador especifica a condição do termo de consulta. Para saber quais operadores podem ser usados com cada termo de consulta, acesse Operadores de consulta.
• values são os valores específicos que você quer usar para filtrar os resultados da pesquisa.

Por exemplo, a string de consulta abaixo 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'