Method: accounts.listRecommendGoogleLocations

Alle GoogleLocation auflisten, die dem angegebenen Unternehmensprofil-Konto empfohlen wurden. Empfehlungen werden nur für private Konten und Standortgruppen bereitgestellt. Anfragen für alle anderen Kontotypen führen zu einem Fehler. Die Empfehlungen für Standortgruppen basieren auf den Standorten in dieser Gruppe.

Die Empfehlungen für private Konten basieren auf allen Standorten, auf die der Nutzer im Unternehmensprofil Zugriff hat. Dazu gehören auch Standorte, auf die Nutzer über Standortgruppen zugreifen können. Sie bilden eine Obermenge aller für den Nutzer generierten Empfehlungen.

HTTP-Anfrage

GET https://mybusiness.googleapis.com/v4/{name=accounts/*}:recommendGoogleLocations

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Name der Kontoressource, für die empfohlene Google-Standorte abgerufen werden sollen.

Abfrageparameter

Parameter
pageSize

integer

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

pageToken

string

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

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

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

Antwortnachricht für GoogleLocations.List RecommendedGoogleLocations

Außerdem sind einige Standorte aufgeführt, die seit der letzten Empfehlung für dieses Unternehmensprofil-Konto von anderen Nutzern beansprucht wurden.

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

object (GoogleLocation)

Die für ein Unternehmensprofil-Konto empfohlenen Standorte. Jedes davon steht für ein GoogleLocation, das in Google Maps vorhanden ist. Die Standorte sind in absteigender Reihenfolge nach Relevanz für das Unternehmensprofil-Konto sortiert.

totalSize

integer

Die Gesamtzahl der empfohlenen Standorte für dieses Unternehmensprofil-Konto, unabhängig von der Paginierung.

nextPageToken

string

Wenn während der Paginierung mehr Standorte zum Abrufen auf der nächsten Seite verfügbar sind, wird dieses Feld mit einem Token gefüllt, um bei einem nachfolgenden Aufruf die nächste Seite mit Standorten abzurufen. Wenn es keine weiteren abzurufenden Standorte gibt, ist dieses Feld nicht in der Antwort vorhanden.

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.