Method: approvals.list

Listet die Genehmigungen für eine Datei auf. Weitere Informationen finden Sie unter Genehmigungen verwalten.

Standardmäßig gibt diese Methode eine minimale Antwort zurück, die das Array items möglicherweise nicht enthält. Wenn Sie Genehmigungsdetails abrufen möchten, müssen Sie die gewünschten Felder mit dem Suchparameter fields explizit angeben. Informationen zum Zurückgeben der benötigten Felder finden Sie unter Bestimmte Felder zurückgeben.

HTTP-Anfrage

GET https://www.googleapis.com/drive/v3/files/{fileId}/approvals

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
fileId

string

Erforderlich. Die ID der Datei, für die die Genehmigung gilt.

Suchparameter

Parameter
pageSize

integer

Die maximale Anzahl der zurückzugebenden Genehmigungen. Wenn nicht festgelegt, werden maximal 100 Genehmigungen zurückgegeben.
pageToken

string

Das Token zum Fortsetzen einer vorherigen Auflistungsanfrage auf der nächsten Seite. Dieser Wert sollte auf den Wert von nextPageToken aus einer vorherigen Antwort festgelegt werden.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Die Antwort auf eine Anfrage zur Auflistung von Genehmigungen.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "kind": string,
  "items": [
    {
      object (Approval)
    }
  ],
  "nextPageToken": string
}
Felder
kind

string

Dies ist immer drive#approvalList.
items[]

object (Approval)

Die Liste der Genehmigungen. Wenn nextPageToken ausgefüllt ist, ist diese Liste möglicherweise unvollständig und eine zusätzliche Seite mit Ergebnissen sollte abgerufen werden.
nextPageToken

string

Das Seitentoken für die nächste Seite mit Genehmigungen. Dieser Wert ist nicht vorhanden, wenn das Ende der Liste der Genehmigungen erreicht wurde. Wenn das Token aus irgendeinem Grund abgelehnt wird, sollte es verworfen werden und die Paginierung sollte von der ersten Ergebnisseite neu gestartet werden.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.readonly

Einige Bereiche sind eingeschränkt und erfordern eine Sicherheitsprüfung für Ihre App, um sie verwenden zu können. Weitere Informationen finden Sie im Autorisierungsleitfaden.