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 Google Workspace e MIME supportato da Google Drive di classificazione.

• L'ACL di una scorciatoia eredita l'ACL dell'elemento principale. L'ACL della scorciatoia non possono essere modificate direttamente.

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

• Un elemento targetMimeType che indica il tipo MIME per la destinazione. La targetMimeType viene utilizzato per stabilire il tipo di icona da visualizzare. Il target Il tipo MIME viene copiato nel campo targetMimeType quando la scorciatoia viene è stato creato.

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

• Una scorciatoia può avere un solo genitore. Se è necessario un file di scorciatoia in un altro le posizioni di Drive, il file delle scorciatoie può essere copiato ulteriori località.

• Quando il target viene eliminato o l'utente corrente perde l'accesso al target, la scorciatoia dell'utente che punta verso le interruzioni target.

• Il titolo di una scorciatoia può essere diverso dal target. Se viene selezionata una scorciatoia creato, il titolo della destinazione viene utilizzato come titolo della scorciatoia. Dopo il giorno creazione, puoi modificare il titolo della scorciatoia e il titolo della destinazione in modo indipendente. Se il nome della destinazione viene modificato, le scorciatoie create in precedenza mantenere il vecchio titolo.

• Il tipo MIME di una scorciatoia può diventare inattivo. Sebbene sia raro, il codice MIME di un file BLOB cambia quando viene caricata una revisione di un tipo diverso, ma Le scorciatoie che puntano al file aggiornato mantengono il tipo MIME originale. Per esempio, se carichi un file JPG su Drive, quindi carichi un revisione AVI, Drive identifica la modifica e aggiorna miniatura per il file vero e proprio. Tuttavia, la scorciatoia continua ad avere un file JPG miniatura.

• In Dati dell'Account Google Esporta noti anche come Google Takeout, le scorciatoie sono rappresentate come Netscape aggiungere ai preferiti file contenenti link alla destinazione.

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

Crea una scorciatoia

Per creare una scorciatoia, imposta il tipo MIME su application/vnd.google-apps.shortcut, imposta targetId sul file o sulla cartella la scorciatoia deve rimandare a e chiamare files.create per creare una scorciatoia.

I seguenti esempi mostrano come creare una scorciatoia utilizzando una libreria client:

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

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 nella sezione Il mio Drive e le scorciatoie vengono creati solo per i file o le cartelle per a cui ha accesso l'utente corrente.

Cerca una scorciatoia

Per cercare una scorciatoia, utilizza la stringa di query q con files.list per filtrare le scorciatoie in base a per tornare indietro.

mimeType operator values

Dove:

• query_term è il termine o il campo della query da cercare. Per visualizzare la query Termini che possono essere utilizzati per filtrare i Drive condivisi, consulta Query di ricerca termini.
• operator specifica la condizione del termine di query. Per visualizzare quali che puoi utilizzare con ciascun termine di query, consulta la sezione Operatori di query.
• valori sono i valori specifici che vuoi utilizzare per filtrare la ricerca che consentono di analizzare i dati e visualizzare i risultati.

Ad esempio, la seguente stringa di query filtra la ricerca per restituire tutti scorciatoie ai file dei fogli di lavoro:

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