Method: accounts.locations.findMatches

Findet alle möglichen Standorte, die mit dem angegebenen Standort übereinstimmen. Dieser Vorgang ist nur gültig, wenn der Standort nicht bestätigt ist.

HTTP-Anfrage

POST https://mybusiness.googleapis.com/v4/{name=accounts/*/locations/*}:findMatches

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Der Ressourcenname des Standorts, für den Übereinstimmungen gesucht werden sollen.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "languageCode": string,
  "numResults": integer,
  "maxCacheDuration": string
}
Felder
languageCode

string

Die bevorzugte Sprache für den entsprechenden Standort (im BCP-47-Format).
numResults

integer

Die Anzahl der zurückzugebenden Übereinstimmungen. Der Standardwert ist 3, der Höchstwert ist 10. Die Latenz kann sich erhöhen, wenn mehr angefordert werden. Es gibt keine Paginierung.
maxCacheDuration

string (Duration format)

Verworfen. Dieses Feld wird bei allen Anfragen ignoriert.

Dauer in Sekunden mit bis zu neun Nachkommastellen und einem 's' an letzter Stelle. Beispiel: "3.5s".

Antworttext

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

Antwortnachricht für Locations.FindMatchingLocations

JSON-Darstellung 
{
  "matchedLocations": [
    {
      object (MatchedLocation)
    }
  ],
  "matchTime": string
}
Felder
matchedLocations[]

object (MatchedLocation)

Eine Sammlung von Standorten, die potenzielle Übereinstimmungen mit dem angegebenen Standort darstellen. Diese werden in absteigender Reihenfolge aufgelistet. Gibt es eine genaue Übereinstimmung, wird sie an der ersten Position platziert.
matchTime

string (Timestamp format)

Wann der Abgleichsalgorithmus zuletzt für diesen Standort ausgeführt wurde.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

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.

MatchedLocation

Stellt eine mögliche Übereinstimmung mit einem Standort dar.

JSON-Darstellung 
{
  "location": {
    object (Location)
  },
  "isExactMatch": boolean
}
Felder
location

object (Location)

Der dünnbesetzte Standort, der eine potenzielle Übereinstimmung darstellt. Zu den nicht ausgefüllten Feldern gehören unter anderem: name (der übereinstimmende Standort kann nicht über locations.get oder locations.batchGet abgerufen werden); storeCode; Details zum Abdeckungsbereich serviceArea; labels; adWordsLocationExtensions; photos
isExactMatch

boolean

Stimmt das genau überein?