Method: accounts.locations.findMatches

Trova tutte le possibili località corrispondenti 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 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, se vengono richieste altre, la latenza può aumentare. Non è prevista l'impaginazione.
maxCacheDuration

string (Duration format)

Deprecato. Questo campo viene ignorato per tutte le richieste.

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à che potrebbero corrispondere alla località specificata, ordinate dalla migliore alla meno corrispondente. Se c'è una corrispondenza esatta, l'annuncio si trova nella prima posizione.
matchTime

string (Timestamp format)

Data/ora dell'ultima esecuzione dell'algoritmo di corrispondenza per questa località.

Un timestamp nel formato RFC3339 UTC "Zulu" 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à con pochi dati che rappresenta una potenziale corrispondenza. I campi non compilati includono, a titolo esemplificativo: nome (la località corrispondente non può essere recuperata tramite locations.get o locations.batchGet); storeCode; Dettagli sull'area di copertura: serviceArea; labels; adWordsLocationExtensions; photos
isExactMatch

boolean

Si tratta di una corrispondenza esatta?