Method: accounts.locations.list

Listet die Standorte für das angegebene Konto auf.

HTTP-Anfrage

GET https://mybusinessbusinessinformation.googleapis.com/v1/{parent=accounts/*}/locations

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Der Name des Kontos, aus dem Standorte abgerufen werden sollen. Wenn der Elternteil [Account] [google.mybusiness.accountmanagement.v1.Account] ist vom Typ [AccountType]. [google.mybusiness.accountmanagement.v1.Account.AccountType] PERSONAL: Es 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

Optional. Die Anzahl der Standorte, die pro Seite abgerufen werden sollen. Wenn nicht festgelegt, ist der Standardwert 10. Der Mindestwert ist 1 und die maximale Seitengröße 100.
pageToken

string

Optional. 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

Optional. 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.
orderBy

string

Optional. 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 „title“ und „storeCode“. Beispiel: „title, storeCode desc“ oder „title“ oder „storeCode desc“
readMask

string (FieldMask format)

Erforderlich. Lesemaske, um anzugeben, welche Felder in der Antwort zurückgegeben werden.

Dies ist eine durch Kommas getrennte Liste vollständig qualifizierter Feldnamen. Beispiel: "user.displayName,photo".

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwortnachricht für Locations.ListLocations

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

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. Dieses Feld wird nur zurückgegeben, wenn filter als Abfrageparameter verwendet wird.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.