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.

Genehmiger können alle nicht abgeschlossenen Zugriffsanfragen für Google Drive-Dateien prüfen und bearbeiten. So können Sie den Genehmigungsprozess beschleunigen, indem Sie programmatisch nach Zugriffsanfragen fragen und sie dann genehmigen. Außerdem können Genehmiger Vorschläge insgesamt ansehen.

Die Google Drive API bietet die Ressource accessproposals, mit der Sie ausstehende Zugriffsanfragen 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 beziehen sich speziell auf Zugriffsanfragen:

  • Antragsteller: Der Nutzer, der den Zugriff auf ein Drive-Element anfordert.
  • Empfänger: Der Nutzer, der die zusätzlichen Berechtigungen für eine Datei erhält, wenn der Zugriffsvorschlag gewährt wird. In vielen Fällen ist der Empfänger mit dem Antragsteller identisch, aber nicht immer.
  • Genehmiger: 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 die Möglichkeit haben, das Dokument freizugeben.

Ausstehende Zugriffsanfragen auflisten

Wenn Sie alle ausstehenden Zugriffsanfragen für ein Drive-Element auflisten möchten, rufen Sie die Methode list() für die Ressource accessproposals auf und geben Sie den Pfadparameter fileId an.

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

Der Antworttext besteht aus einem AccessProposal-Objekt, das eine Liste der nicht abgeschlossenen Zugriffsvorschläge für die Datei darstellt.

Das AccessProposal-Objekt enthält Informationen zu jedem Vorschlag, z. B. den Anfragenden, den Empfänger und die Nachricht, die der Anfragende hinzugefügt hat. Außerdem enthält sie ein AccessProposalRoleAndView-Objekt, in dem der vorgeschlagene role des Antragstellers mit einem view gruppiert wird. Da role ein wiederkehrendes Feld ist, kann es für jeden Vorschlag mehrere Einträge geben. Ein Vorschlag kann beispielsweise ein AccessProposalRoleAndView-Objekt mit role=reader und view=published sowie ein zusätzliches AccessProposalRoleAndView-Objekt mit nur dem Wert role=writer enthalten. Weitere Informationen finden Sie unter Aufrufe.

Mit den folgenden Abfrageparametern können Sie die Paginierung von Zugriffsvorschlägen anpassen oder sie filtern:

  • 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 Zugriffsanfragen, die pro Seite zurückgegeben werden sollen.

Ausstehende Zugriffsanfragen bearbeiten

Wenn Sie alle ausstehenden Zugriffsanfragen für ein Drive-Element bearbeiten möchten, rufen Sie die Methode resolve() für die Ressource accessproposals auf und geben Sie die Pfadparameter fileId und proposalId an.

Die Methode resolve() enthält den Abfrageparameter action, der die Aktion angibt, die mit dem Vorschlag ausgeführt werden soll. Das Objekt Action überwacht den Statuswechsel des Angebots, damit wir wissen, ob es angenommen oder abgelehnt wird.

Die Methode resolve() umfasst 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. Mit einem zusätzlichen optionalen Abfrageparameter von send_notification können Sie dem Antragsteller eine E-Mail-Benachrichtigung senden, wenn der Vorschlag angenommen oder abgelehnt wird.

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

Vorschläge werden anhand derselben Muster gelö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 ein anderer 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 angewendet (z. B. role=writer gegenüber role=reader). Der andere Zugriffsvorschlag wird aus dem Artikel entfernt.

Nachdem ein Vorschlag an die resolve()-Methode gesendet wurde, ist die Freigabe abgeschlossen. Die AccessProposal wird nicht mehr über die list()-Methode zurückgegeben. Sobald der Vorschlag angenommen wurde, muss der Nutzer die Sammlung permissions verwenden, um die Berechtigungen für eine Datei oder einen Ordner zu aktualisieren. Weitere Informationen finden Sie unter Berechtigungen aktualisieren.