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 von AccountType PERSONAL ist, 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 100.
pageToken

string

Wenn angegeben, werden die nächsten page von Standorten abgerufen. Das Seitentoken wird bei vorherigen Aufrufen von locations.list zurückgegeben, wenn mehr Speicherorte vorhanden waren, als für die angeforderte Seitengröße möglich waren.
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 (mit Seitenzahlen) für das angeforderte Konto abgerufen.

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

string

Der BCP 47-Code der Sprache, in der die Eigenschaften für den Anzeigestandort abgerufen 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 angegeben.

Verworfen. Nach dem 15. August 2020 ist dieses Feld nicht mehr verfügbar. 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. Standardmäßig wird die Sortierreihenfolge aufsteigend sein. Um eine absteigende Reihenfolge festzulegen, wird ein Suffix " desc" sollte hinzugefügt werden. Gültige Felder für „orderBy“ sind „locationName“ und „storeCode“. Beispiel: „locationName, storeCode desc“ oder „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 keine weiteren Standorte vorhanden sind, ist dieses Feld in der Antwort nicht 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.