Method: accounts.locations.findMatches

Belirtilen konumla eşleşen tüm olası konumları bulur. Bu işlem yalnızca konum doğrulanmamışsa geçerlidir.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
name

string

Eşleşmelerin bulunacağı konumun kaynak adı.

İstek içeriği

İstek gövdesi, aşağıdaki yapıya sahip verileri içerir:

JSON gösterimi 
{
  "languageCode": string,
  "numResults": integer,
  "maxCacheDuration": string
}
Alanlar
languageCode

string

Eşleşen konum için tercih edilen dil (BCP-47 biçiminde).
numResults

integer

Döndürülecek eşleşme sayısı. Varsayılan değer 3, maksimum 10'dur. Daha fazla veri istenirse gecikmenin artabileceğini unutmayın. Sayfalara ayırma işlemi yapılmaz.
maxCacheDuration

string (Duration format)

Kullanımdan kaldırıldı. Bu alan tüm istekler için yoksayılır.

En fazla dokuz kesirli basamağa sahip, "s" ile sonlandırılmış, saniye cinsinden süre. Örnek: "3.5s".

Yanıt gövdesi

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

locations.FindMatchingLocations için yanıt iletisi.

JSON gösterimi 
{
  "matchedLocations": [
    {
      object (MatchedLocation)
    }
  ],
  "matchTime": string
}
Alanlar
matchedLocations[]

object (MatchedLocation)

Belirtilen konumla potansiyel eşleşmeler olan konumların toplamı, en iyiden en az eşleşmeye doğru sıralanır. Tam eşleşme varsa ilk konumda olur.
matchTime

string (Timestamp format)

Eşleştirme algoritmasının bu konum için en son ne zaman yürütüldüğü.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

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

Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.

MatchedLocation

Bir konumla olası bir eşleşmeyi gösterir.

JSON gösterimi 
{
  "location": {
    object (Location)
  },
  "isExactMatch": boolean
}
Alanlar
location

object (Location)

Potansiyel bir eşleşme olan seyrek nüfuslu konum. Doldurulmayan alanlar şunları içerir ancak bunlarla sınırlı olmayabilir: ad (eşleşen yer locations.get veya locations.batchGet yoluyla alınamaz); storeCode; serviceArea kapsama alanı ayrıntıları; labels; adWordsLocationExtensions; photos
isExactMatch

boolean

Bu tam bir eşleşme mi?