Method: accounts.locations.batchGetReviews

Muestra la lista paginada de opiniones de todas las ubicaciones especificadas. Esta operación solo es válida si se verifican las ubicaciones especificadas.

Solicitud HTTP

POST https://mybusiness.googleapis.com/v4/{name=accounts/*}/locations:batchGetReviews

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

Parámetros de ruta de acceso

Parámetros
name

string

El nombre de la cuenta desde la que se obtiene una lista de opiniones de varias ubicaciones.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "locationNames": [
    string
  ],
  "pageSize": integer,
  "pageToken": string,
  "orderBy": string,
  "ignoreRatingOnlyReviews": boolean
}
Campos
locationNames[]

string

Es un conjunto de ubicaciones para las cuales recuperar opiniones, especificadas por sus nombres.
pageSize

integer

Cantidad de opiniones que se deben recuperar por página. El valor predeterminado es 50.
pageToken

string

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

string

Opcional. 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. rating mostrará opiniones en orden ascendente. updateTime(es decir, orden ascendente) no es compatible.
ignoreRatingOnlyReviews

boolean

Indica si se deben ignorar las opiniones de solo calificación.

Cuerpo de la respuesta

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

Mensaje de respuesta para Reviews.BatchGetReviews.

Representación JSON 
{
  "locationReviews": [
    {
      object (LocationReview)
    }
  ],
  "nextPageToken": string
}
Campos
locationReviews[]

object (LocationReview)

Opiniones con información sobre la ubicación.
nextPageToken

string

Si la cantidad de opiniones supera el tamaño de la página solicitada, este campo se propaga con un token para recuperar la siguiente página de opiniones en llamadas posteriores. Si no hay más opiniones, este campo no aparecerá 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.

LocationReview

Representa una opinión con información de la ubicación.

Representación JSON 
{
  "name": string,
  "review": {
    object (Review)
  }
}
Campos
name

string

Es el nombre del recurso de ubicación.
review

object (Review)

Es una opinión sobre la ubicación.