Method: accounts.locations.batchGetReviews

Gibt die paginierte Liste mit Rezensionen für alle angegebenen Standorte zurück. Dieser Vorgang ist nur gültig, wenn die angegebenen Standorte bestätigt wurden.

HTTP-Anfrage

POST https://mybusiness.googleapis.com/v4/{name=accounts/*}/locations:batchGetReviews

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Der Name des Kontos, aus dem eine Liste von Rezensionen für mehrere Standorte abgerufen werden soll.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung
{
  "locationNames": [
    string
  ],
  "pageSize": integer,
  "pageToken": string,
  "orderBy": string,
  "ignoreRatingOnlyReviews": boolean
}
Felder
locationNames[]

string

Eine Sammlung von Standorten, für die Rezensionen abgerufen werden sollen, angegeben durch ihre Namen.

pageSize

integer

Die Anzahl der abzurufenden Rezensionen pro Seite. Der Standardwert ist 50.

pageToken

string

Falls angegeben, wird die nächste Seite von Rezensionen abgerufen.

orderBy

string

Optional. Gibt das Feld an, nach dem Rezensionen sortiert werden sollen. Wenn nichts angegeben ist, wird die Reihenfolge der zurückgegebenen Rezensionen standardmäßig auf updateTime desc gesetzt. Zulässige Reihenfolgen zum Sortieren sind rating, rating desc und updateTime desc. Mit rating werden Rezensionen in aufsteigender Reihenfolge zurückgegeben. updateTime(aufsteigende Reihenfolge) wird nicht unterstützt.

ignoreRatingOnlyReviews
(deprecated)

boolean

Gibt an, ob Rezensionen, die nur eine Bewertung enthalten, ignoriert werden sollen.

Antworttext

Antwortnachricht für Reviews.BatchGetReviews

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung
{
  "locationReviews": [
    {
      object (LocationReview)
    }
  ],
  "nextPageToken": string
}
Felder
locationReviews[]

object (LocationReview)

Rezensionen mit Standortinformationen.

nextPageToken

string

Wenn die Anzahl der Rezensionen die angeforderte Seitengröße überschritten hat, wird dieses Feld mit einem Token gefüllt, um die nächste Seite mit Rezensionen für einen nachfolgenden Aufruf abzurufen. Wenn keine weiteren Rezensionen vorhanden sind, ist dieses Feld nicht in der Antwort enthalten.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter OAuth 2.0 Overview.

LocationReview

Stellt eine Rezension mit Standortinformationen dar.

JSON-Darstellung
{
  "name": string,
  "review": {
    object (Review)
  }
}
Felder
name

string

Ressourcenname des Standorts.

review

object (Review)

Eine Rezension für den Standort.