Verknüpfung zu einer Drive-Datei erstellen

Verknüpfungen sind Dateien, die mit anderen Dateien oder Ordnern in Google Drive verknüpft sind. Verknüpfungen haben folgende Eigenschaften:

  • Ein application/vnd.google-apps.shortcut-MIME-Typ. Weitere Informationen finden Sie im Hilfeartikel Unterstützte MIME-Typen für Google Workspace und Google Drive.

  • Die ACL für eine Verknüpfung übernimmt die ACL des übergeordneten Elements. Die ACL der Verknüpfung kann nicht direkt geändert werden.

  • Ein targetId, der auf die Zieldatei oder den Zielordner verweist und auch als "Ziel" bezeichnet wird.

  • Ein targetMimeType, der den MIME-Typ für das Ziel angibt. Mit targetMimeType wird festgelegt, welches Typsymbol angezeigt werden soll. Der MIME-Typ des Ziels wird beim Erstellen der Verknüpfung in das Feld targetMimeType kopiert.

  • Die Felder targetId und targetMimeType sind Teil des Felds shortcutDetails in der Ressource file.

  • Einer Verknüpfung kann nur ein übergeordnetes Element zugewiesen werden. Wenn eine Verknüpfungsdatei an anderen Speicherorten in Google Drive erforderlich ist, kann die Verknüpfungsdatei in diese kopiert werden.

  • Wenn das Ziel gelöscht wird oder der aktuelle Nutzer keinen Zugriff mehr auf das Ziel hat, funktioniert die Tastenkombination des Nutzers, die auf das Ziel verweist.

  • Der Titel einer Tastenkombination kann vom Ziel abweichen. Beim Erstellen einer Verknüpfung wird der Titel des Ziels als Titel der Verknüpfung verwendet. Nach der Erstellung können Titel und Zieltitel der Verknüpfung unabhängig voneinander geändert werden. Wenn der Name des Ziels geändert wird, behalten zuvor erstellte Verknüpfungen den alten Titel bei.

  • Der MIME-Typ einer Verknüpfung kann veraltet sein. Es kommt zwar selten vor, der MIME-Typ einer Blob-Datei ändert sich jedoch, wenn eine Version eines anderen Typs hochgeladen wird. Alle Verknüpfungen, die auf die aktualisierte Datei verweisen, behalten jedoch den ursprünglichen MIME-Typ bei. Wenn Sie beispielsweise eine JPG-Datei in Drive und dann eine AVI-Version hochladen, identifiziert Drive die Änderung und aktualisiert die Miniaturansicht der eigentlichen Datei. Die Verknüpfung behält jedoch weiterhin eine JPG-Miniaturansicht.

  • Im Google-Kontodatenexport (auch als Google Datenexport bezeichnet) werden Verknüpfungen als Netscape-Lesezeichendateien mit Links zum Ziel dargestellt.

Weitere Informationen finden Sie unter Dateien und Ordner mit Google Drive-Verknüpfungen suchen.

Verknüpfung erstellen

Legen Sie zum Erstellen einer Verknüpfung den MIME-Typ auf application/vnd.google-apps.shortcut fest, legen Sie für targetId die Datei oder den Ordner fest, mit der bzw. dem die Verknüpfung verknüpft werden soll, und rufen Sie files.create auf, um eine Verknüpfung zu erstellen.

Die folgenden Beispiele zeigen, wie Sie eine Verknüpfung mithilfe einer Clientbibliothek erstellen:

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);
      }
    }
  }
});

Ersetzen Sie Folgendes:

  • FILE_NAME: der Dateiname, für den eine Verknüpfung erforderlich ist.
  • SHORTCUT_NAME: der Name dieser Verknüpfung.

Standardmäßig wird die Verknüpfung im Ordner „Meine Ablage“ des aktuellen Nutzers erstellt. Verknüpfungen werden nur für Dateien oder Ordner erstellt, auf die der aktuelle Nutzer Zugriff hat.

Nach einer Verknüpfung suchen

Verwenden Sie für die Suche nach einem Kürzel den Abfragestring q mit files.list, um die zurückzugebenden Tastenkombinationen zu filtern.

mimeType operator values

Wobei:

  • query_term ist der Suchbegriff oder das Feld, nach dem gesucht werden soll. Die Suchbegriffe, die zum Filtern geteilter Ablagen verwendet werden können, finden Sie unter Suchbegriffe.
  • operator gibt die Bedingung für den Suchbegriff an. Informationen dazu, welche Operatoren Sie für die einzelnen Suchbegriffe verwenden können, finden Sie unter Abfrageoperatoren.
  • Werte sind die spezifischen Werte, nach denen Sie Ihre Suchergebnisse filtern möchten.

Mit dem folgenden Abfragestring wird beispielsweise die Suche so gefiltert, dass alle Verknüpfungen zu Tabellenkalkulationsdateien zurückgegeben werden:

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