Method: accounts.locations.reviews.list

Restituisce l'elenco impaginato delle recensioni per la sede specificata. Questa operazione è valida solo se la località specificata è 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 sede per cui recuperare le recensioni.

Parametri di query

Parametri
pageSize

integer

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

string

Se specificato, consente di recuperare la pagina successiva di recensioni.
orderBy

string

Specifica il campo in base al quale ordinare le recensioni. Se non viene specificato, l'ordine delle recensioni restituite verrà impostato sul valore predefinito updateTime desc. Gli ordini validi per l'ordinamento 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 recensioni supera le dimensioni di pagina richieste, questo campo viene compilato con un token per recuperare la pagina successiva di recensioni in una chiamata successiva a reviews.list. Se non ci sono altre recensioni, 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.