Method: accounts.locations.batchGetReviews

Retorna a lista paginada de avaliações de todos os locais especificados. Esta operação só será válida se os locais especificados forem verificados.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
name

string

O nome da conta de que será extraída uma lista de avaliações em vários locais.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "locationNames": [
    string
  ],
  "pageSize": integer,
  "pageToken": string,
  "orderBy": string,
  "ignoreRatingOnlyReviews": boolean
}
Campos
locationNames[]

string

Uma coleção de locais para os quais as avaliações serão buscadas, especificados pelos nomes.
pageSize

integer

O número de avaliações a serem buscadas por página. O valor padrão é 50.
pageToken

string

Se especificado, busca a próxima página de avaliações.
orderBy

string

Opcional. Especifica o campo pelo qual as avaliações serão classificadas. Se não for especificado, a ordem das avaliações retornadas será padronizada como updateTime desc. Os pedidos válidos pelos quais será feita a classificação são rating, rating desc e updateTime desc. rating vai retornar as avaliações em ordem crescente. updateTime(ou seja, ordem crescente) não é compatível.
ignoreRatingOnlyReviews
(deprecated)

boolean

Define se as avaliações que mostram somente notas com estrelas serão ignoradas.

Corpo da resposta

Mensagem da resposta para "Reviews.BatchGetReviews".

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "locationReviews": [
    {
      object (LocationReview)
    }
  ],
  "nextPageToken": string
}
Campos
locationReviews[]

object (LocationReview)

Avaliações com informações de local.
nextPageToken

string

Se o número de avaliações exceder o tamanho solicitado da página, esse campo será preenchido com um token para buscar a próxima página de avaliações em uma chamada subsequente. Se não houver mais avaliações, este campo não estará presente na resposta.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para mais informações, consulte OAuth 2.0 Overview.

LocationReview

Representa uma avaliação com informações de local.

Representação JSON 
{
  "name": string,
  "review": {
    object (Review)
  }
}
Campos
name

string

Nome do recurso de local.
review

object (Review)

Uma avaliação do local.