Genehmigungen verwalten

In diesem Dokument wird beschrieben, wie Sie Genehmigungen in der Google Drive API verwalten.

Sie finden Ihre Inhaltsgenehmigungen in Google Drive. Die Google Drive API bietet die approvals-Ressource, mit der Sie den Status Ihrer Genehmigungen abrufen und auflisten können. Die Methoden der approvals-Ressource funktionieren für Elemente in Drive, Google Docs und anderen Google Workspace-Editoren.

Damit können Sie Genehmigungen in formellen Überprüfungssituationen finden, z. B. bei der Überprüfung eines Vertrags oder eines offiziellen Dokuments vor der Veröffentlichung. Eine Genehmigung gibt den Status der Überprüfung (z. B. „Wird verarbeitet“, „Genehmigt“ oder „Abgelehnt“) und die beteiligten Prüfer an. Genehmigungen sind eine hervorragende Möglichkeit, Inhalte zu validieren und eine Aufzeichnung der Prüfer zu führen.

Wenn Sie Genehmigungen für eine Datei aufrufen möchten, benötigen Sie die Berechtigung zum Lesen der Metadaten der Datei. Weitere Informationen finden Sie unter Rollen und Berechtigungen.

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 approvals-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 anderer Felder finden Sie unter Bestimmte Felder zurückgeben.

Genehmigung einholen

Verwenden Sie die Methode get für die Ressource approvals mit den Pfadparametern fileId und approvalId, um eine Genehmigung für eine Datei zu erhalten. Wenn Sie die Genehmigungs-ID nicht kennen, können Sie Genehmigungen mit der Methode list auflisten.

Der Antworttext enthält eine Instanz der approvals-Ressource.

Genehmigungen auflisten

Wenn Sie Genehmigungen für eine Datei auflisten möchten, rufen Sie die Methode list für die Ressource approvals auf und fügen Sie den Pfadparameter fileId ein.

Der Antworttext besteht aus einer Liste der Genehmigungen für die Datei. Das Feld items enthält Informationen zu jeder Genehmigung in Form einer approvals-Ressource.

Die approvals-Ressource enthält auch ein Status-Objekt, das den Status der Genehmigung beschreibt, sowie das ReviewerResponse-Objekt, das die Antwort auf eine Genehmigung durch einen bestimmten Prüfer beschreibt. Die Antwort dieses Rezensenten wird durch das Response-Objekt dargestellt.

Sie können auch die folgenden Abfrageparameter übergeben, um die Paginierung der Genehmigungen anzupassen oder sie zu filtern:

  • pageSize: Die maximale Anzahl der Genehmigungen, die pro Seite zurückgegeben werden sollen. Wenn Sie pageSize nicht festlegen, gibt der Server bis zu 100 Genehmigungen zurück.

  • pageToken: Ein Seitentoken, das von einem vorherigen Listenaufruf empfangen wurde. Mit diesem Token wird die nächste Seite abgerufen. Er sollte auf den Wert von nextPageToken aus einer vorherigen Antwort festgelegt werden.