REST Resource: accounts.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.

PhoneNumbers

İşletmeye ait telefon numaraları koleksiyonu. Güncellemeler sırasında her iki alan da ayarlanmalıdır. Müşteriler, güncelleme maskesini kullanarak yalnızca birincil veya ek telefon numaralarını güncelleyemez. "+1 415 555 0132" gibi uluslararası telefon biçimi tercih edilir. Daha fazla bilgiyi (https://developers.google.com/style/phone-numbers#international-phone-numbers) adresinde bulabilirsiniz.

JSON gösterimi 
{
  "primaryPhone": string,
  "additionalPhones": [
    string
  ]
}
Alanlar
primaryPhone

string

Zorunlu. Bağımsız işletmenizin konumuna mümkün olduğunca doğrudan bağlanan bir telefon numarası. Mümkün olduğunda çağrı merkezi yardım hattı numarası yerine yerel telefon numarası kullanın.
additionalPhones[]

string

İsteğe bağlı. Birincil telefon numaranıza ek olarak işletmenizin aranabileceği en fazla iki telefon numarası (cep telefonu veya sabit hat olabilir, faks numarası olamaz).

Kategoriler

İşletmeyi tanımlayan bir kategori koleksiyonu. Güncellemeler sırasında her iki alan da ayarlanmalıdır. Müşterilerin, güncelleme maskesini kullanarak birincil veya ek kategorileri tek tek güncellemesi yasaktır.

JSON gösterimi 
{
  "primaryCategory": {
    object (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ]
}
Alanlar
primaryCategory

object (Category)

Zorunlu. Bu konumun faaliyet gösterdiği temel işi en iyi açıklayan kategori.
additionalCategories[]

object (Category)

İsteğe bağlı. İşletmenizi tanımlayan ek kategoriler. Kategoriler, müşterilerinizin ilgilendikleri hizmetlerle ilgili doğru ve spesifik sonuçlar bulmasına yardımcı olur. İşletme bilgilerinizin doğru ve güncel olmasını sağlamak için, ana faaliyet alanınızı genel olarak tarif ederken mümkün olduğunca az sayıda kategori kullandığınızdan emin olun. Mümkün olduğunca spesifik ancak ana faaliyet alanınızı da temsil eden kategoriler seçin.

Kategori

İşletmenin ne olduğunu (ne yaptığını değil) açıklayan bir kategori. Geçerli kategori kimliklerinin listesi ve kullanıcılar tarafından okunabilen adların eşlemeleri için categories.list adresine bakın.

JSON gösterimi 
{
  "name": string,
  "displayName": string,
  "serviceTypes": [
    {
      object (ServiceType)
    }
  ],
  "moreHoursTypes": [
    {
      object (MoreHoursType)
    }
  ]
}
Alanlar
name

string

Zorunlu. Bu kategori için sabit bir kimlik (Google tarafından sağlanır). Değer, kategori değiştirilirken (konum oluştururken veya güncellerken) belirtilmelidir.
displayName

string

Yalnızca çıkış. Kategorinin kullanıcılar tarafından okunabilen adı. Bu, konum okunurken ayarlanır. Konum değiştirilirken category_id ayarlanmalıdır.
serviceTypes[]

object (ServiceType)

Yalnızca çıkış. Bu işletme kategorisinde kullanılabilen tüm hizmet türlerinin listesi.
moreHoursTypes[]

object (MoreHoursType)

Yalnızca çıkış. Bu işletme kategorisi için kullanabileceğiniz diğer çalışma saati türleri.

ServiceType

İşletmenin sunduğu bir hizmet türünü açıklayan mesaj.

JSON gösterimi 
{
  "serviceTypeId": string,
  "displayName": string
}
Alanlar
serviceTypeId

string

Yalnızca çıkış. Bu hizmet türü için sabit bir kimlik (Google tarafından sağlanır).
displayName

string

Yalnızca çıkış. Hizmet türü için okunabilir görünen addır.

MoreHoursType

Bir işletmenin normal çalışma saatlerinin yanı sıra sunabileceği diğer çalışma saati türleri.

JSON gösterimi 
{
  "hoursTypeId": string,
  "displayName": string,
  "localizedDisplayName": string
}
Alanlar
hoursTypeId

string

Yalnızca çıkış. Bu saat türü için Google tarafından sağlanan sabit bir kimlik.
displayName

string

Yalnızca çıkış. Saat türü için okunabilir İngilizce görünen addır.
localizedDisplayName

string

Yalnızca çıkış. Saat türü için kullanıcılar tarafından okunabilen yerelleştirilmiş görünen ad.

PostalAddress

Bir posta adresini temsil eder, ör. veya ödeme adresleri için de geçerlidir. Posta adresi sayesinde, posta hizmetleri bir binaya ürün teslim edebilir. Kutu veya benzeri. Coğrafi konumları (yollar, kasabalar, dağlar) modellemesi amaçlanmamıştır.

Normal kullanımda adres, işlemin türüne bağlı olarak kullanıcı girişi aracılığıyla ya da mevcut verilerin içe aktarılmasıyla oluşturulur.

Adres girişi / düzenleme ile ilgili öneri: - https://github.com/google/libaddressinput gibi uluslararası kullanıma hazır bir adres widget'ı kullanın) - Kullanıcılara, alanın kullanıldığı ülkeler dışındaki alanların girilmesi veya düzenlenmesi için kullanıcı arayüzü öğeleri sunulmamalıdır.

Bu şemanın nasıl kullanılacağıyla ilgili daha fazla yardım için lütfen bkz: https://support.google.com/business/answer/6397478

JSON gösterimi 
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
Alanlar
revision

integer

PostalAddress öğesinin şema düzeltmesi. Bu değer, en son düzeltme olan 0'a ayarlanmalıdır.

Tüm yeni düzeltmeler eski düzeltmelerle geriye dönük olarak uyumlu olmalıdır.
regionCode

string

Zorunlu. Adresin bulunduğu ülkenin/bölgenin CLDR bölge kodu. Bu durum hiçbir zaman tahmin edilmez ve değerin doğru olup olmadığını kontrol etmek kullanıcıya bağlıdır. Ayrıntılı bilgi için https://cldr.unicode.org/ ve https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html bakın. Örnek: "CH" kullanmaya başladım.
languageCode

string

İsteğe bağlı. Bu adresin içeriğinin BCP-47 dil kodu (biliniyorsa). Bu genellikle giriş formunun kullanıcı arayüzü dilidir veya adreste kullanılan dillerden biriyle eşleşmesi beklenir ülke/bölge ya da harf çevirisi yapılmış eşdeğerleri. Bu, belirli ülkelerde biçimlendirmeyi etkileyebilir ancak verilerin doğruluğu açısından kritik öneme sahip değildir ve hiçbir zaman doğrulamayı veya biçimlendirmeyle ilgili olmayan diğer işlemleri etkilemez.

Bu değer bilinmiyorsa yanlış olabilecek bir varsayılan belirtmek yerine belirtilmemelidir.

Örnekler: "zh-Hant", "ja", "ja-Latn", "en".
postalCode

string

İsteğe bağlı. Adresin posta kodu. Bazı ülkeler posta kodlarını kullanmaz veya gerekli kılmaz, ancak kullanıldıkları yerde adresin diğer kısımlarında ek doğrulama (ör. ABD'de eyalet/posta kodu doğrulaması) tetiklenebilir.
sortingCode

string

İsteğe bağlı. Ülkeye özgü ek sıralama kodu. Bu ad çoğu bölgede kullanılmaz. Kullanıldığı yerde değer, "CEDEX" gibi bir dize ve isteğe bağlı olarak ardından bir sayı (ör. "CEDEX 7") veya "sektör kodunu" temsil eden yalnızca tek bir sayıdır (Jamaika), "teslimat alanı göstergesi" (Malavi) veya "postane göstergesi" (ör. Fildişi Sahili).
administrativeArea

string

İsteğe bağlı. Bir ülke veya bölgenin posta adresleri için kullanılan en yüksek idari alt bölüm. Örneğin bu bir eyalet, il, oblast veya vilayet olabilir. Özellikle, İspanya için bu, özerk topluluk değil, ildir (örneğin, "Katalonya" değil "Barselona"). Birçok ülke, posta adreslerinde idari bölge kullanmaz. Ör. İsviçre'de bu alan doldurulmadan bırakılmalıdır.
locality

string

İsteğe bağlı. Genellikle adresin şehir/ilçe bölümünü ifade eder. Örnekler: ABD şehri, BT komünü, Birleşik Krallık posta şehri. Dünyada yerlerin iyi tanımlanmadığı veya bu yapıya pek uygun olmadığı bölgelerde, locality alanını boş bırakın ve addressLines kullanın.
sublocality

string

İsteğe bağlı. Adresin alt konumu. Örneğin; mahalle, kaza, ilçe olabilir.
addressLines[]

string

Bir adresin alt düzeylerini açıklayan yapılandırılmamış adres satırları.

addressLines'taki değerler tür bilgisi içermediğinden ve bazen tek bir alanda birden çok değer (ör. "Austin, TX") içerebildiğinden satır sırasının açık olması önemlidir. Adres satırlarının sırası "zarf sırası" olmalıdır girin. Bu özelliğin değişebileceği yerlerde (ör. Japonya), açık hale getirmek için address_language kullanılır (ör. büyükten küçüğe sıralama için "ja", küçükten büyüğe sıralama için "ja-Latn" ya da "en"). Bu şekilde, bir adresin en spesifik satırı dile göre seçilebilir.

Bir adresin izin verilen minimum yapısal gösterimi, kalan tüm bilgilerin addressLines içine yerleştirildiği bir regionCode'dan oluşur. Böyle bir adres, coğrafi kodlama olmadan yaklaşık olarak yaklaşık olarak biçimlendirilebilir ancak en azından kısmen çözümlenene kadar hiçbir adres bileşeni hakkında anlamsal çıkarımda bulunulamaz.

Yalnızca regionCode ve addressLines içeren bir adres oluşturduktan sonra coğrafi kodlama, tamamen yapılandırılmamış adresleri yönetmek için önerilen yöntemdir (adresin hangi bölümlerinin yerel bölgeler veya idari alanlar olması gerektiğini tahmin etmek yerine).
recipients[]

string

İsteğe bağlı. Adresteki alıcı. Bu alan, belirli durumlarda çok satırlı bilgiler içerebilir. Örneğin, ekleyebilirsiniz.
organization

string

İsteğe bağlı. Adresteki kuruluşun adı.

BusinessHours

Bu konumun faaliyete açık olduğu dönemleri gösterir. [TimePeriod][google.mybusiness.mybusinessinformation.v1.TimePeriod] örneklerinden oluşan bir koleksiyon içerir.

JSON gösterimi 
{
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}
Alanlar
periods[]

object (TimePeriod)

Zorunlu. Bu konumun açık olduğu zaman koleksiyonu. Her dönem, konumun hafta içinde açık olduğu saat aralığını temsil eder.

TimePeriod

Belirtilen açılış gününde/saatinde başlayıp belirtilen kapanış gününde/saatinde kapanan, işletmenin açık olduğu zaman aralığını temsil eder. Kapanış saati, açılış saatinden sonra olmalıdır; örneğin, aynı günün ilerleyen saatlerinde veya sonraki bir günde.

JSON gösterimi 
{
  "openDay": enum (DayOfWeek),
  "openTime": {
    object (TimeOfDay)
  },
  "closeDay": enum (DayOfWeek),
  "closeTime": {
    object (TimeOfDay)
  }
}
Alanlar
openDay

enum (DayOfWeek)

Zorunlu. Bu dönemin başlayacağı day of the week değerini gösterir.
openTime

object (TimeOfDay)

Zorunlu. Geçerli değerler 00:00-24:00 arasındadır; burada 24:00, belirtilen gün alanının sonundaki gece yarısını temsil eder.
closeDay

enum (DayOfWeek)

Zorunlu. Bu dönemin sona erdiği day of the week değerini gösterir.
closeTime

object (TimeOfDay)

Zorunlu. Geçerli değerler 00:00-24:00 arasındadır; burada 24:00, belirtilen gün alanının sonundaki gece yarısını temsil eder.

HaftanınGünü

Haftanın bir gününü temsil eder.

Sıralamalar
DAY_OF_WEEK_UNSPECIFIED Haftanın günü belirtilmemiş.
MONDAY Pazartesi
TUESDAY Salı
WEDNESDAY Çarşamba
THURSDAY Perşembe
FRIDAY Cuma
SATURDAY Cumartesi
SUNDAY Pazar

TimeOfDay

Günün saatini temsil eder. Tarih ve saat dilimi önemli değil veya başka bir yerde belirtilmiş. Bir API, artık saniyeye izin vermeyi seçebilir. İlgili türler: google.type.Date ve google.protobuf.Timestamp.

JSON gösterimi 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Alanlar
hours

integer

24 saat biçiminde günün saatleri. 0 ile 23 arasında olmalıdır. Bir API, "24:00:00" değerine izin vermeyi seçebilir. gibi senaryolar için oldukça yararlı olabilir.
minutes

integer

Günün saatindeki dakikalar. 0 ile 59 arasında olmalıdır.
seconds

integer

Saniye cinsinden dakika. Normalde 0 ile 59 arasında olmalıdır. Bir API, artık saniyeye izin veriyorsa 60 değerine izin verebilir.
nanos

integer

Nanosaniye cinsinden saniyenin kesirleri. 0 ile 999.999.999 arasında olmalıdır.

SpecialHours

Bir konumun çalışma saatlerinin normal çalışma saatlerinden farklı olduğu dönemleri ifade eder.

JSON gösterimi 
{
  "specialHourPeriods": [
    {
      object (SpecialHourPeriod)
    }
  ]
}
Alanlar
specialHourPeriods[]

object (SpecialHourPeriod)

Zorunlu. İşletmenin normal çalışma saatleriyle ilgili istisnaların listesi.

SpecialHourPeriod

Bir konumun çalışma saatlerinin normal çalışma saatlerinden farklı olduğu tek bir dönemi temsil eder. Özel çalışma saatleri, 24 saatten kısa bir aralığı temsil etmelidir. openTime ve startDate, closeTime ve endDate tarihinden önce olmalıdır. closeTime ve endDate, belirtilen startDate değerinden sonraki günde 11:59'a kadar uzayabilir. Örneğin, aşağıdaki girişler geçerlidir:

startDate=2015-11-23, openTime=08:00, closeTime=18:00
startDate=2015-11-23, endDate=2015-11-23, openTime=08:00,
closeTime=18:00 startDate=2015-11-23, endDate=2015-11-24,
openTime=13:00, closeTime=11:59

Aşağıdaki girişler geçerli değil:

startDate=2015-11-23, openTime=13:00, closeTime=11:59
startDate=2015-11-23, endDate=2015-11-24, openTime=13:00,
closeTime=12:00 startDate=2015-11-23, endDate=2015-11-25,
openTime=08:00, closeTime=18:00
JSON gösterimi 
{
  "startDate": {
    object (Date)
  },
  "openTime": {
    object (TimeOfDay)
  },
  "endDate": {
    object (Date)
  },
  "closeTime": {
    object (TimeOfDay)
  },
  "closed": boolean
}
Alanlar
startDate

object (Date)

Zorunlu. Bu özel saat döneminin başladığı takvim tarihi.
openTime

object (TimeOfDay)

İsteğe bağlı. Geçerli değerler 00:00-24:00'dır; burada 24:00, belirtilen gün alanının sonundaki gece yarısını temsil eder. closed false (yanlış) değerine ayarlanmışsa bu değer belirtilmelidir.
endDate

object (Date)

İsteğe bağlı. Bu özel saatlik dönemin sona erdiği takvim tarihi. endDate alanı ayarlanmazsa startDate alanında belirtilen tarih varsayılan olarak ayarlanır. Ayarlanırsa bu alan, startDate değerine eşit veya ondan en fazla 1 gün sonra olmalıdır.
closeTime

object (TimeOfDay)

İsteğe bağlı. Geçerli değerler 00:00-24:00 arasındadır; burada 24:00, belirtilen gün alanının sonundaki gece yarısını temsil eder. closed false (yanlış) değerine ayarlanmışsa bu değer belirtilmelidir.
closed

boolean

İsteğe bağlı. Doğru değerine ayarlanırsa endDate, openTime ve closeTime yoksayılır ve startDate içinde belirtilen tarih, tüm gün boyunca kapalı konum olarak kabul edilir.

Tarih

Takvimin tamamını veya bir kısmını temsil eder (ör. doğum günü). Günün saati ve saat dilimi başka bir yerde belirtilmiş veya önemsiz. Tarih, Miladi Takvim'e göredir. Bu, aşağıdakilerden birini temsil edebilir:

  • Sıfır olmayan yıl, ay ve gün değerleriyle tam tarih.
  • Bir ay ve gün ile sıfır yıl (örneğin, bir yıl dönümü).
  • Tek başına bir yıl, sıfır ay ve sıfır gün.
  • Sıfır gün içeren bir yıl ve ay (örneğin, kredi kartı son kullanma tarihi).

İlgili türler:

JSON gösterimi 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Alanlar
year

integer

Tarihin yılı. 1 ile 9999 arasında veya yıl içermeyen bir tarihi belirtmek için 0 arasında olmalıdır.
month

integer

Bir yılın ayı. 1 ile 12 arasında veya ay ve gün içermeyen bir yılı belirtmek için 0 arasında olmalıdır.
day

integer

Ayın günü. 1 ile 31 arasında bir değer olmalı ve yıl ve ay için geçerlidir. Yalnızca yılı belirtmek için 0 değerini veya günün önemli olmadığı bir yılı ve ayı belirtmek için 0 değerini girin.

ServiceAreaBusiness

Hizmet bölgesi işletmeleri, hizmetlerini müşterilerin bulunduğu yerde (ör. çilingir veya tesisatçı) sunar.

JSON gösterimi 
{
  "businessType": enum (BusinessType),
  "places": {
    object (Places)
  },
  "regionCode": string
}
Alanlar
businessType

enum (BusinessType)

Zorunlu. [type] türünü gösterir hizmet bölgesi işletmesinin [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType].
places

object (Places)

Bu işletmenin hizmet verdiği bölge, bir dizi yerle tanımlanır.
regionCode

string

Sabit. Bu hizmet bölgesi işletmesinin bulunduğu ülkenin/bölgenin CLDR bölge kodu. Ayrıntılar için http://cldr.unicode.org/ ve http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html adresine bakın. Örnek: "CH" kullanmaya başladım.

Bu alan, CUSTOMER_LOCATION_ONLY işletmeleri için gereklidir, aksi takdirde yoksayılır.

Burada belirtilen bölge, bu işletmenin hizmet verdiği bölgelere ait bölgelerden farklı olabilir (ör. bulunduğu bölge dışındaki bölgelerde hizmet veren hizmet bölgesi işletmeleri).

Bu konum, oluşturulduktan sonra doğrulama gerektiriyorsa doğrulama amacıyla sağlanan adres bu bölgede bulunmalıdır ve işletme sahibi ya da yetkili temsilcisi, belirtilen doğrulama adresinden posta alabiliyor olmalıdır.

BusinessType

Bu işletmenin yalnızca müşteri konumunda (ör. çekici kamyonu) yoksa hem adreste hem de işletme yerinde mi (ör. yemek alanı bulunan ve aynı zamanda müşterilere teslimat yapan pizzacı) hizmet sunduğunu belirtir.

Sıralamalar
BUSINESS_TYPE_UNSPECIFIED Yalnızca çıkış. Belirtilmedi.
CUSTOMER_LOCATION_ONLY Yalnızca bulunduğu bölgenin yakınında (işletme adresinde değil) hizmet sunuyor. Bir işletme, CUSTOMER_AND_BUSINESS_LOCATION yerine CUSTOMER_LOCATION_ONLY olarak güncelleniyorsa konum güncellemesinde storefrontAddress alan maskesi bulunmalı ve alan boş olarak ayarlanmalıdır.
CUSTOMER_AND_BUSINESS_LOCATION İşletme adresinde ve yakınında hizmet verir.

Yerler

Bir yer kümesiyle temsil edilen alanların birleşimini tanımlar.

JSON gösterimi 
{
  "placeInfos": [
    {
      object (PlaceInfo)
    }
  ]
}
Alanlar
placeInfos[]

object (PlaceInfo)

Yer kimlikleriyle temsil edilen alanlar. En fazla 20 yerle sınırlıdır.

PlaceInfo

Yer kimliğiyle temsil edilen bir alanı tanımlar.

JSON gösterimi 
{
  "placeName": string,
  "placeId": string
}
Alanlar
placeName

string

Zorunlu. Yerin yerelleştirilmiş adı. Örneğin, Scottsdale, AZ.
placeId

string

Zorunlu. Yerin kimliği. Bir bölgeye karşılık gelmelidir. (https://developers.google.com/places/web-service/supported_types#table3)

AdWordsLocationExtensions

AdWords'de gösterilen ek bilgiler.

JSON gösterimi 
{
  "adPhone": string
}
Alanlar
adPhone

string

Zorunlu. AdWords yer uzantılarında, konumun birincil telefon numarası yerine görüntülenecek alternatif bir telefon numarası.

LatLng

Enlem/boylam çiftini temsil eden bir nesne. Bu, enlem ve boylam derecelerini temsil eden bir çift çift olarak ifade edilir. Aksi belirtilmedikçe bu nesne WGS84 standardına uygun olmalıdır. Değerler normalleştirilmiş aralıklar içinde olmalıdır.

JSON gösterimi 
{
  "latitude": number,
  "longitude": number
}
Alanlar
latitude

number

Derece cinsinden enlem. [-90,0, +90,0] aralığında olmalıdır.
longitude

number

Derece cinsinden boylam. [-180.0, +180.0] aralığında olmalıdır.

OpenInfo

İşletmenin açılış durumuyla ilgili bilgiler.

JSON gösterimi 
{
  "status": enum (OpenForBusiness),
  "canReopen": boolean,
  "openingDate": {
    object (Date)
  }
}
Alanlar
status

enum (OpenForBusiness)

Zorunlu. Konumun şu anda açık olup olmadığını gösterir. Kapalı olacak şekilde güncellenmediği sürece tüm konumlar varsayılan olarak açıktır.
canReopen

boolean

Yalnızca çıkış. Bu işletmenin yeniden açılmaya uygun olup olmadığını belirtir.
openingDate

object (Date)

İsteğe bağlı. Konumun ilk açıldığı tarih. Tam gün bilinmiyorsa yalnızca ay ve yıl sağlanabilir. Tarih, geçmişte olmalı veya bir yıldan ileride olmamalıdır.

OpenForBusiness

Bir konumun durumunu gösterir.

Sıralamalar
OPEN_FOR_BUSINESS_UNSPECIFIED Belirtilmedi.
OPEN Konumun açık olduğunu gösterir.
CLOSED_PERMANENTLY Konumun kalıcı olarak kapandığını gösterir.
CLOSED_TEMPORARILY Konumun geçici olarak kapatıldığını belirtir.

Meta veri

Konumla ilgili olarak kullanıcılar tarafından düzenlenemeyen ek bilgiler.

JSON gösterimi 
{
  "hasGoogleUpdated": boolean,
  "hasPendingEdits": boolean,
  "canDelete": boolean,
  "canOperateLocalPost": boolean,
  "canModifyServiceList": boolean,
  "canHaveFoodMenus": boolean,
  "canOperateHealthData": boolean,
  "canOperateLodgingData": boolean,
  "placeId": string,
  "duplicateLocation": string,
  "mapsUri": string,
  "newReviewUri": string,
  "canHaveBusinessCalls": boolean,
  "hasVoiceOfMerchant": boolean
}
Alanlar
hasGoogleUpdated

boolean

Yalnızca çıkış. Bu konumla ilişkili yer kimliğinin istemci tarafından güncellenmesi veya reddedilmesi gereken güncellemeler olup olmadığını belirtir. Bu boole ayarlanırsa doğrulanması gereken bilgileri aramak için getGoogleUpdated yöntemini çağırmanız gerekir.
hasPendingEdits

boolean

Yalnızca çıkış. Bu Konum'un özelliklerinden herhangi birinin düzenleme bekleme durumunda olup olmadığını belirtir.
canDelete

boolean

Yalnızca çıkış. Konumun API kullanılarak silinip silinemeyeceğini belirtir.
canOperateLocalPost

boolean

Yalnızca çıkış. Girişin yerel yayınları yönetip yönetemeyeceğini belirtir.
canModifyServiceList

boolean

Yalnızca çıkış. Girişin, hizmet listesini değiştirip değiştiremeyeceğini gösterir.
canHaveFoodMenus

boolean

Yalnızca çıkış. Girişin yemek menüsü için uygun olup olmadığını gösterir.
canOperateHealthData

boolean

Yalnızca çıkış. Konumun, sağlık verileri üzerinde çalışıp çalışamayacağını belirtir.
canOperateLodgingData

boolean

Yalnızca çıkış. Konumun Konaklama verileri üzerinde kullanılıp kullanılamayacağını belirtir.
placeId

string

Yalnızca çıkış. Bu konum Google Haritalar'da görünüyorsa bu alan konumun yer kimliğiyle doldurulur. Bu kimlik çeşitli Places API'lerinde kullanılabilir.

Bu alan, "Oluşturma" çağrıları sırasında ayarlanabilir ancak Güncelleme için ayarlanamaz.
duplicateLocation

string

Yalnızca çıkış. Bu konumun çoğaltıldığı konum kaynağı.
mapsUri

string

Yalnızca çıkış. Haritalar'da konumun bağlantısı.
newReviewUri

string

Yalnızca çıkış. Müşterilerin konumla ilgili yorum bırakabileceği Google Arama sayfasına bağlantı.
canHaveBusinessCalls

boolean

Yalnızca çıkış. Girişin işletme aramaları için uygun olup olmadığını gösterir.
hasVoiceOfMerchant

boolean

Yalnızca çıkış. Girişte Satıcının Sesi olup olmadığını belirtir. Bu boole değeri yanlışsa, Voice of Merchant'ı neden almadıklarıyla ilgili ayrıntıları öğrenmek için locations.getVoiceOfMerchantState API'sini çağırmanız gerekir.

Profil

Konumun profiliyle ilgili tüm bilgiler.

JSON gösterimi 
{
  "description": string
}
Alanlar
description

string

Zorunlu. Konumun açıklamasını kendi sesinizle yapabilir, başkası tarafından düzenleyemezsiniz.

RelationshipData

Bununla ilgili tüm ebeveyn ve alt konumların bilgileri.

JSON gösterimi 
{
  "parentLocation": {
    object (RelevantLocation)
  },
  "childrenLocations": [
    {
      object (RelevantLocation)
    }
  ],
  "parentChain": string
}
Alanlar
parentLocation

object (RelevantLocation)

Bu konumun ilişkili olduğu üst konum.
childrenLocations[]

object (RelevantLocation)

Bu konumun ilişkili olduğu alt konumların listesi.
parentChain

string

Bu konumun üyesi olduğu Zincirin kaynak adı. [Zincir kimliği nasıl bulunur?] [Locations.SearchChains]

RelevantLocation

Mevcut konumla ilgili başka bir konum hakkında bilgiler. İlişki, DEPARTMENT_OF veya INDEPENDENT_ESTABLISHMENT_OF özelliklerinden herhangi biri olabilir ve burada belirtilen konum, konumun her iki tarafında da (üst/alt) olabilir.

JSON gösterimi 
{
  "placeId": string,
  "relationType": enum (RelationType)
}
Alanlar
placeId

string

Zorunlu. İlişkinin diğer tarafındaki konumu yer kimliğiyle belirtin.
relationType

enum (RelationType)

Zorunlu. İlişkinin türü.

RelationType

Belirtilecek tür ilişkileri.

Sıralamalar
RELATION_TYPE_UNSPECIFIED Tür belirtilmedi.
DEPARTMENT_OF Bu, bir fiziksel alanı paylaşan, aynı markayı/üst yönetimi/kuruluşu ancak mağaza çalışma saatleri veya telefon numaraları gibi farklı temel özelliklere sahip 2 konum arasındaki ilişkiyi temsil eder. Örneğin, Kocaeli Eczanesi, Migros'un Toptan Satışı'nda bir bölümdür.
INDEPENDENT_ESTABLISHMENT_IN Bu, iki konumun aynı fiziksel konumda aynı anda farklı şirketlere ait olduğu ancak farklı şirketlere ait olduğu durumları temsil eder (ör. Starbucks, bir alışveriş merkezindeki Starbucks).

MoreHours

Bir konumun belirli işletme türleri için açık olduğu dönemler.

JSON gösterimi 
{
  "hoursTypeId": string,
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}
Alanlar
hoursTypeId

string

Zorunlu. Saat türü. Müşteriler, bulundukları konumların kategorileri için desteklenen saat türlerini öğrenmek üzere {#link businessCategory:BatchGet} numaralı telefonu aramalıdır.
periods[]

object (TimePeriod)

Zorunlu. Bu konumun açık olduğu saatlerin koleksiyonu. Her dönem, konumun hafta içinde açık olduğu saat aralığını temsil eder.

ServiceItem

Tek bir hizmet öğesini açıklayan mesaj. Satıcının sunduğu hizmet türünü tanımlamak için kullanılır. Örneğin, saç kesimi bir hizmet olabilir.

JSON gösterimi 
{
  "price": {
    object (Money)
  },

  // Union field service_item_info can be only one of the following:
  "structuredServiceItem": {
    object (StructuredServiceItem)
  },
  "freeFormServiceItem": {
    object (FreeFormServiceItem)
  }
  // End of list of possible types for union field service_item_info.
}
Alanlar
price

object (Money)

İsteğe bağlı. Hizmet öğesinin parasal fiyatını temsil eder. Fiyat eklenirken currencyCode ve birimlerin ayarlanmasını öneririz. Bu, hizmet öğesinin sabit fiyatı olarak değerlendirilir.
Birleştirme alanı service_item_info. Aşağıdaki alanlardan biri her zaman ayarlanmalıdır. service_item_info şunlardan yalnızca biri olabilir:
structuredServiceItem

object (StructuredServiceItem)

İsteğe bağlı. Bu alan, yapılandırılmış hizmet verileri için büyük/küçük harfe ayarlanır.
freeFormServiceItem

object (FreeFormServiceItem)

İsteğe bağlı. Bu alan, serbest biçimli hizmet verileri için büyük/küçük harfe ayarlanır.

StructuredServiceItem

Satıcı tarafından sunulan yapılandırılmış bir hizmeti temsil eder. Ör. toilet_installation.

JSON gösterimi 
{
  "serviceTypeId": string,
  "description": string
}
Alanlar
serviceTypeId

string

Zorunlu. serviceTypeId alanı, ServiceType adresinde bulunabilen, Google tarafından sağlanan benzersiz bir kimliktir. Bu bilgi categories.batchGet Rpc hizmeti tarafından sağlanmaktadır.
description

string

İsteğe bağlı. Yapılandırılmış hizmet öğesinin açıklaması. Karakter sınırı 300'dür.

FreeFormServiceItem

Satıcı tarafından sunulan serbest biçimli bir hizmeti temsil eder. Bunlar, yapı hizmet verilerimizin bir parçası olarak kullanıma sunulmayan hizmetlerdir. Satıcı, coğrafi satıcı platformu aracılığıyla bu tür hizmetlerin adlarını manuel olarak girer.

JSON gösterimi 
{
  "category": string,
  "label": {
    object (Label)
  }
}
Alanlar
category

string

Zorunlu. Bu alan, kategori adını (kategorinin sabit kimliği) temsil eder. category ve serviceTypeId, Category mesajında belirtilen olası kombinasyonlarla eşleşmelidir.
label

object (Label)

Zorunlu. Öğe için dil etiketli etiketler. Öğe adlarının 140 karakter veya daha kısa, açıklamaların ise 250 karakter veya daha kısa olmasını öneririz. Bu alan yalnızca giriş özel bir hizmet öğesiyse ayarlanmalıdır. Standartlaştırılmış hizmet türleri, serviceTypeId aracılığıyla güncellenmelidir.

Şirket

Fiyat listesi, bölüm veya öğe gösterilirken kullanılacak etiket.

JSON gösterimi 
{
  "displayName": string,
  "description": string,
  "languageCode": string
}
Alanlar
displayName

string

Zorunlu. Fiyat listesi, bölüm veya öğe için görünen ad.
description

string

İsteğe bağlı. Fiyat listesinin, bölümün veya öğenin açıklaması.
languageCode

string

İsteğe bağlı. Bu dizelerin geçerli olduğu BCP-47 dil kodu. Her dil için yalnızca bir etiket grubu ayarlanabilir.

Para

Para birimi türüyle birlikte bir para tutarını gösterir.

JSON gösterimi 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
Alanlar
currencyCode

string

ISO 4217'de tanımlanan üç harfli para birimi kodu.
units

string (int64 format)

Tutarın tam birimi. Örneğin, currencyCode "USD" ise 1 birim bir ABD dolarıdır.
nanos

integer

Tutarın nano (10^-9) birimlerinin sayısı. Değer -999.999.999 ile +999.999.999 (bu değerler dahil) arasında olmalıdır. units pozitifse nanos pozitif veya sıfır olmalıdır. units sıfırsa nanos pozitif, sıfır veya negatif olabilir. units negatifse nanos negatif veya sıfır olmalıdır. Örneğin $-1,75 şu şekilde ifade edilir: units=-1 ve nanos=-750.000.000.

Yöntemler

create

 Giriş yapmış kullanıcıya ait olacak yeni bir Konum oluşturur.

list

 Belirtilen hesaba ilişkin konumları listeler.