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:

  • Einen MIME-Typ vom Typ application/vnd.google-apps.shortcut. Weitere Informationen finden Sie unter Von Google Workspace und Google Drive unterstützte MIME-Typen.

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

  • Ein targetId, das auf die Zieldatei oder den Zielordner verweist, auch als „target“ bezeichnet

  • Ein targetMimeType, das 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 des Symbols in das Feld targetMimeType kopiert.

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

  • Ein Verknüpfungselement kann nur ein übergeordnetes Element haben. Wenn eine Verknüpfungsdatei an anderen Drive-Standorten erforderlich ist, kann sie an die zusätzlichen Speicherorte kopiert werden.

  • Wenn das Ziel gelöscht wird oder der aktuelle Nutzer keinen Zugriff mehr darauf hat, funktioniert der entsprechende Verknüpfung nicht mehr.

  • Der Titel eines Shortcuts kann vom Ziel abweichen. Wenn ein Verknüpfung erstellt wird, wird der Titel des Ziels als Titel der Verknüpfung verwendet. Nach dem Erstellen können der Titel des Symbols und der Titel des Ziels unabhängig voneinander geändert werden. Wenn der Name des Ziels geändert wird, behalten zuvor erstellte Verknüpfungen den alten Titel.

  • Der MIME-Typ einer Verknüpfung kann veraltet werden. In seltenen Fällen ändert sich der MIME-Typ einer Blob-Datei, 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 Google Drive hochladen und dann eine AVI-Version, erkennt Google Drive die Änderung und aktualisiert das Vorschaubild für die tatsächliche Datei. Der Verknüpfung wird jedoch weiterhin ein JPG-Miniaturbild zugewiesen.

  • Im Google Datenexport, auch Google Datenexport genannt, werden Verknüpfungen als Netscape-Lesezeichendateien mit Links zum Ziel dargestellt.

Weitere Informationen finden Sie im Hilfeartikel Mit Google Drive-Verknüpfungen auf Dateien und Ordner zugreifen.

Verknüpfung erstellen

Wenn Sie eine Verknüpfung erstellen möchten, legen Sie den MIME-Typ auf application/vnd.google-apps.shortcut fest, legen Sie targetId auf die Datei oder den Ordner fest, auf die bzw. den die Verknüpfung verweisen soll, und rufen Sie files.create auf, um eine Verknüpfung zu erstellen.

In den folgenden Beispielen wird gezeigt, wie Sie einen 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 ein Verknüpfungssymbol benötigt wird.
  • SHORTCUT_NAME: der Name für diese Verknüpfung.

Standardmäßig wird die Verknüpfung im „Mein Drive“ 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

Wenn Sie nach einer Verknüpfung suchen möchten, verwenden Sie den Abfragestring q mit files.list, um die zurückgegebenen Verknüpfungen zu filtern.

mimeType operator values

Wobei:

  • query_term ist der Suchbegriff oder das Suchfeld, in dem gesucht werden soll. Informationen zu Suchbegriffen, mit denen Sie geteilte Ablagen filtern können, finden Sie unter Suchbegriffe.
  • Mit operator wird die Bedingung für den Suchbegriff angegeben. Informationen dazu, welche Operatoren Sie mit den einzelnen Suchbegriffen verwenden können, finden Sie unter Suchoperatoren.
  • values sind die Werte, mit denen Sie die Suchergebnisse filtern möchten.

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

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