Method: approvals.list

Affiche la liste des approbations d'un fichier. Pour en savoir plus, consultez Gérer les approbations.

Par défaut, cette méthode renvoie une réponse minimale qui peut ne pas inclure le tableau items. Pour récupérer les détails de l'approbation, vous devez spécifier explicitement les champs souhaités à l'aide du paramètre de requête fields. Pour renvoyer les champs exacts dont vous avez besoin, consultez la section Renvoyer des champs spécifiques.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
fileId

string

Obligatoire. ID du fichier sur lequel porte l'approbation.

Paramètres de requête

Paramètres
pageSize

integer

Nombre maximal d'approbations à afficher. Si aucune valeur n'est définie, 100 approbations au maximum sont renvoyées.
pageToken

string

Jeton 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 d'une réponse précédente.

Corps de la requête

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

Corps de la réponse

Réponse à une requête de liste d'approbations.

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

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

string

Il s'agit toujours de drive#approvalList
items[]

object (Approval)

Liste des approbations. 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

Jeton de page pour la page suivante des approbations. Ce paramètre est absent si la fin de la liste des approbations 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.

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.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

Certains niveaux d'accès 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 l'autorisation.