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.

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

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.

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 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'