Method: publishers.items.fetchReviews

Récupérer les avis des utilisateurs sur un article.

Requête HTTP

GET https://chromewebstore.googleapis.com/v2/{name=publishers/*/items/*}:fetchReviews

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
name

string

Obligatoire. Nom de ressource de l'élément dont les avis sont récupérés. Format : publishers/{publisher_id}/items/{itemId}

Paramètres de requête

Paramètres
pageSize

integer

Facultatif. Nombre maximal d'avis à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, la recherche affiche 50 avis au maximum. La valeur maximale est 200. Les valeurs supérieures sont réduites à 200.
pageToken

string

Facultatif. Jeton de page reçu d'un appel items.fetchReviews précédent. Fournissez-le pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis à items.fetchReviews doivent correspondre à l'appel ayant fourni le jeton de page.
filter

string

Facultatif. Filtre à appliquer aux avis. Seule la comparaison d'égalité sur la note est acceptée, par exemple rating = 5.
orderBy

string

Facultatif. Liste facultative de champs par lesquels trier les résultats, séparés par une virgule. L'ordre de tri par défaut est croissant (asc). Les champs compatibles sont les suivants : - rating : les ordres compatibles sont asc (par défaut) et desc. - createTime : seule la valeur desc (le plus récent en premier) est acceptée. desc doit être explicitement spécifié, car la valeur par défaut est asc. Exemple : rating desc, createTime desc ou rating desc, createTime desc.

Corps de la requête

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

Corps de la réponse

Message de réponse pour items.fetchReviews.

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

Représentation JSON 
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "nextPageToken": string
}
Champs
reviews[]

object (Review)

Liste des avis.
nextPageToken

string

Jeton pouvant être envoyé en tant que pageToken pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

Champs d'application des autorisations

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

  • https://www.googleapis.com/auth/chromewebstore
  • https://www.googleapis.com/auth/chromewebstore.readonly

Récapitulatif

Avis rédigé par un utilisateur pour évaluer un élément du Chrome Web Store.

Représentation JSON 
{
  "name": string,
  "item": string,
  "authorInfo": {
    object (AuthorInfo)
  },
  "rating": integer,
  "comment": string,
  "createTime": string
}
Champs
name

string

Identifiant. Nom de la ressource d'avis. Format : reviews/{reviewId}
item

string

Uniquement en sortie. Élément évalué par cet avis. Format : publishers/{publisher}/items/{item}
authorInfo

object (AuthorInfo)

Informations sur l'auteur de l'avis.
rating

integer

Note de l'article, comprise entre 1 et 5.
comment

string

Contenu de l'avis.
createTime

string (Timestamp format)

Uniquement en sortie. Date de publication de l'avis.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

AuthorInfo

Informations sur l'auteur de l'avis.

Représentation JSON 
{
  "displayName": string
}
Champs
displayName

string

Nom à afficher de l'auteur.