Method: comments.list

Répertorie les commentaires d'un fichier.

Requête HTTP

GET https://www.googleapis.com/drive/v2/files/{fileId}/comments

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
fileId

string

ID du fichier.

Paramètres de requête

Paramètres
includeDeleted

boolean

Si cette valeur est définie, tous les commentaires et réponses, y compris les commentaires et réponses supprimés (avec le contenu supprimé), sont renvoyés.
maxResults

integer

Nombre maximal de discussions à inclure dans la réponse, utilisé pour la pagination.
pageToken

string

Jeton de continuité servant à parcourir les ensembles de résultats volumineux. Pour obtenir la page de résultats suivante, définissez ce paramètre sur la valeur de "nextPageToken" de la réponse précédente.
updatedMin

string

Seules les discussions mises à jour après ce code temporel seront renvoyées. Formaté en tant que code temporel RFC 3339.

Corps de la requête

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

Corps de la réponse

Liste des commentaires sur un fichier dans Google Drive.

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,
  "selfLink": string,
  "nextLink": string,
  "items": [
    {
      object (Comment)
    }
  ],
  "nextPageToken": string
}
Champs
kind

string

Cette valeur est toujours drive#commentList.
items[]

object (Comment)

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

string

Jeton de page pour la page de commentaires suivante. Il n'est pas présent si la fin de la liste des commentaires 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.

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

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