Creare una scorciatoia a un file di Drive

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, vedi Tipi MIME supportati per Google Workspace e Google Drive.

• L'elenco di controllo dell'accesso (ACL) di una scorciatoia eredita l'ACL del file o della cartella principale. L'ACL della scorciatoia non può essere modificato direttamente.

• Un targetId che punta al file o alla cartella di destinazione, chiamato anche "target".

• Un targetMimeType che indica il tipo MIME del target. Il targetMimeType viene utilizzato per determinare il tipo di icona da visualizzare. Il tipo MIME del target viene copiato nel campo targetMimeType quando viene creata la scorciatoia.

• I campi targetId e targetMimeType fanno parte del campo shortcutDetails all'interno della risorsa file.

• Una scorciatoia può avere un solo file o una sola cartella principale. Se è necessario un file di scorciatoia in altre posizioni di Drive, il file di scorciatoia può essere copiato nelle posizioni aggiuntive.

• Quando il target viene eliminato o quando l'utente corrente perde l'accesso al target, la scorciatoia dell'utente che punta al target non funziona più.

• Il titolo di una scorciatoia può essere diverso da quello del target. Quando viene creata una scorciatoia, il titolo del target viene utilizzato come titolo della scorciatoia. Dopo la creazione, il titolo della scorciatoia e il titolo del target possono essere modificati in modo indipendente. Se il nome del target viene modificato, le scorciatoie create in precedenza mantengono il vecchio titolo.

• Il tipo MIME di una scorciatoia può diventare obsoleto. Sebbene sia raro, il tipo MIME di un file blob cambia quando viene caricata una revisione di un tipo diverso, ma tutte le scorciatoie che puntano al file aggiornato mantengono il tipo MIME originale. Ad esempio, se carichi un file JPG su Drive, quindi carichi una revisione AVI, Drive identifica la modifica e aggiorna la miniatura del file effettivo. Tuttavia, la scorciatoia continua ad avere una miniatura JPG.

• Nell'esportazione dei dati dell'Account Google nota anche come Google Takeout, le scorciatoie sono rappresentate come file di preferiti di Netscape contenenti link al target.

Per ulteriori informazioni, vedi Trovare file e cartelle con le scorciatoie di Google Drive .

Importante: in precedenza, le scorciatoie erano i file che puntavano ai contenuti archiviati da un'applicazione. Questo tipo di "scorciatoia" è stato rinominato scorciatoia di terze parti. Per ulteriori informazioni, vedi Creare un file di scorciatoia per i contenuti archiviati dalla tua app.

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 rimandare la scorciatoia e chiama files.create per creare una scorciatoia.

Nota: se utilizzi la versione 2 dell'API, utilizza files.insert.

Gli esempi seguenti 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.

Cerca 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 o il campo di query su cui eseguire la ricerca. Per visualizzare i termini di query che possono essere utilizzati per filtrare i Drive condivisi, consulta Termini di query di ricerca.
• operator specifica la condizione per il termine di query. Per visualizzare gli operatori che puoi utilizzare con ogni 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 per restituire tutte le scorciatoie ai file di fogli di lavoro:

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