Method: accounts.locations.reviews.list

Muestra la lista paginada de opiniones de 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 de acceso

Parámetros
parent

string

Es el nombre de la ubicación sobre la que se deben recuperar las opiniones.

Parámetros de consulta

Parámetros
pageSize

integer

Cantidad de opiniones que se deben recuperar por página. La cantidad máxima de pageSize es 50.
pageToken

string

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

string

Especifica el campo según el que se deben ordenar las opiniones. Si no se especifica, el orden de las opiniones que se muestran se establecerá de forma predeterminada en updateTime desc. Los pedidos 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

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

Mensaje de respuesta a Reviews.ListReviews.

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

object (Review)

Las opiniones.
averageRating

number

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

integer

La cantidad total de opiniones sobre esta ubicación.
nextPageToken

string

Si la cantidad de opiniones supera el tamaño de página solicitado, este campo se propaga con un token para recuperar la siguiente página de opiniones en una llamada posterior a reviews.list. Si no hay más opiniones, significa que este campo no aparece en la respuesta.

Alcances de la autorización

Se necesita uno de los siguientes alcances de OAuth:

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

Para obtener más información, consulta la Descripción general de OAuth 2.0.