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

Sie können Google Drive-Dateien und ‑Ordner über die Drive-Benutzeroberfläche oder die Google Drive API für andere freigeben. Beim Freigeben einer Datei in 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 haben oder direkten Zugriff haben, benötigen den Ressourcenschlüssel nicht, um auf die Datei zuzugreifen.

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

Weitere Informationen zu Berechtigungen finden Sie unter Dateien, Ordner und Ablagen 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 resourceKey Feld der files Ressource zurück.

Wenn die Datei eine Drive-Verknüpfung ist, wird der Ressourcenschlüssel für das Verknüpfungsziel im schreibgeschützten shortcutDetails.targetResourceKey Feld zurückgegeben.

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

Ressourcenschlüssel in der 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 mit dem HTTP-Header X-Goog-Drive-Resource-Keys ein oder mehrere Ressourcenschlüssel angegeben werden.

Syntax

Ein Paar aus Datei-ID und Ressourcenschlüssel wird im Header mit einem Schrägstrich (/) als Trennzeichen festgelegt. Der Header wird erstellt, indem alle Paare aus Datei-ID und Ressourcenschlüssel mit Kommas (,) als Trennzeichen kombiniert werden.

Ein Beispiel: Eine Anfrage zum Verschieben der Datei fileId1 aus dem Ordner fileId2 in den Ordner fileId3. Angenommen, die Ressourcenschlüssel für diese drei Dateien sind resourceKey1, resourceKey2 und resourceKey3. Der aus diesen Werten mit Schrägstrichen und Kommas als Trennzeichen erstellte Header sieht so aus:

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