Method: permissions.list

Listet die Berechtigungen einer Datei oder einer geteilten Ablage auf. Weitere Informationen finden Sie unter Dateien, Ordner und Ablagen freigeben.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
fileId

string

Die ID der Datei oder der geteilten Ablage.

Suchparameter

Parameter
pageSize

integer

Die maximale Anzahl der zurückzugebenden Berechtigungen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück.

Wenn nicht angegeben, werden für geteilte Ablagen maximal 100 Berechtigungen und für nicht freigegebene Ablagen die gesamte Liste der Berechtigungen zurückgegeben.

Der Maximalwert ist 100. Werte über 100 werden auf 100 festgelegt.
pageToken

string

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

boolean

Gibt an, ob die anfragende Anwendung sowohl „Meine Ablage“ als auch geteilte Ablagen unterstützt.
supportsTeamDrives
(deprecated)

boolean

Nicht mehr unterstützt: Verwenden Sie stattdessen supportsAllDrives.
useDomainAdminAccess

boolean

Gibt an, ob die Anfrage als Domainadministrator gestellt werden soll.

Wenn auf true gesetzt und die folgenden zusätzlichen Bedingungen erfüllt sind, erhält der Anfragende Zugriff:

  1. Der Parameter für die Datei-ID verweist auf eine geteilte Ablage.
  2. Der Anfragende ist Administrator der Domain, zu der die geteilte Ablage gehört.

Weitere Informationen finden Sie unter Geteilte Ablagen als Domainadministrator verwalten.
includePermissionsForView

string

Gibt an, welche Berechtigungen für zusätzliche Ansichten in die Antwort aufgenommen werden sollen. Nur published wird unterstützt.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Eine Liste der Berechtigungen für eine Datei.

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

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

object (Permission)

Die Liste der Berechtigungen. 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 Berechtigungen. Dieses Feld ist nicht vorhanden, wenn das Ende der Liste der Berechtigungen erreicht wurde. Wenn das Token aus irgendeinem Grund abgelehnt wird, sollte es verworfen und die Paginierung von der ersten Seite der Ergebnisse neu gestartet werden. Das Seitentoken ist in der Regel mehrere Stunden gültig. Wenn jedoch neue Elemente hinzugefügt oder entfernt werden, können sich die erwarteten Ergebnisse unterscheiden.
kind

string

Kennzeichnet, welche Art von Ressource dies ist. Wert: der feste String "drive#permissionList".

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.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.