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 aufgelösten Zugriffsanträ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 Ressource accessproposals, 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.

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 AccessProposal-Objekt, das eine Liste der nicht aufgelösten Zugriffsanfragen für die Datei darstellt.

Das AccessProposal-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 AccessProposalRoleAndView-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 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 Ansichten.

Ü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. Mit dem zusätzlichen optionalen Anfrageparameter send_notification 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. Die AccessProposal wird nicht mehr über die Methode list() zurückgegeben. Sobald der Vorschlag akzeptiert 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.