Method: approvals.list

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

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 Genehmigungen, die zurückgegeben werden sollen. Wenn nicht festgelegt, werden maximal 100 Genehmigungen zurückgegeben.
pageToken

string

Das Token zum Fortsetzen einer vorherigen Listenanfrage 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 für eine Genehmigungsliste.

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 es sollte eine zusätzliche Seite mit Ergebnissen 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 und die Paginierung mit 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, damit sie verwendet werden können. Weitere Informationen finden Sie im Autorisierungsleitfaden.