REST Resource: locations

Kaynak: Konum

Bir konum. Bu alanların ayrıntılı bir açıklaması için Yardım Merkezi makalesini, geçerli işletme kategorilerinin listesi için kategori uç noktasını inceleyin.

JSON gösterimi
{
  "name": string,
  "languageCode": string,
  "storeCode": string,
  "title": string,
  "phoneNumbers": {
    object (PhoneNumbers)
  },
  "categories": {
    object (Categories)
  },
  "storefrontAddress": {
    object (PostalAddress)
  },
  "websiteUri": string,
  "regularHours": {
    object (BusinessHours)
  },
  "specialHours": {
    object (SpecialHours)
  },
  "serviceArea": {
    object (ServiceAreaBusiness)
  },
  "labels": [
    string
  ],
  "adWordsLocationExtensions": {
    object (AdWordsLocationExtensions)
  },
  "latlng": {
    object (LatLng)
  },
  "openInfo": {
    object (OpenInfo)
  },
  "metadata": {
    object (Metadata)
  },
  "profile": {
    object (Profile)
  },
  "relationshipData": {
    object (RelationshipData)
  },
  "moreHours": [
    {
      object (MoreHours)
    }
  ],
  "serviceItems": [
    {
      object (ServiceItem)
    }
  ]
}
Alanlar
name

string

Bu konum için şu biçimdeki Google tanımlayıcısı: locations/{locationId}.

languageCode

string

Sabit. Konumun dili. Oluşturma sırasında ayarlanır ve güncellenemez.

storeCode

string

İsteğe bağlı. Bu konumun harici tanımlayıcısı. Belirli bir hesapta benzersiz olması gerekir. Bu şekilde konumu kendi kayıtlarınızla ilişkilendirebilirsiniz.

title

string

Zorunlu. Konum adı; vitrininizde, web sitenizde ve belgelerinizde düzenli olarak kullanıldığı ve müşterileriniz tarafından bilindiği şekliyle, işletmenizin gerçek dünyadaki adını yansıtmalıdır. Alakalı olduğunda, kaynağın diğer alanlarında (örneğin, Address, Categories) ek bilgiler yer alabilir. Adınıza gereksiz bilgiler eklemeyin (örneğin, "Google Inc. - Mountain View Şirket Merkezi" yerine "Google"ı tercih edin). Pazarlama kısa açıklamaları, mağaza kodları, özel karakterler, çalışma saatleri veya kapalı/açık olma durumu, telefon numaraları, web sitesi URL'leri, hizmet/ürün bilgileri, konum/adres veya yol tarifleri ya da koruma bilgileri (örneğin, "Duane Reade'deki Chase ATM") eklemeyin.

phoneNumbers

object (PhoneNumbers)

İsteğe bağlı. Müşterilerin işletmeyle iletişime geçmek için kullanabileceği farklı telefon numaralarıdır.

categories

object (Categories)

İsteğe bağlı. İşletmeyi tanımlayan farklı kategoriler.

storefrontAddress

object (PostalAddress)

İsteğe bağlı. İşletmenizin konumunu belirten tam ve doğru adrestir. Uzak konumlarda bulunan posta kutuları kabul edilmez. Şu anda, adreste en fazla beş addressLines değeri belirtebilirsiniz. Bu alan yalnızca vitrini olan işletmeler için ayarlanmalıdır. Bu alan, CUSTOMER_LOCATION_ONLY türündeki konumlar için ayarlanmamalıdır, ancak ayarlanırsa sağlanan değerler silinir.

websiteUri

string

İsteğe bağlı. Bu işletmenin URL'si. Mümkünse tüm konumları veya markayı temsil eden genel bir web sitesi/URL yerine söz konusu işletmenin bulunduğu konumu temsil eden bir URL kullanın.

regularHours

object (BusinessHours)

İsteğe bağlı. İşletmenin çalışma saatleri.

specialHours

object (SpecialHours)

İsteğe bağlı. İşletmeye özel çalışma saatleri. Buna genellikle tatil günlerindeki çalışma saatleri ve normal çalışma saatleri dışındaki zamanlar da dahildir. Bunlar normal çalışma saatlerini geçersiz kılar. Bu alan, normal çalışma saatleri olmadan ayarlanamaz.

serviceArea

object (ServiceAreaBusiness)

İsteğe bağlı. Hizmet bölgesi işletmeleri, hizmetlerini müşterinin bulunduğu konumda sunar. İşletme bir hizmet bölgesi işletmesiyse bu alan, işletmenin hizmet verdiği bölgeleri tanımlar.

labels[]

string

İsteğe bağlı. İşletmenizi etiketlemenize olanak tanıyan serbest biçimli dizelerden oluşan bir koleksiyon. Bu etiketler kullanıcılara yönelik DEĞİLDİR, yalnızca siz görebilirsiniz. Etiket başına 1-255 karakter arasında olmalıdır.

adWordsLocationExtensions

object (AdWordsLocationExtensions)

İsteğe bağlı. AdWords'de yer alan ek bilgilerdir.

latlng

object (LatLng)

İsteğe bağlı. Kullanıcı tarafından sağlanan enlem ve boylam. Bir yer oluştururken, sağlanan adres coğrafi kodları başarılı bir şekilde verilirse bu alan yoksayılır. Bu alan yalnızca kullanıcı tarafından sağlanan latlng değeri oluşturma sırasında kabul edilmişse veya latlng değeri Google İşletme Profili web sitesi üzerinden güncellenmişse alma isteklerinde döndürülür. Bu alan yalnızca onaylanmış müşteriler tarafından güncellenebilir.

openInfo

object (OpenInfo)

İsteğe bağlı. Konumun şu anda açık olup olmadığını gösteren bir işaret.

metadata

object (Metadata)

Yalnızca çıkış. Kullanıcı tarafından düzenlenemeyen ek bilgiler.

profile

object (Profile)

İsteğe bağlı. İşletmenizi kendi sesinizle anlatır ve işletmenizin benzersiz hikayesini ve tekliflerinizi kullanıcılarla paylaşır.

Bu alan, konaklama kategorileri (ör. oteller, moteller, hanlar) hariç tüm kategoriler için gereklidir.

relationshipData

object (RelationshipData)

İsteğe bağlı. Bununla ilgili tüm konumlar ve zincirler.

moreHours[]

object (MoreHours)

İsteğe bağlı. Bir işletmenin farklı departmanları veya belirli müşteriler için diğer çalışma saatleri.

serviceItems[]

object (ServiceItem)

İsteğe bağlı. Satıcılar tarafından desteklenen hizmetlerin listesi. Saç kesme, su ısıtıcı takma vb. hizmetler verilebilir. Yinelenen hizmet öğeleri otomatik olarak kaldırılır.

Yöntemler

delete

Konumu siler.

get

Belirtilen konumu döndürür.

getAttributes

Belirli bir konum için ayarlanmış tüm özellikleri arar.

getGoogleUpdated

Belirtilen konumun Google tarafından güncellenmiş sürümünü alır.

patch

Belirtilen konumu günceller.

updateAttributes

Belirli bir konumun özelliklerini güncelleyebilirsiniz.