REST Resource: locations

Kaynak: Konum

Konum. Bu alanların ayrıntılı açıklaması için yardım merkezi makalesine veya geçerli işletme kategorilerinin listesi için kategori uç noktasına bakın.

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 Google tanımlayıcısı şu biçimdedir: locations/{locationId}.

languageCode

string

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

storeCode

string

İsteğe bağlı. Bu konumun belirli bir hesapta benzersiz olması gereken harici tanımlayıcı. Bu, konumu kendi kayıtlarınızla ilişkilendirmenin bir yoludur.

title

string

Zorunlu. Konum adı; mağazanızda, web sitenizde ve belgelerinizde düzenli olarak kullanıldığı ve müşteriler tarafından bilinen, işletmenizin gerçek dünyadaki adını yansıtmalıdır. Gerektiğinde ek bilgiler kaynağın diğer alanlarına eklenebilir (örneğin, Address, Categories). Adınıza gereksiz bilgiler eklemeyin (örneğin, "Google Inc. - Mountain View Şirket Merkezi" yerine "Google" ifadesini 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 çevre bilgileri (örneğin, "Duane Reade'deki Chase ATM").

phoneNumbers

object (PhoneNumbers)

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

categories

object (Categories)

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

storefrontAddress

object (PostalAddress)

İsteğe bağlı. İşletmenizin konumunu açıklayan kesin ve doğru bir adres. Uzak yerlerde bulunan posta kutuları veya posta kutuları kabul edilmez. Şu anda adreste en fazla beş addressLines değeri belirtebilirsiniz. Bu alan yalnızca mağazası 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 tüm 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 işletmenin ilgili konumunu 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 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 yerde sağlar. Bu işletme bir hizmet bölgesi işletmesiyse bu alan, işletmenin hizmet verdiği bölgeleri açıklar.

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; onları 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 gösterilen ek bilgiler.

latlng

object (LatLng)

İsteğe bağlı. Kullanıcı tarafından sağlanan enlem ve boylam. Bir konum oluşturulurken, sağlanan adresin coğrafi kodları başarıyla kodlanırsa bu alan yoksayılır. Bu alan yalnızca kullanıcı tarafından sağlanan latlng değeri oluşturma sırasında kabul edildiyse veya latlng değeri Google İşletme Profili web sitesi aracılığıyla güncellendiyse 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 o 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 ifadenizle anlatır ve işletmenizin benzersiz hikayesini ve tekliflerinizi kullanıcılarla paylaşır.

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

relationshipData

object (RelationshipData)

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

moreHours[]

object (MoreHours)

İsteğe bağlı. Bir işletmenin farklı departmanları veya belirli müşterileri için daha fazla çalışma saati.

serviceItems[]

object (ServiceItem)

İsteğe bağlı. Satıcılar tarafından desteklenen hizmetlerin listesi. Hizmet, saç kesimi, şofben montajı vb. olabilir. Yinelenen hizmet öğeleri otomatik olarak kaldırılır.

Yöntemler

delete

Konum silinir.

get

Belirtilen konumu döndürür.

getAttributes

Belirli bir konum için ayarlanan 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üncelleme.