Verknüpfung zu einer Drive-Datei erstellen

Verknüpfungen sind Dateien, die auf andere Dateien oder Ordner in Google Drive verweisen. Verknüpfungen haben folgende Eigenschaften:

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

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

  • Eine targetId, die auf die Zieldatei oder den Zielordner verweist, auch als „Ziel“ bezeichnet.

  • Ein targetMimeType, der den MIME-Typ für das Ziel angibt. Mit targetMimeType wird das anzuzeigende Typsymbol bestimmt. Der MIME-Typ des Ziels wird in das Feld targetMimeType kopiert, wenn die Verknüpfung erstellt wird.

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

  • Eine Verknüpfung kann nur ein übergeordnetes Element haben. Wenn eine Verknüpfungsdatei an anderen Drive-Speicherorten benötigt wird, kann sie an diese Speicherorte kopiert werden.

  • Wenn das Ziel gelöscht wird oder der aktuelle Nutzer den Zugriff auf das Ziel verliert, funktioniert die Verknüpfung des Nutzers zum Ziel nicht mehr.

  • Der Titel einer Verknüpfung kann sich vom Ziel unterscheiden. Wenn eine Verknüpfung erstellt wird, wird der Titel des Ziels als Titel der Verknüpfung verwendet. Nach der Erstellung können der Titel der Verknüpfung 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 bei.

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

  • Beim Datenexport aus Google-Konten auch bekannt als Google Takeout, werden Verknüpfungen als Netscape Lesezeichendateien dargestellt, die Links zum Ziel enthalten.

Weitere Informationen finden Sie unter 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, setzen Sie targetId auf die Datei oder den Ordner 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 eine Verknüpfung mit 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 für diese 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

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

mimeType operator values

Wobei:

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

Der folgende Abfragestring filtert die Suche so, dass alle Verknüpfungen zu Tabellendateien zurückgegeben werden:

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