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 saber mais, 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.
Uma
targetId
que aponta para o arquivo ou a pasta de destino, também conhecido como "destino".Um
targetMimeType
que indica o tipo MIME do destino. OtargetMimeType
é usado para determinar o ícone de tipo a ser mostrado. O tipo MIME do destino é copiado para o campotargetMimeType
quando o atalho é criado.Os campos
targetId
etargetMimeType
fazem parte do camposhortcutDetails
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, ele poderá ser copiado para os outros locais.
Quando o destino é excluído ou o usuário atual perde o acesso a ele, o atalho do usuário que aponta para o destino é corrompido.
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 do destino podem ser mudados de forma independente. Se o nome do destino for modificado, 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 o 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 a ter 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 contendo links para o destino.
Para mais informações, consulte Encontrar arquivos e pastas com atalhos do Google Drive.
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 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 exige 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 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 termo ou campo de consulta a ser pesquisado. Confira os termos de consulta que podem ser usados para filtrar drives compartilhados em Termos de consulta de pesquisa.
- operator especifica a condição do termo de consulta. Para ver quais operadores você pode usar com cada termo de consulta, veja 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 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'