Method: accounts.locations.batchGetReviews

Retorna a lista paginada de avaliações de todos os locais especificados. Essa operação só é 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 da qual recuperar 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

Um conjunto de locais para os quais será buscada avaliações, especificados pelos seus nomes.

pageSize

integer

Quantas avaliações serão 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 são classificadas. Se não for especificada, a ordem das avaliações retornadas será padrão como updateTime desc. Os pedidos válidos pelos quais fazer a classificação são rating, rating desc e updateTime desc. rating vai retornar avaliações em ordem crescente. updateTime(ou seja, ordem crescente) não é compatível.

ignoreRatingOnlyReviews

boolean

Define se as avaliações somente para nota devem ser ignoradas.

Corpo da resposta

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

Mensagem de resposta para Reviews.BatchGetReviews.

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 da página solicitado, esse campo será preenchido com um token para buscar a próxima página de avaliações em chamadas subsequentes. 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 a Visão geral do OAuth 2.0.

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.