Method: permissions.list

Affiche la liste des autorisations d'un fichier ou d'un Drive partagé. Pour en savoir plus, consultez Partager des fichiers, des dossiers et des Drive.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
fileId

string

ID du fichier ou du Drive partagé.

Paramètres de requête

Paramètres
pageSize

integer

Nombre maximal d'autorisations à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur.

Si aucune valeur n'est spécifiée, 100 autorisations au maximum sont renvoyées pour les Drive partagés, et la liste complète des autorisations pour les Drive non partagés.

La valeur maximale est 100. Les valeurs supérieures sont réduites à 100.
pageToken

string

Jetons permettant de poursuivre une requête de liste précédente sur la page suivante. Cette valeur doit être définie sur la valeur nextPageToken de la réponse précédente.
supportsAllDrives

boolean

Indique si l'application à l'origine de la requête est compatible avec Mon Drive et les Drive partagés.
supportsTeamDrives
(deprecated)

boolean

Obsolète : utilisez plutôt supportsAllDrives.
useDomainAdminAccess

boolean

Émettez la requête en tant qu'administrateur de domaine.

Si la valeur est définie sur true et que les conditions supplémentaires suivantes sont remplies, l'accès est accordé au demandeur :

  1. Le paramètre d'ID de fichier fait référence à un Drive partagé.
  2. Le demandeur est un administrateur du domaine auquel appartient le Drive partagé.

Pour en savoir plus, consultez Gérer les Drive partagés en tant qu'administrateur de domaine.
includePermissionsForView

string

Spécifie les autorisations de vue supplémentaires à inclure dans la réponse. Seule l'option published est acceptée.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Liste des autorisations d'un fichier.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "permissions": [
    {
      object (Permission)
    }
  ],
  "nextPageToken": string,
  "kind": string
}
Champs
permissions[]

object (Permission)

Liste des autorisations. Si nextPageToken est renseigné, cette liste peut être incomplète et une page de résultats supplémentaire doit être récupérée.
nextPageToken

string

Jetons de page pour la page suivante d'autorisations. Ce champ est absent si la fin de la liste des autorisations a été atteinte. Si le jeton est refusé pour quelque raison que ce soit, il doit être supprimé et la pagination doit être redémarrée à partir de la première page de résultats. Le jeton de page est généralement valide pendant plusieurs heures. Toutefois, si des éléments sont ajoutés ou supprimés, les résultats attendus peuvent différer.
kind

string

Identifie le type de ressource. Valeur : chaîne fixe "drive#permissionList".

Niveaux d'accès des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • 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

Certains champs d'application sont limités et nécessitent une évaluation de sécurité pour que votre application puisse les utiliser. Pour en savoir plus, consultez le guide d'autorisation.