Method: accounts.locations.list

Listet die Standorte für das angegebene Konto auf.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Der Name des Kontos, aus dem Standorte abgerufen werden sollen. Wenn Account den Wert AccountType PERSONAL hat, werden nur Standorte zurückgegeben, die direkt zum Konto gehören. Andernfalls werden alle über das Konto zugänglichen Standorte zurückgegeben, entweder direkt oder indirekt.

Abfrageparameter

Parameter
pageSize

integer

Die Anzahl der Standorte, die pro Seite abgerufen werden sollen. Die Standardeinstellung ist 100, die Mindestanzahl ist 1 und die maximale Seitengröße beträgt 100.
pageToken

string

Wenn angegeben, werden die nächsten page Standorte abgerufen. Das Seitentoken wird von vorherigen Aufrufen von locations.list zurückgegeben, wenn mehr Positionen vorhanden waren, als in die angeforderte Seitengröße passen konnten.
filter

string

Ein Filter, der die zurückzugebenden Standorte einschränkt. Die Antwort enthält nur Einträge, die dem Filter entsprechen. Wenn filter leer ist, werden Einschränkungen angewendet und alle Standorte (paginiert) für das angeforderte Konto abgerufen.

Weitere Informationen zu gültigen Feldern und Verwendungsbeispiele finden Sie im Leitfaden zur Verwendung von Standortdaten.
languageCode
(deprecated)

string

Der BCP-47-Code für die Sprache, in der Standorteigenschaften angezeigt werden sollen. Wenn diese Sprache nicht verfügbar ist, werden sie in der Sprache des Standorts angegeben. Wenn keines von beiden verfügbar ist, werden sie auf Englisch bereitgestellt.

Veraltet. Nach dem 15. August 2020 wird dieses Feld nicht mehr verwendet. Stattdessen wird immer die Sprache des Standorts verwendet.
orderBy

string

Sortierreihenfolge für die Anfrage. Mehrere Felder sollten gemäß der SQL-Syntax durch Kommas getrennt werden. Die Standardsortierreihenfolge ist aufsteigend. Zur Angabe der absteigenden Reihenfolge muss das Suffix " desc" hinzugefügt werden. Gültige Felder für „orderBy“ sind „locationName“ und „storeCode“. Beispiel: „locationName, storeCode desc“, „locationName“ oder „storeCode desc“

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

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

Antwortnachricht für Locations.ListLocations

JSON-Darstellung 
{
  "locations": [
    {
      object (Location)
    }
  ],
  "nextPageToken": string,
  "totalSize": integer
}
Felder
locations[]

object (Location)

Die Standorte.
nextPageToken

string

Wenn die Anzahl der Standorte die angeforderte Seitengröße überschreitet, wird dieses Feld mit einem Token gefüllt, um bei einem nachfolgenden Aufruf von locations.list die nächste Seite mit Standorten abzurufen. Wenn es keine weiteren Standorte gibt, ist dieses Feld nicht in der Antwort vorhanden.
totalSize

integer

Die ungefähre Anzahl der Standorte in der Liste, unabhängig von der Paginierung.

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.