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

PhoneNumbers

İşletmenin telefon numaralarının bir 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. Uluslararası telefon biçimi tercih edilir (ör. "+1 415 555 0132"). Daha fazla bilgi için https://developers.google.com/style/phone-numbers#international-phone-numbers) adresini ziyaret edin.

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

string

Zorunlu. İşletmenizin bulunduğu konuma 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ıdır. Birincil telefon numaranıza ek olarak, işletmenizin aranabileceği en fazla iki telefon numarası (cep telefonu veya sabit hat, faks numarası olamaz).

Kategoriler

İşletmeyi tanımlayan kategoriler koleksiyonu. Güncellemeler sırasında her iki alan da ayarlanmalıdır. Müşterilerin, güncelleme maskesini kullanarak birincil veya ek kategorileri ayrı ayrı 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şletmeyi en iyi tanımlayan kategori.
additionalCategories[]

object (Category)

İsteğe bağlıdır. İş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 kalması için temel iş sahanızı tanımlarken mümkün olduğunca az sayıda kategori seçin. Mümkün olduğunca spesifik ancak ana işletmenizi temsil eden kategoriler seçin.

Kategori

Bu işletmenin ne olduğunu (ne yaptığını değil) açıklayan bir kategori. Geçerli kategori kimliklerinin ve bunların okunabilir adlarıyla eşlemelerinin listesi için categories.list adresini ziyaret edin.

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). Kategori değiştirilirken (bir konum oluşturulurken veya güncellenirken) değer 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 kategorisi için kullanılabilen tüm hizmet türlerinin listesi.
moreHoursTypes[]

object (MoreHoursType)

Yalnızca çıkış. Bu işletme kategorisi için kullanılabilen diğer çalışma saatleri türleri.

ServiceType

İşletmenin sunduğu hizmet türünü açıklayan bir 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ünün kullanıcılar tarafından okunabilen görünen adı.

MoreHoursType

Bir işletmenin normal çalışma saatlerine ek olarak sunabileceği diğer çalışma saatleri türleri.

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

string

Yalnızca çıkış. Google tarafından bu çalışma saati türü için sağlanan sabit bir kimlik.
displayName

string

Yalnızca çıkış. Çalışma saatleri türünün kullanıcılar tarafından okunabilen İngilizce görünen adı.
localizedDisplayName

string

Yalnızca çıkış. Çalışma saatleri türünün kullanıcılar tarafından okunabilen yerelleştirilmiş görünen adı.

PostalAddress

Posta adresi veya ödeme adresi gibi bir posta adresini temsil eder. Posta hizmetleri, posta adreslerini kullanarak bir tesise, posta kutusuna veya benzer bir yere öğe teslim edebilir. Posta adresi; yollar, kasabalar veya dağlar gibi coğrafi konumları modellemek için tasarlanmamıştır.

Normal kullanımda, işlem türüne bağlı olarak kullanıcı girişiyle veya mevcut veriler içe aktarılarak bir adres oluşturulur.

Adres girişi veya düzenlemeyle ilgili öneriler:

  • https://github.com/google/libaddressinput gibi uluslararası kullanıma hazır bir adres widget'ı kullanın.
  • Kullanıcılara, alanların kullanıldığı ülkeler dışında alan girişi veya düzenleme için kullanıcı arayüzü öğeleri gösterilmemelidir.

Bu şemanın nasıl kullanılacağı hakkında daha fazla bilgi için https://support.google.com/business/answer/6397478 adresini ziyaret edin.

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 olarak ayarlanmalıdır.

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

string

Zorunlu. Adresin bulunduğu ülkenin/bölgenin CLDR bölge kodu. Bu değer hiçbir zaman tahmin edilmez ve değerin doğruluğundan kullanıcı sorumludur. Ayrıntılar için https://cldr.unicode.org/ ve https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html adreslerini ziyaret edin. Örnek: İsviçre için "CH".
languageCode

string

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

Bu değer bilinmiyorsa (yanlış olabilecek bir varsayılan değer belirtmek yerine) atlanmalıdır.

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

string

