Method: permissions.list

Liste les autorisations associées à un fichier ou à un Drive partagé.

Requête HTTP

GET https://www.googleapis.com/drive/v2/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
maxResults

integer

Nombre maximal d'autorisations à renvoyer par page. Si elle n'est pas définie pour les fichiers d'un Drive partagé, 100 résultats maximum sont renvoyés. Si cette règle n'est pas configurée pour des fichiers qui ne se trouvent pas dans un Drive partagé, la liste complète est renvoyée.

pageToken

string

Jeton permettant de poursuivre une requête de liste précédente sur la page suivante. Il doit être défini sur la valeur de nextPageToken issue de la réponse précédente.

supportsAllDrives

boolean

Indique si l'application à l'origine de la demande est compatible avec Mon Drive et les Drive partagés.

supportsTeamDrives
(deprecated)

boolean

Obsolète: utilisez plutôt supportsAllDrives.

useDomainAdminAccess

boolean

Effectuez la demande en tant qu'administrateur de domaine. Si cette règle est définie sur "true", le demandeur obtient l'accès si le paramètre d'ID de fichier fait référence à un Drive partagé et que le demandeur est un administrateur du domaine auquel appartient le Drive partagé.

includePermissionsForView

string

Spécifie les autorisations de vue supplémentaires à inclure dans la réponse. Seule la fonctionnalité published est prise en charge.

Corps de la requête

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

Corps de la réponse

Liste des autorisations associées à 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
{
  "nextPageToken": string,
  "kind": string,
  "etag": string,
  "selfLink": string,
  "items": [
    {
      object (Permission)
    }
  ]
}
Champs
nextPageToken

string

Jeton de page pour la page d'autorisations suivante. Ce champ sera absent si la fin de la liste des autorisations est atteinte. Si le jeton est refusé pour une raison quelconque, il doit être supprimé et la pagination doit être redémarrée à partir de la première page de résultats.

kind

string

Il s'agit toujours de drive#permissionList.

etag

string

ETag de la liste.

items[]

object (Permission)

Liste des autorisations.

Champs d'application des autorisations

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

  • https://www.googleapis.com/auth/docs
  • 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 restreints et nécessitent une évaluation de sécurité pour que votre application puisse les utiliser. Pour en savoir plus, consultez le Guide relatif aux autorisations.