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, über das eine Liste mit 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 Orten, für die Rezensionen abgerufen werden sollen, die anhand ihrer Namen angegeben werden.

pageSize

integer

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

pageToken

string

Wenn angegeben, wird die nächste Seite mit Rezensionen abgerufen.

orderBy

string

Optional. Gibt das Feld an, nach dem Rezensionen sortiert werden sollen. Wenn keine Vorgabe erfolgt, wird die Reihenfolge der zurückgegebenen Rezensionen standardmäßig auf updateTime desc gesetzt. Gültige Reihenfolgen für das Sortieren sind rating, rating desc und updateTime desc. Bei rating werden Rezensionen in aufsteigender Reihenfolge zurückgegeben. updateTime(d.h. aufsteigende Reihenfolge) wird nicht unterstützt.

ignoreRatingOnlyReviews

boolean

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

Antworttext

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

Antwortnachricht für Reviews.BatchGetReviews.

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 überschreitet, wird dieses Feld mit einem Token gefüllt, um bei nachfolgenden Aufrufen die nächste Seite mit Rezensionen abzurufen. Wenn es keine weiteren Rezensionen gibt, 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 in der Übersicht über OAuth 2.0.

LocationReview

Stellt eine Rezension mit Standortinformationen dar.

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

string

Name der Standortressource.

review

object (Review)

Eine Rezension für den Standort.