Method: accounts.locations.reviews.list

Retorna a lista paginada de avaliações do local especificado. Esta operação só é válida se o local especificado for verificado.

Solicitação HTTP

GET https://mybusiness.googleapis.com/v4/{parent=accounts/*/locations/*}/reviews

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

Parâmetros de caminho

Parâmetros
parent

string

O nome do local para o qual as avaliações serão buscadas.

Parâmetros de consulta

Parâmetros
pageSize

integer

Quantas avaliações precisam ser buscadas por página. O pageSize máximo é 50.
pageToken

string

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

string

Especifica o campo pelo qual as avaliações serão classificadas. Se não for especificada, a ordem das avaliações retornadas será updateTime desc por padrão. Os pedidos válidos para classificação são rating, rating desc e updateTime desc.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

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

Mensagem de resposta para Reviews.ListReviews.

Representação JSON 
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "averageRating": number,
  "totalReviewCount": integer,
  "nextPageToken": string
}
Campos
reviews[]

object (Review)

As avaliações.
averageRating

number

Nota média de todas as avaliações desse local em uma escala de 1 a 5, em que 5 é a nota mais alta.
totalReviewCount

integer

O número total de avaliações para esse 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 para reviews.list. Se não houver mais avaliações, este campo não estará presente na resposta.

Escopos de autorização

Requer um dos seguintes escopos de 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.