Method: permissions.list

Répertorie les autorisations pour un fichier ou un Drive partagé.

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

L'ID du fichier ou du Drive partagé

Paramètres de requête

Paramètres
pageSize

integer

Nombre maximal d'autorisations à afficher par page. Lorsque aucun fichier n'est défini pour un Drive partagé, il renvoie 100 résultats au maximum. Si elle n'est pas configurée pour les fichiers qui ne figurent pas dans un Drive partagé, toute la liste 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" 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

Émettez la requête en tant qu'administrateur de domaine. Si cette règle est définie sur "true", l'utilisateur à l'origine de la demande est autorisé à accéder aux fichiers si le paramètre d'ID du fichier fait référence à un Drive partagé et si le demandeur est un administrateur du domaine auquel le Drive partagé appartient.

includePermissionsForView

string

Spécifie les autorisations supplémentaires de la vue à inclure dans la réponse. Seul "publié" est accepté.

Corps de la requête

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

Corps de la réponse

Liste des autorisations pour 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,
  "permissions": [
    {
      object (Permission)
    }
  ]
}
Champs
nextPageToken

string

Jeton de page pour la page d'autorisations suivante. Ce champ est absent si la fin de la liste des autorisations a été 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. Le jeton de page est généralement valide pendant plusieurs heures. Cependant, si de nouveaux éléments sont ajoutés ou supprimés, les résultats attendus peuvent différer.

kind

string

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

permissions[]

object (Permission)

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

Champs d'application 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.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 sur les autorisations.