Le scorciatoie sono file che rimandano ad altri file o cartelle su Google Drive. Le scorciatoie hanno le seguenti caratteristiche:
Un tipo MIME
application/vnd.google-apps.shortcut
. Per ulteriori informazioni, consulta Tipi MIME supportati da Google Workspace e Google Drive.L'ACL di una scorciatoia eredita l'ACL dell'elemento principale. L'ACL della scorciatoia non può essere modificata direttamente.
Un
targetId
che rimanda al file o alla cartella di destinazione, noto anche come "target".Un
targetMimeType
che indica il tipo MIME per la destinazione.targetMimeType
viene utilizzato per determinare l'icona del tipo da visualizzare. Il tipo MIME del target viene copiato nel campotargetMimeType
quando viene creata la scorciatoia.I campi
targetId
etargetMimeType
fanno parte del camposhortcutDetails
nella risorsa file.Una scorciatoia può avere un solo elemento principale. Se un file di scorciatoia è necessario in altre posizioni di Drive, può essere copiato nelle posizioni aggiuntive.
Quando la destinazione viene eliminata o quando l'utente corrente perde l'accesso alla destinazione, la scorciatoia dell'utente che rimanda alla destinazione si interrompe.
Il titolo di una scorciatoia può essere diverso dalla destinazione. Quando viene creata una scorciatoia, il titolo della destinazione viene utilizzato come titolo della scorciatoia. Dopo la creazione, il titolo della scorciatoia e il titolo della destinazione possono essere modificati indipendentemente. Se il nome della destinazione viene modificato, le scorciatoie create in precedenza mantengono il vecchio titolo.
Il tipo MIME di una scorciatoia può diventare obsoleto. Anche se è raro, il tipo MIME di un file blob cambia quando viene caricata una revisione di tipo diverso, ma le eventuali scorciatoie che rimandano al file aggiornato mantengono il tipo MIME originale. Ad esempio, se carichi un file JPG su Drive e poi una revisione AVI, Drive identifica la modifica e aggiorna la miniatura del file effettivo. Tuttavia, la miniatura della scorciatoia continuerà a essere JPG.
In Esportazione dei dati dell'Account Google nota anche come Google Takeout, le scorciatoie sono rappresentate come file di preferiti Netscape contenenti link alla destinazione.
Per saperne di più, vedi Trovare file e cartelle con le scorciatoie di Google Drive.
Crea una scorciatoia
Per creare una scorciatoia, imposta il tipo MIME su
application/vnd.google-apps.shortcut
, imposta targetId
sul file o sulla cartella
a cui deve essere collegata la scorciatoia e chiama files.create
per creare una scorciatoia.
Gli esempi riportati di seguito mostrano come creare una scorciatoia utilizzando una libreria client:
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);
}
}
}
});
Sostituisci quanto segue:
- FILE_NAME: il nome del file che richiede una scorciatoia.
- SHORTCUT_NAME: il nome di questa scorciatoia.
Per impostazione predefinita, la scorciatoia viene creata in Il mio Drive dell'utente corrente e le scorciatoie vengono create solo per i file o le cartelle a cui l'utente corrente ha accesso.
Cercare una scorciatoia
Per cercare una scorciatoia, utilizza la stringa di query q
con
files.list
per filtrare le scorciatoie da
restituire.
mimeType operator values
Dove:
- query_term è il termine di query o il campo in base al quale eseguire la ricerca. Per visualizzare i termini di query che possono essere utilizzati per filtrare i Drive condivisi, consulta Termini di query di ricerca.
- operatore specifica la condizione per il termine di query. Per visualizzare gli operatori che puoi utilizzare con ciascun termine di query, consulta Operatori di query.
- values sono i valori specifici che vuoi utilizzare per filtrare i risultati di ricerca.
Ad esempio, la seguente stringa di query filtra la ricerca in modo da restituire tutte le abbreviazioni dei file di fogli di lavoro:
q: mimeType='application/vnd.google-apps.shortcut' AND shortcutDetails.targetMimeType='application/vnd.google-apps.spreadsheet'