Method: accounts.locations.reviews.list

Devuelve la lista paginada de opiniones para la ubicación especificada. Esta operación solo es válida si se verifica la ubicación especificada.

Solicitud HTTP

GET https://mybusiness.googleapis.com/v4/{parent=accounts/*/locations/*}/reviews

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
parent

string

Es el nombre de la ubicación para la que se recuperarán las opiniones.

Parámetros de consulta

Parámetros
pageSize

integer

Cantidad de opiniones que se recuperarán por página. El valor máximo de pageSize es 50.
pageToken

string

Si se especifica, recupera la siguiente página de opiniones.
orderBy

string

Especifica el campo por el que se ordenarán las opiniones. Si no se especifica, el orden de las opiniones devueltas se establecerá de forma predeterminada como updateTime desc. Los órdenes válidos para ordenar son rating, rating desc y updateTime desc.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Es el mensaje de respuesta para Reviews.ListReviews.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "averageRating": number,
  "totalReviewCount": integer,
  "nextPageToken": string
}
Campos
reviews[]

object (Review)

Las opiniones
averageRating

number

Es la calificación promedio por estrellas de todas las opiniones sobre esta ubicación en una escala del 1 al 5, en la que 5 es la calificación más alta.
totalReviewCount

integer

Es la cantidad total de opiniones sobre esta ubicación.
nextPageToken

string

Si la cantidad de opiniones superó el tamaño de página solicitado, este campo se completará con un token para recuperar la siguiente página de opiniones en una llamada posterior a reviews.list. Si no hay más opiniones, este campo no estará presente en la respuesta.

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Para obtener más información, consulta OAuth 2.0 Overview.