Method: accounts.locations.batchGetReviews

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

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

Parámetros
name

string

Es el nombre de la cuenta desde la que se recuperará una lista de opiniones en 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 una colección de ubicaciones para las que se recuperarán opiniones, especificadas por sus nombres.
pageSize

integer

Es la cantidad de opiniones que se recuperarán por página. El valor predeterminado es 50.
pageToken

string

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

string

Es opcional. Especifica el campo por el que se ordenarán las opiniones. Si no se especifica, el orden de las opiniones que se muestran se establecerá de forma predeterminada como updateTime desc. Los órdenes válidos para ordenar son rating, rating desc y updateTime desc. rating mostrará las opiniones en orden ascendente. No se admite updateTime(es decir, orden ascendente).
ignoreRatingOnlyReviews
(deprecated)

boolean

Indica si se deben ignorar las opiniones que solo tienen calificaciones.

Cuerpo de la respuesta

Es el mensaje de respuesta de Reviews.BatchGetReviews.

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

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

object (LocationReview)

Opiniones con información de ubicación.
nextPageToken

string

Si la cantidad de opiniones excede el tamaño de página solicitado, este campo se propagará con un token para recuperar la siguiente página de opiniones en llamadas posteriores. 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.

LocationReview

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

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

string

Es el nombre de recurso de la ubicación.
review

object (Review)

Es una opinión sobre la ubicación.