REST Resource: locations

Kaynak: Konum

Konum. Bu alanların ayrıntılı açıklaması için Yardım Merkezi makalesine, geçerli işletme kategorilerinin listesi için ise 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

Tanımlayıcı. Bu konumun Google tanımlayıcısı şu biçimdedir: locations/{locationId}.
languageCode

string

Değiştirilemez. Konumun dili. Oluşturma sırasında ayarlanır ve güncellenemez.
storeCode

string

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

string

Zorunlu. Konum adı, işletmenizin gerçek dünyadaki adını yansıtmalıdır. Bu ad, vitrininizde, web sitenizde ve kırtasiye malzemelerinizde tutarlı bir şekilde kullanılmalı ve müşteriler tarafından bilinmelidir. Alakalı olduğunda, ek bilgiler kaynağın diğer alanlarına (örneğin, Address, Categories) eklenebilir. Adınıza gereksiz bilgiler eklemeyin (örneğin, "Google Inc. - Mountain View Corporate Headquarters" yerine "Google"ı tercih edin). Pazarlama amaçlı kısa açıklamalar, mağaza kodları, özel karakterler, çalışma saatleri veya kapalı/açık durumu, telefon numaraları, web sitesi URL'leri, hizmet/ürün bilgileri, konum/adres veya yol tarifi ya da kapsama bilgileri (örneğin, "Duane Reade'deki Chase ATM'si") eklemeyin.
phoneNumbers

object (PhoneNumbers)

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

object (Categories)

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

object (PostalAddress)

İsteğe bağlıdır. İşletmenizin konumunu tanımlamak için net ve doğru bir adres. Postanelerde ve uzak yerlerde 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. Ayarlanırsa sağlanan değerler silinir.
websiteUri

string

İsteğe bağlıdır. Bu işletmenin URL'si. Mümkünse tüm konumları veya markayı temsil eden genel bir web sitesi/URL yerine bu işletme konumunu temsil eden bir URL kullanın.
regularHours

object (BusinessHours)

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

object (SpecialHours)

İsteğe bağlıdır. İşletmenin özel çalışma saatleri. Bu genellikle tatil günlerini ve normal çalışma saatleri dışındaki diğer zamanları içerir. Bu saatler, normal çalışma saatlerini geçersiz kılar. Bu alan, normal çalışma saatleri olmadan ayarlanamaz.
serviceArea

object (ServiceAreaBusiness)

İsteğe bağlıdır. Hizmet bölgesi işletmeleri, hizmetlerini müşterinin bulunduğu yerde sunar. İşletme bir hizmet bölgesi işletmesiyse bu alan, işletmenin hizmet verdiği bölgeleri açıklar.
labels[]

string

İsteğe bağlıdır. İşletmenizi etiketlemenize olanak tanıyan serbest biçimli dizelerden oluşan bir koleksiyon. Bu etiketler kullanıcılara GÖSTERİLMEZ. Etiketleri yalnızca siz görebilirsiniz. Etiket başına 1-255 karakter içermelidir.
adWordsLocationExtensions

object (AdWordsLocationExtensions)

İsteğe bağlıdır. AdWords'te gösterilen ek bilgiler.
latlng

object (LatLng)

İsteğe bağlıdır. Kullanıcı tarafından sağlanan enlem ve boylam. Konum oluştururken, sağlanan adres başarıyla coğrafi olarak kodlanırsa bu alan yoksayılır. Bu alan, yalnızca oluşturma sırasında kullanıcı tarafından sağlanan latlng değeri kabul edildiyse veya latlng değeri Google İşletme Profili web sitesi üzerinden güncellendiyse GET isteklerinde döndürülür. Bu alan yalnızca onaylı istemciler tarafından güncellenebilir.
openInfo

object (OpenInfo)

İsteğe bağlıdır. 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ıdır. İşletmenizi kendi üslubunuzla tanımlar ve işletmenizin benzersiz hikayesini ve tekliflerini kullanıcılarla paylaşır.

Bu alan, konaklama kategorileri (ör. oteller, moteller, hanlar) dışındaki tüm kategoriler için zorunludur.
relationshipData

object (RelationshipData)

İsteğe bağlıdır. Bu konumla ilgili tüm konumlar ve zincir.
moreHours[]

object (MoreHours)

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

object (ServiceItem)

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

Yöntemler

delete

 Bir konumu siler.

get

 Satıcı tarafından en son ayarlanan konumu döndürür.

getAttributes

 Bir konumun özelliklerini, satıcı tarafından en son ayarlandığı şekilde alır.

getGoogleUpdated

 Belirtilen konumu Google Haritalar ve Arama'da göründüğü şekilde döndürür.

patch

 Belirtilen konumu günceller.

updateAttributes

 Belirli bir konumun özelliklerini güncelleyin.