Method: accounts.locations.findMatches

Trova tutte le possibili località che corrispondono alla località specificata. Questa operazione è valida solo se la sede non è verificata.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
name

string

Il nome della risorsa della località per cui trovare le corrispondenze.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "languageCode": string,
  "numResults": integer,
  "maxCacheDuration": string
}
Campi
languageCode

string

La lingua preferita per la località corrispondente (nel formato BCP-47).
numResults

integer

Il numero di corrispondenze da restituire. Il valore predefinito è 3, con un massimo di 10. Tieni presente che la latenza può aumentare se ne vengono richieste di più. Non è prevista l'impaginazione.
maxCacheDuration

string (Duration format)

Deprecato. Questo campo viene ignorato per tutte le richieste.

Una durata in secondi con un massimo di nove cifre frazionarie, terminata da "s". Esempio: "3.5s".

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Messaggio di risposta per locations.FindMatchingLocations.

Rappresentazione JSON 
{
  "matchedLocations": [
    {
      object (MatchedLocation)
    }
  ],
  "matchTime": string
}
Campi
matchedLocations[]

object (MatchedLocation)

Un insieme di località potenzialmente corrispondenti alla località specificata, elencate in ordine di corrispondenza dalla migliore alla meno. Se esiste una corrispondenza esatta, sarà nella prima posizione.
matchTime

string (Timestamp format)

La data in cui l'algoritmo di corrispondenza è stato eseguito l'ultima volta per questa località.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.

MatchedLocation

Rappresenta una possibile corrispondenza con una località.

Rappresentazione JSON 
{
  "location": {
    object (Location)
  },
  "isExactMatch": boolean
}
Campi
location

object (Location)

La località scarsamente popolata che rappresenta una potenziale corrispondenza. I campi non compilati includono, a titolo esemplificativo: nome (la località corrispondente non può essere recuperata tramite locations.get né locations.batchGet); storeCode; serviceArea dettagli dell'area di copertura; labels; adWordsLocationExtensions; photos
isExactMatch

boolean

Si tratta di una corrispondenza esatta?