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 Zugriffsvorschläge für Drive-Dateien überprüfen und darauf reagieren. So können Sie den Genehmigungsprozess beschleunigen, indem Sie programmatisch nach Zugriffsvorschlägen suchen und diese dann auflösen. Außerdem können Genehmiger Vorschläge zusammengefasst ansehen.

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

Die folgenden Begriffe sind spezifisch für Zugriffsvorschlä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. Oft ist der Empfänger derselbe wie der Antragsteller, aber nicht immer.
  • Genehmiger: Der Nutzer, der für die Genehmigung (oder Ablehnung) des Zugriffs vorschlags verantwortlich ist. In der Regel ist das der Fall, weil er Inhaber des Dokuments ist oder das Dokument freigeben kann.

Parameter „fields“ verwenden

Wenn Sie die Felder angeben möchten, die in der Antwort zurückgegeben werden sollen, können Sie den fields System parameter 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 sind. Informationen zum Zurückgeben anderer Felder finden Sie unter Bestimmte Felder zurückgeben.

Ausstehenden Zugriffsvorschlag abrufen

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

Ausstehende Zugriffsvorschläge auflisten

Wenn Sie alle ausstehenden Zugriffsvorschläge für ein Drive-Element auflisten möchten, rufen Sie die list Methode für die accessproposals Ressource auf und fügen Sie den fileId Pfadparameter 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 Antragsteller 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 Zugriffsvorschläge für die Datei darstellt.

Das Objekt accessproposals enthält Informationen zu jedem Vorschlag, z. B. zum Antragsteller, zum Empfänger und zur Nachricht, die der Antragsteller hinzugefügt hat. Außerdem enthält es ein RoleAndView -Objekt, das die vorgeschlagene role des Antragstellers mit einer view gruppiert. Da role ein wiederholtes Feld ist, kann es für jeden Vorschlag mehrere 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 Ansichten.

Übergeben Sie die folgenden Abfrageparameter, um die Paginierung von Zugriffsvorschlägen anzupassen oder sie zu 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 der Zugriffsvorschläge, die pro Seite zurückgegeben werden sollen.

Ausstehende Zugriffsvorschläge auflösen

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

Die Methode resolve enthält einen 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 Abfrageparameter sendNotification können Sie dem Antragsteller eine E‑Mail-Benachrichtigung senden, wenn der Vorschlag angenommen oder abgelehnt wird.

Wie bei der Methode list müssen Nutzer, die den Vorschlag auflösen, 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 angewendet (z. B. role=writer im Vergleich zu role=reader). Der andere Zugriffsvorschlag wird aus dem Element entfernt.

Nachdem Sie einen Vorschlag an die Methode resolve gesendet haben, ist die Freigabeaktion abgeschlossen. Der aufgelöste Zugriffsvorschlag 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.