İsteğe bağlıdır. Adresin posta kodu. Tüm ülkelerde posta kodu kullanılmaz veya zorunlu tutulmaz. Ancak kullanıldığı yerlerde, adresin diğer bölümleriyle (ör. ABD'de eyalet veya posta kodu doğrulaması) ek doğrulama tetiklenebilir.
sortingCode

string

İsteğe bağlıdır. Ülkeye özgü ek sıralama kodu. Bu seçenek çoğu bölgede kullanılmaz. Kullanıldığı yerlerde değer, "CEDEX" gibi bir dize ve isteğe bağlı olarak bir sayı (örneğin, "CEDEX 7") veya "sektör kodu" (Jamaika), "teslimat bölgesi göstergesi" (Malavi) ya da "postane göstergesi"ni (Fildişi Sahili) temsil eden tek bir sayıdır.
administrativeArea

string

İsteğe bağlıdır. 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, bölge veya idari bölge olabilir. İspanya için bu, özerk topluluk değil, ildir (örneğin, "Katalonya" değil, "Barselona"). Birçok ülkede posta adreslerinde bağlı olduğu yer kullanılmaz. Örneğin, İsviçre'de bu alan boş bırakılmalıdır.
locality

string

İsteğe bağlıdır. Genellikle adresin şehir veya kasaba kısmını ifade eder. Örnekler: ABD'de şehir, İtalya'da belediye, Birleşik Krallık'ta posta şehri. Bölgelerin iyi tanımlanmadığı veya bu yapıya uymadığı yerlerde locality alanını boş bırakın ve addressLines alanını kullanın.
sublocality

string

İsteğe bağlıdır. Adresin alt yerleşim yeri. Örneğin, bu bir mahalle, semt veya ilçe olabilir.
addressLines[]

string

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

addressLines içindeki değerlerde tür bilgisi olmadığından ve bazen tek bir alanda birden fazla değer (ör. "Austin, TX") bulunabileceğinden satır sırasının net olması önemlidir. Adres satırlarının sırası, adresin bulunduğu ülke veya bölge için "zarf sırası" olmalıdır. Bu durumun değişiklik gösterebileceği yerlerde (ör. Japonya) address_language, bunu açıkça belirtmek için kullanılır (ör. büyükten küçüğe sıralama için "ja" ve küçükten büyüğe sıralama için "ja-Latn" veya "en"). Bu şekilde, dile göre bir adresin en spesifik satırı seçilebilir.

Bir adresin izin verilen minimum yapısal gösterimi, kalan tüm bilgilerin addressLines içine yerleştirildiği bir regionCode öğesinden oluşur. Bu tür bir adresi coğrafi kodlama olmadan yaklaşık olarak biçimlendirmek mümkün olabilir ancak en azından kısmen çözümlenene kadar adres bileşenlerinden herhangi biri hakkında anlamsal bir çıkarım yapılamaz.

Yalnızca regionCode ve addressLines içeren bir adres oluşturup ardından coğrafi kodlama yapmak, tamamen yapılandırılmamış adresleri işlemenin önerilen yoludur (adresin hangi bölümlerinin şehir veya bağlı olduğu yer olması gerektiğini tahmin etmenin aksine).
recipients[]

string

İsteğe bağlıdır. Adresteki alıcı. Bu alan, belirli koşullar altında çok satırlı bilgiler içerebilir. Örneğin, "aracılığıyla" bilgisini içerebilir.
organization

string

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

BusinessHours

Bu konumun açık olduğu dönemleri temsil eder. [TimePeriod][google.mybusiness.mybusinessinformation.v1.TimePeriod] örneklerinin bir koleksiyonunu barındırır.

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

object (TimePeriod)

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

TimePeriod

İşletmenin açık olduğu, belirtilen açılış günü/saatinde başlayıp belirtilen kapanış günü/saatinde sona eren bir zaman aralığını temsil eder. Kapanış saati, açılış saatinden sonra olmalıdır (ör. 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şladığı day of the week değerini belirtir.
openTime

object (TimeOfDay)

Zorunlu. Geçerli değerler 00:00-24:00 arasındadır. 24:00, belirtilen gün alanının sonundaki gece yarısını temsil eder. Not: Proto3 JSON eşlemesinde, varsayılan sıfır değerleri (00:00) atlanır ve openTime için {} değeri üretilir.
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. 24:00, belirtilen gün alanının sonundaki gece yarısını temsil eder. Not: Proto3 JSON eşlemesinde, varsayılan sıfır değerleri (00:00) atlanır ve closeTime için {} oluşturulur.

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 bir saatini temsil eder. Tarih ve saat dilimi önemli değildir veya başka bir yerde belirtilmiştir. Bir API, artık saniyelere 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'dan büyük veya 0'a eşit olmalı ve genellikle 23'ten küçük veya 23'e eşit olmalıdır. Bir API, işletmenin kapanış saati gibi senaryolar için "24:00:00" değerine izin vermeyi seçebilir.
minutes

integer

Saatin dakikası. 0'dan büyük veya 0'a eşit ve 59'dan küçük veya 59'a eşit olmalıdır.
seconds

integer

Bir dakikanın saniyeleri. 0'dan büyük veya 0'a eşit olmalı ve genellikle 59'dan küçük veya 59'a eşit olmalıdır. Bir API, artık saniyelere izin veriyorsa 60 değerine izin verebilir.
nanos

integer

Nanosaniye cinsinden saniye kesirleri. 0'dan büyük veya 0'a eşit ve 999.999.999'dan küçük veya 999.999.999'a eşit olmalıdır.

SpecialHours

Bir konumun çalışma saatlerinin normal çalışma saatlerinden farklı olduğu zaman aralıklarını temsil 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 dönemi 24 saatten kısa bir aralığı temsil etmelidir. openTime ve startDate, closeTime ve endDate değerlerinden önce olmalıdır. closeTime ve endDate, belirtilen startDate tarihinden sonraki gün saat 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 çalışma saatleri döneminin başladığı takvim tarihi.
openTime

object (TimeOfDay)

İsteğe bağlıdır. Geçerli değerler 00:00-24:00 arasındadır. 24:00, belirtilen gün alanının sonundaki gece yarısını temsil eder. closed false ise belirtilmelidir.
endDate

object (Date)

İsteğe bağlıdır. Bu özel çalışma saati döneminin sona erdiği takvim tarihi. endDate alanı ayarlanmazsa varsayılan olarak startDate alanında belirtilen tarih kullanılır. Bu alan ayarlanırsa startDate ile aynı veya en fazla 1 gün sonra olmalıdır.
closeTime

object (TimeOfDay)

İsteğe bağlıdır. Geçerli değerler 00:00-24:00 arasındadır. 24:00, belirtilen gün alanının sonundaki gece yarısını temsil eder. closed false ise belirtilmelidir.
closed

boolean

İsteğe bağlıdır. Doğru olarak belirlenirse endDate, openTime ve closeTime yoksayılır ve startDate içinde belirtilen tarih, konumun tüm gün kapalı olduğu tarih olarak kabul edilir.

Tarih

Doğum günü gibi tam veya kısmi bir takvim tarihini temsil eder. Günün saati ve saat dilimi başka bir yerde belirtilmiştir veya önemsizdir. Tarih, Miladi Takvim'e göredir. Bu, aşağıdakilerden birini temsil edebilir:

  • Sıfır olmayan yıl, ay ve gün değerlerini içeren tam bir tarih.
  • Yılın sıfır olduğu bir ay ve gün (örneğin, yıl dönümü).
  • Ay ve günün sıfır olduğu, yalnızca yılın belirtildiği tarih.
  • Sıfır gün içeren bir yıl ve ay (örneğin, kredi kartının 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 olmalıdır veya yıl olmadan bir tarih belirtmek için 0 olmalıdır.
month

integer

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

integer

Ayın günü. 1 ile 31 arasında olmalı ve yıl ile ay için geçerli olmalıdır. Yılı tek başına veya günün önemli olmadığı bir yıl ve ayı belirtmek için 0 olmalıdır.

ServiceAreaBusiness

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

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

enum (BusinessType)

Zorunlu. Hizmet bölgesi işletmesinin [türünü] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] belirtir.
places

object (Places)

İsteğe bağlıdır. Bu işletmenin hizmet verdiği bölge, bir dizi yerle tanımlanır.
regionCode

string

Değiştirilemez. 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 adreslerini ziyaret edin. Örnek: İsviçre için "CH".

Bu alan, CUSTOMER_LOCATION_ONLY işletmeleri için zorunludur ve diğer durumlarda yoksayılır.

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

Bu konumun oluşturulduktan sonra doğrulanması gerekiyorsa doğrulama amacıyla sağlanan adres bu bölgede olmalıdır ve işletme sahibi veya yetkili temsilcisi, sağlanan doğrulama adresine posta alabilmelidir.

BusinessType

Bu işletmenin yalnızca müşterinin bulunduğu yerde mi (ör. çekici) yoksa hem bir adreste hem de müşterinin bulunduğu yerde mi (ör. yemek alanı olan ve müşterilere teslimat da yapan bir pizza dükkanı) hizmet verdiğini belirtir.

Sıralamalar
BUSINESS_TYPE_UNSPECIFIED Yalnızca çıkış. Belirtilmedi.
CUSTOMER_LOCATION_ONLY Yalnızca çevre bölgede hizmet sunar (işletme adresinde hizmet sunmaz). Bir işletme CUSTOMER_AND_BUSINESS_LOCATION'dan CUSTOMER_LOCATION_ONLY'ye güncelleniyorsa konum güncellemesi storefrontAddress alan maskesini içermeli ve alanı boş olarak ayarlamalıdır.
CUSTOMER_AND_BUSINESS_LOCATION İş adresinde ve çevresinde hizmet sunar.

Yerler

Bir dizi yer tarafından temsil edilen alanların birleşimini tanımlar.

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

object (PlaceInfo)

İsteğe bağlıdır. Yer kimlikleriyle temsil edilen alanlar. En fazla 20 yerle sınırlıdır.

PlaceInfo

Bir yer kimliğiyle temsil edilen 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'te gösterilen ek bilgiler.

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

string

Zorunlu. AdWords yer uzantılarında konumun birincil telefon numarası yerine gösterilecek alternatif telefon numarası.

LatLng

Enlem/boylam çiftini temsil eden bir nesne. Bu, enlem ve boylam derecelerini temsil eden bir çift double olarak ifade edilir. Aksi belirtilmedikçe bu nesne WGS84 standardına uygun olmalıdır. Değerler normalleştirilmiş aralıklarda 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ı olarak 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ı gösterir.
openingDate

object (Date)

İsteğe bağlıdır. Konumun ilk açıldığı tarih. Tam gün bilinmiyorsa yalnızca ay ve yıl belirtilebilir. Tarih, geçmişte olmalı veya gelecekte bir yıldan fazla 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 kapatıldığını gösterir.
CLOSED_TEMPORARILY Konumun geçici olarak kapalı olduğunu gösterir.

Meta veri

Konumla ilgili, kullanıcı 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,
  "isParticularlyPersonalPlace": boolean
}
Alanlar
hasGoogleUpdated

boolean

Yalnızca çıkış. Bu konumla ilişkili yer kimliğinde, müşteri tarafından güncellenmesi veya reddedilmesi gereken güncellemeler olup olmadığını gösterir. Bu boole değeri ayarlanmışsa doğrulanması gereken bilgileri aramak için getGoogleUpdated yöntemini çağırmanız gerekir.
hasPendingEdits

boolean

Yalnızca çıkış. Bu konumun özelliklerinden herhangi birinin düzenleme bekleyen durumda olup olmadığını gösterir.
canDelete

boolean

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

boolean

Yalnızca çıkış. Desteği sonlandırıldı: Bu alan artık doldurulmuyor ve gelecekteki bir sürümde kaldırılacak.
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 işlem yapıp yapamayacağını gösterir.
canOperateLodgingData

boolean

Yalnızca çıkış. Konumun konaklama verileri üzerinde işlem yapıp yapamayacağı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 kopyaladığı konum kaynağı.
mapsUri

string

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

string

Yalnızca çıkış. Müşterilerin Google Arama'da konum için yorum bırakabileceği sayfanın bağlantısı.
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ı gösterir. Bu boole değeri yanlışsa işletmenin neden Satıcıların Sesi'ne sahip olmadığıyla ilgili ayrıntıları öğrenmek için locations.getVoiceOfMerchantState API'sini çağırmanız gerekir.
isParticularlyPersonalPlace

boolean

Yalnızca çıkış. Konumun hassas kişisel yer olarak sınıflandırılıp sınıflandırılmadığını gösterir. Bu, Konum Geçmişi özelliklerinde kısıtlamalar olduğu anlamına gelir. Bunun bir hata olduğunu düşünüyorsanız Yardım Merkezi makalesine göz atın.

Profil

Konumun profiliyle ilgili tüm bilgiler.

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

string

Zorunlu. Konumun kendi sesinizle yapılan açıklaması. Başka kimse tarafından düzenlenemez.

RelationshipData

Bu konumla ilgili tüm üst ve alt konumların bilgileri.

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

object (RelevantLocation)

İsteğe bağlıdır. Bu konumun ilişkili olduğu üst konum.
childrenLocations[]

object (RelevantLocation)

İsteğe bağlıdır. Bu konumun ilişkili olduğu alt konumların listesi.
parentChain

string

İsteğe bağlıdır. Bu konumun üyesi olduğu zincirin kaynak adı. [How to find Chain ID] [Locations.SearchChains]

RelevantLocation

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

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

string

Zorunlu. İlişkinin diğer tarafındaki konumu, placeID'sine göre 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, aynı fiziksel alanı, aynı markayı/üst yönetimi/kuruluşu paylaşan ancak mağaza çalışma saatleri veya telefon numaraları gibi farklı temel özelliklere sahip 2 konum arasındaki ilişkiyi temsil eder. Örneğin, Costco Eczanesi, Costco Toptan Satış'ın bir bölümüdür.
INDEPENDENT_ESTABLISHMENT_IN Bu, 2 konumun aynı fiziksel konumda bulunduğu ancak farklı şirketlere ait olduğu durumları (ör. Safeway'deki Starbucks, alışveriş merkezindeki mağazalar) temsil eder.

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. Çalışma saatlerinin türü. İstemciler, konumlarının kategorileri için desteklenen çalışma saati türlerini öğrenmek üzere {#link businessCategories:BatchGet} yöntemini çağırmalıdır.
periods[]

object (TimePeriod)

Zorunlu. Bu konumun açık olduğu saatlerin listesi. Her dönem, konumun hafta boyunca 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ü açıklamak için kullanılır. Örneğin, saç kesimi bir hizmet olabilir.

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "structuredServiceItem": {
    object (StructuredServiceItem)
  },
  "freeFormServiceItem": {
    object (FreeFormServiceItem)
  }
  // End of mutually exclusive fields.
}
Alanlar
price

object (Money)

İsteğe bağlıdır. Hizmet öğesinin parasal fiyatını temsil eder. Fiyat eklerken currencyCode ve units değerlerinin ayarlanmasını öneririz. Bu, hizmet öğesi için sabit fiyat olarak kabul edilir.
Aşağıdaki alanlardan biri her zaman ayarlanmalıdır. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta alanlardan en fazla biri ayarlanır:
structuredServiceItem

object (StructuredServiceItem)

İsteğe bağlıdır. Bu alan, yapılandırılmış hizmet verileri için ayarlanır.
freeFormServiceItem

object (FreeFormServiceItem)

İsteğe bağlıdır. Bu alan, serbest biçimli hizmet verileri için ayarlanır.
Birbirini hariç tutan alanların sonu.

StructuredServiceItem

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

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

string

Zorunlu. serviceTypeId alanı, Google tarafından sağlanan ve ServiceType içinde bulunabilen benzersiz bir kimliktir. Bu bilgiler categories.batchGet RPC hizmeti tarafından sağlanır.
description

string

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

FreeFormServiceItem

Satıcı tarafından sunulan serbest biçimli bir hizmeti temsil eder. Bunlar, yapı hizmeti verilerimizin bir parçası olarak gösterilmeyen hizmetlerdir. Satıcı, bu tür hizmetlerin adlarını bir coğrafi satıcı yüzeyi kullanarak manuel olarak girer.

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

string

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

object (Label)

Zorunlu. Öğenin dil etiketli etiketleri. Öğe adlarının en fazla 140 karakter, açıklamaların ise en fazla 250 karakter olmasını öneririz. Bu alan yalnızca giriş özel bir hizmet öğesiyse ayarlanmalıdır. Standartlaştırılmış hizmet türleri, serviceTypeId kullanılarak 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 öğenin görünen adı.
description

string

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

string

İsteğe bağlıdır. Bu dizelerin geçerli olduğu BCP-47 dil kodu. Dil başına yalnızca bir etiket grubu ayarlanabilir.

Para

Para birimi türüyle birlikte para miktarını temsil eder.

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 birimleri. Örneğin, currencyCode "USD" ise 1 birim, bir ABD dolarıdır.
nanos

integer

Miktarın nano (10^-9) birim sayısı. Değer, -999.999.999 ile +999.999.999 arasında (değerler dahil) 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 ABD doları units=-1 ve nanos=-750.000.000 olarak gösterilir.

Yöntemler

create

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

list

 Belirtilen hesapla ilgili konumları listeler.