Method: accounts.locations.reviews.list

Restituisce l'elenco impaginato delle recensioni per la località specificata. Questa operazione è valida solo se la sede specificata è stata verificata.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Il nome della località per la quale recuperare le recensioni.

Parametri di ricerca

Parametri
pageSize

integer

Il numero di recensioni da recuperare per pagina. Il numero massimo di pageSize è 50.
pageToken

string

Se specificato, recupera la pagina successiva delle recensioni.
orderBy

string

Specifica il campo in base al quale ordinare le recensioni. Se il criterio non è specificato, l'ordine delle recensioni restituite verrà impostato in modo predefinito su updateTime desc. Gli ordini validi per ordinare in base sono rating, rating desc e updateTime desc.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Messaggio di risposta per Reviews.ListReviews.

Rappresentazione JSON 
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "averageRating": number,
  "totalReviewCount": integer,
  "nextPageToken": string
}
Campi
reviews[]

object (Review)

Le recensioni.
averageRating

number

La valutazione a stelle media di tutte le recensioni per questa località su una scala da 1 a 5, dove 5 è la valutazione più alta.
totalReviewCount

integer

Il numero totale di recensioni per questa località.
nextPageToken

string

Se il numero di revisioni supera le dimensioni di pagina richieste, questo campo viene compilato con un token per recuperare la pagina successiva di recensioni in una successiva chiamata a reviews.list. Se non ci sono altre revisioni, questo campo non è presente nella risposta.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.