Ausstehende Zugriffsanfragen verwalten

Ein Zugriffsvorschlag ist ein Vorschlag eines Antragstellers an einen Genehmiger, einem Empfänger Zugriff auf ein Google Drive-Element zu gewähren.

Ein Genehmiger kann alle nicht erledigten Zugriffsvorschläge für Drive-Dateien prüfen und darauf reagieren. Sie können den Genehmigungsprozess also beschleunigen, indem Sie programmatisch nach Zugriffsvorschlägen suchen und diese dann bearbeiten. Außerdem können Genehmiger Angebote zusammengefasst ansehen.

Die Google Drive API bietet die accessproposals-Ressource, mit der Sie ausstehende Zugriffsvorschläge ansehen und bearbeiten können. Die Methoden der accessproposals-Ressource funktionieren für Dateien, Ordner und die Dateien in einer geteilten Ablage, nicht aber für die geteilte Ablage selbst.

Die folgenden Begriffe sind spezifisch für Zugriffsanträge:

  • Antragsteller: Der Nutzer, der den Zugriffsvorschlag für ein Drive-Element initiiert.
  • Empfänger: Der Nutzer, der die zusätzlichen Berechtigungen für eine Datei erhält, wenn der Zugriffsvorschlag genehmigt wird. Häufig ist der Empfänger derselbe wie der Antragsteller, aber nicht immer.
  • Genehmigende Person: Der Nutzer, der für die Genehmigung (oder Ablehnung) des Zugriffsvorschlags verantwortlich ist. Das liegt in der Regel daran, dass sie Eigentümer des Dokuments sind oder das Dokument freigeben können.

Parameter „fields“ verwenden

Wenn Sie die Felder angeben möchten, die in der Antwort zurückgegeben werden sollen, können Sie den fields-Systemparameter mit einer beliebigen Methode der accessproposals-Ressource festlegen. Wenn Sie den Parameter fields weglassen, gibt der Server eine Standardgruppe von Feldern zurück, die für die Methode spezifisch ist. Informationen zum Zurückgeben verschiedener Felder finden Sie unter Bestimmte Felder zurückgeben.

Ausstehenden Zugriffsvorschlag abrufen

Verwenden Sie die Methode get für die Ressource accessproposals mit den Pfadparametern fileId und proposalId, um einen Zugriffsvorschlag zu erhalten. Wenn Sie die Vorschlags-ID nicht kennen, können Sie ausstehende Zugriffsvorschläge mit der Methode list auflisten.

Ausstehende Zugriffsvorschläge auflisten

Wenn Sie alle ausstehenden Zugriffsvorschläge für ein Drive-Element auflisten möchten, rufen Sie die Methode list für die Ressource accessproposals auf und fügen Sie den Pfadparameter fileId ein.

Nur Genehmiger einer Datei können die ausstehenden Vorschläge für eine Datei auflisten. Ein Genehmiger ist ein Nutzer mit der Funktion can_approve_access_proposals für die Datei. Wenn der Anfragende kein Genehmiger ist, wird eine leere Liste zurückgegeben. Weitere Informationen zu capabilities finden Sie unter Informationen zu Dateifunktionen.

Der Antworttext besteht aus einem accessproposals-Objekt, das eine Liste der nicht aufgelösten Zugriffsanfragen für die Datei darstellt.

Das accessproposals-Objekt enthält Informationen zu jedem Vorschlag, z. B. zum Antragsteller, zum Empfänger und zur Nachricht, die der Antragsteller hinzugefügt hat. Es enthält auch ein RoleAndView-Objekt, in dem die vorgeschlagenen role des Antragstellers mit einem view gruppiert werden. Da role ein wiederkehrendes Feld ist, kann es für jeden Vorschlag mehrere Werte geben. Ein Vorschlag kann beispielsweise ein RoleAndView-Objekt mit role=reader und view=published sowie ein zusätzliches RoleAndView-Objekt mit nur dem Wert role=writer haben. Weitere Informationen finden Sie unter Aufrufe.

Übergeben Sie die folgenden Abfrageparameter, um die Paginierung von oder Filter für Zugriffsanträge anzupassen:

  • pageToken: Ein Seitentoken, das von einem vorherigen Listenaufruf empfangen wurde. Geben Sie dieses Token an, um die nachfolgende Seite abzurufen.

  • pageSize: Die maximale Anzahl von Zugriffsanträgen, die pro Seite zurückgegeben werden sollen.

Ausstehende Zugriffsvorschläge bearbeiten

Wenn Sie alle ausstehenden Zugriffsanträge für ein Drive-Element auflösen möchten, rufen Sie die Methode resolve für die Ressource accessproposals auf und fügen Sie die Pfadparameter fileId und proposalId ein.

Die Methode resolve enthält den Abfrageparameter action, der die Aktion angibt, die für den Vorschlag ausgeführt werden soll. Das Action-Objekt verfolgt die Statusänderung des Vorschlags, damit wir wissen, ob er angenommen oder abgelehnt wird.

Die Methode resolve enthält auch die optionalen Abfrageparameter role und view. Die einzigen unterstützten Rollen sind writer, commenter und reader. Wenn die Rolle nicht angegeben ist, wird standardmäßig reader verwendet. Weitere Informationen finden Sie unter Rollen und Berechtigungen. Mit dem zusätzlichen optionalen Anfrageparameter sendNotification können Sie eine E-Mail-Benachrichtigung an den Antragsteller senden, wenn das Angebot angenommen oder abgelehnt wird.

Genau wie bei der Methode list müssen Nutzer, die den Vorschlag übernehmen, die Funktion can_approve_access_proposals für die Datei haben. Weitere Informationen zu capabilities finden Sie unter Informationen zu Dateifunktionen.

Vorschläge werden mit denselben Mustern aufgelöst, die unter Szenarien für die Freigabe von Drive-Ressourcen aufgeführt sind. Wenn es mehrere Vorschläge für denselben Nutzer, aber mit unterschiedlichen Rollen gibt, gilt Folgendes:

  • Wenn ein Vorschlag angenommen und einer abgelehnt wird, gilt die angenommene Rolle für das Drive-Element.
  • Wenn beide Vorschläge gleichzeitig angenommen werden, wird der Vorschlag mit der höheren Berechtigung (z. B. role=writer im Vergleich zu role=reader) angewendet. Der andere Zugriffsvorschlag wird aus dem Element entfernt.

Nachdem Sie einen Vorschlag an die resolve-Methode gesendet haben, ist die Freigabeaktion abgeschlossen. Das aufgelöste Zugriffsangebot wird nicht mehr über die Methode list zurückgegeben. Sobald der Vorschlag angenommen wurde, muss der Nutzer die permissions-Ressource verwenden, um die Berechtigungen für eine Datei oder einen Ordner zu aktualisieren. Weitere Informationen finden Sie unter Berechtigungen aktualisieren.