Criar um atalho para um arquivo do Drive

Atalhos são arquivos que vinculam a 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 Google Workspace e MIME compatível com o Google Drive tipos.

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

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

• Um targetMimeType que indica o tipo MIME do destino. O targetMimeType é usado para determinar o ícone de tipo que será mostrado. A meta O tipo MIME é copiado para o campo targetMimeType quando o atalho é criados.

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

• Um atalho só pode ter um familiar responsável. Se um arquivo de atalho for necessário em outros locais do Drive, o arquivo de atalho pode ser copiado para outros locais.

• Quando o destino é excluído ou o usuário atual perde o acesso ao destino, o atalho do usuário apontando para as quebras de destino.

• 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. Depois criação, o título do atalho e do destino podem ser alterados de forma independente. Atalhos criados anteriormente se o nome do alvo for alterado mantêm o título antigo.

• O tipo MIME de um atalho pode ficar obsoleto. Embora seja raro, o MIME de um arquivo blob muda quando uma revisão de um tipo diferente é carregada, mas qualquer atalhos que apontam para o arquivo atualizado mantêm o tipo MIME original. Para exemplo, se você fizer o upload de um arquivo JPG para o Google Drive e enviar um AVI, o Drive identifica a alteração e atualiza a miniatura do arquivo real. No entanto, o atalho continua com um arquivo JPG miniatura.

• Nos Dados da Conta do Google Exportação também conhecidos como Google Takeout, os atalhos são representados como Netscape favoritos que contêm links para o destino.

Para mais informações, consulte Localizar arquivos e pastas com o Google Drive atalhos ,

Importante :antes, "atalhos" era o termo para arquivos que apontavam para conteúdo armazenadas por um aplicativo. Esse tipo de "atalho" foi renomeada como atalho de terceiros. Para obter mais informações, consulte Criar um arquivo de atalho para conteúdo armazenado pelo seu 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 ao qual 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 exige um atalho.
• SHORTCUT_NAME: o nome do atalho.

Por padrão, o atalho é criado na página Minha O Drive e os atalhos são criados apenas para arquivos ou pastas de 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 para voltar.

mimeType operator values

Em que:

• query_term é o termo ou campo de consulta a ser pesquisado. Para acessar a consulta que podem ser usados para filtrar drives compartilhados, acesse Consulta de pesquisa em inglês.
• operator especifica a condição do termo de consulta. Para ver quais que podem ser usados com cada termo de consulta, veja Operadores de consulta.
• values são os valores específicos que você quer usar para filtrar sua pesquisa resultados.

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

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