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

Sie können Google Drive-Dateien und -Ordner über die Drive-Benutzeroberfläche oder über die Google Drive API für andere freigeben. Beim Freigeben einer Datei in Google Drive legen Sie fest, ob andere Personen die Datei bearbeiten, kommentieren oder nur öffnen dürfen.

Ein Ressourcenschlüssel schützt Ihre Datei vor unbeabsichtigtem Zugriff. Ressourcenschlüssel sind ein zusätzlicher Parameter, der übergeben wird, 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 vor Kurzem aufgerufen oder direkten Zugriff darauf haben, benötigen den Ressourcenschlüssel nicht, um auf die Datei zuzugreifen.

Eine Drive-Datei, die über einen Link freigegeben wird, kann nur von Nutzern gefunden werden, die über eine type=user- oder type=group-Ressource mit permissions auf die Datei zugreifen können. Für Anfragen von Nutzern, die nur über eine type=domain- oder type=anyone-Berechtigung 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 zugehörigen 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 bei der Datei um eine Drive-Verknüpfung handelt, wird der Ressourcenschlüssel für das Ziel der Verknüpfung im schreibgeschützten Feld shortcutDetails.targetResourceKey zurückgegeben.

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

Ressourcenschlüssel in der Anfrage festlegen

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

Anfragen an die Drive API können einen oder mehrere Ressourcenschlüssel mit dem X-Goog-Drive-Resource-Keys-HTTP-Header angeben.

Syntax

In der Kopfzeile wird ein Datei-ID- und Ressourcenschlüsselpaar mit einem Schrägstrich (/) als Trennzeichen festgelegt. Der Header wird erstellt, indem alle Datei-ID- und Ressourcenschlüsselpaare durch Kommas (,) getrennt werden.

Angenommen, Sie möchten die Datei fileId1 aus dem Ordner fileId2 in den Ordner fileId3 verschieben. Angenommen, die Ressourcenschlüssel für diese drei Dateien lauten resourceKey1, resourceKey2 und resourceKey3. Die Überschrift, die aus diesen Werten mit Schrägstrichen und Kommas als Trennzeichen erstellt wurde, lautet:

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