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 unter Von Google Workspace und Google Drive unterstützte MIME-Typen.

  • Die ACL für eine Verknüpfung erbt 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. Das targetMimeType wird verwendet, um den Typsymbol zu bestimmen, der 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.

  • Eine Verknüpfung kann nur ein übergeordnetes Element haben. Wenn eine Verknüpfungsdatei an anderen Drive-Speicherorten erforderlich ist, kann die Verknüpfungsdatei an diese zusätzlichen Speicherorte kopiert werden.

  • Wenn das Ziel gelöscht wird oder der aktuelle Nutzer keinen Zugriff mehr darauf hat, wird die auf das Ziel verweisende Verknüpfung des Nutzers unterbrochen.

  • Der Titel einer Verknüpfung kann sich vom Ziel unterscheiden. Beim Erstellen einer Verknüpfung wird der Titel des Ziels als Titel der Verknüpfung verwendet. Nach dem Erstellen 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 die Miniaturansicht für die tatsächliche Datei. Das Kürzel enthält jedoch weiterhin eine JPG-Miniaturansicht.

  • Beim Export von Google-Kontodaten (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 finden.

Verknüpfung erstellen

Wenn Sie eine Verknüpfung erstellen möchten, setzen Sie den MIME-Typ auf application/vnd.google-apps.shortcut und targetId auf die Datei oder den Ordner, zu der bzw. dem die Verknüpfung führen soll. Rufen Sie dann files.create auf, um eine Verknüpfung zu erstellen.

Die folgenden Beispiele zeigen, 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 dieser Verknüpfung.

Standardmäßig wird die Verknüpfung in „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 einer Verknüpfung 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. 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 jedem Abfragebegriff 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 beispielsweise die Suche so, dass alle Verknüpfungen zu Tabellenkalkulationsdateien zurückgegeben werden:

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