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 bei einem Maximum von 10. Beachten Sie, dass die Latenz zunehmen kann, wenn mehr angefordert werden. Es gibt keine Paginierung.
maxCacheDuration

string (Duration format)

Veraltet. 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 mit dem angegebenen Standort potenziell übereinstimmen. Die Standorte sind in absteigender Reihenfolge aufgelistet. Gibt es eine genaue Übereinstimmung, wird sie an erster Position angezeigt.
matchTime

string (Timestamp format)

Zeitpunkt, zu dem der Übereinstimmungsalgorithmus zuletzt für diesen Standort ausgeführt wurde.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung 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: 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?