Über Ressourcenschlüssel auf Drive-Dateien mit Linkfreigabe zugreifen

Sie können Google Drive-Dateien und ‐Ordner über die Drive-UI oder über die Google Drive API für andere freigeben. Bei der Freigabe aus Google Drive legen Sie fest, ob andere Personen die Datei bearbeiten, kommentieren oder nur öffnen dürfen.

Mit einem Ressourcenschlüssel können Sie Ihre Datei vor unbeabsichtigtem Zugriff schützen. Ressourcenschlüssel sind zusätzliche Parameter, die übergeben werden, damit Nutzer auf bestimmte Dateien zugreifen können, die über einen Link freigegeben wurden. Nutzer, die die Datei noch nicht aufgerufen haben, müssen den Ressourcenschlüssel angeben, um Zugriff zu erhalten. Nutzer, die die Datei kürzlich aufgerufen haben oder direkten Zugriff haben, benötigen für den Zugriff auf die Datei nicht den Ressourcenschlüssel.

Eine Drive-Datei, die über einen Link freigegeben wurde, kann nur von Nutzern gefunden werden, die über eine type=user- oder type=group-permissions-Ressource auf die Datei zugreifen können. Für Anfragen von Nutzern, die mit der Berechtigung type=domain oder type=anyone nur Zugriff auf diese per Link freigegebenen Dateien haben, ist möglicherweise ein Ressourcenschlüssel erforderlich.

Weitere Informationen zu Berechtigungen finden Sie im Hilfeartikel Dateien, Ordner und Laufwerke freigeben. Eine vollständige Liste der Rollen und der jeweils zulässigen Vorgänge finden Sie unter Rollen und Berechtigungen.

Ressourcenschlüssel aus der Datei lesen

Die Drive API gibt den Ressourcenschlüssel einer Datei im schreibgeschützten Feld resourceKey der Ressource files zurück.

Wenn es sich um eine Drive-Verknüpfung handelt, wird der Ressourcenschlüssel für das Verknüpfungsziel im schreibgeschützten Feld shortcutDetails.targetResourceKey zurückgegeben.

Felder in der files-Ressource, die URLs wie exportLinks, webContentLink und webViewLink zurückgeben, enthalten auch resourceKey. Clients, die in die Drive-UI eingebunden sind, können auch resourceKeys im Parameter state verwenden. Weitere Informationen finden Sie unter Dateien herunterladen und exportieren.

Ressourcenschlüssel für die Anfrage festlegen

Ressourcenschlüssel für alle Dateien, auf die in Anfragen an die Drive API verwiesen wird, werden im HTTP-Header X-Goog-Drive-Resource-Keys festgelegt.

In Anfragen an die Drive API können ein oder mehrere Ressourcenschlüssel mit dem HTTP-Header X-Goog-Drive-Resource-Keys angegeben werden.

Syntax

Eine Datei-ID und ein Ressourcenschlüsselpaar werden im Header mit einem Schrägstrich (/) als Trennzeichen festgelegt. Beim Erstellen des Headers werden alle Datei-ID- und Ressourcenschlüsselpaare mit Komma (,) als Trennzeichen kombiniert.

Stellen Sie sich beispielsweise eine Anfrage zum Verschieben der Datei fileId1 aus dem Ordner fileId2 in den Ordner fileId3 vor. Angenommen, die Ressourcenschlüssel für diese drei Dateien sind resourceKey1, resourceKey2 bzw. resourceKey3. Der aus diesen Werten erstellte Header mit einem Schrägstrich und einem Komma als Trennzeichen lautet:

    X-Goog-Drive-Resource-Keys: fileId1/resourceKey1,fileId2/resourceKey2,fileId3/resourceKey3