Method: accounts.locations.reviews.list

Restituisce l'elenco paginato delle recensioni per la sede specificata. Questa operazione è valida solo se la sede 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

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

pageToken

string

Se specificato, recupera la pagina successiva di recensioni.

orderBy

string

Specifica il campo in base al quale ordinare le recensioni. Se non specificato, l'ordine delle recensioni restituite sarà updateTime desc per impostazione predefinita. 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

Messaggio di risposta per Reviews.ListReviews.

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

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 sede su una scala da 1 a 5, dove 5 è la valutazione più alta.

totalReviewCount

integer

Il numero totale di recensioni per questa sede.

nextPageToken

string

Se il numero di recensioni ha superato le dimensioni della 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 sono presenti 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 saperne di più, consulta la OAuth 2.0 Overview.