- Kaynak: Konum
- JSON gösterimi
- PhoneNumbers
- Kategoriler
- Kategori
- ServiceType
- MoreHoursType
- PostalAddress
- BusinessHours
- TimePeriod
- DayOfWeek
- TimeOfDay
- SpecialHours
- SpecialHourPeriod
- Tarih
- ServiceAreaBusiness
- BusinessType
- Yerler
- PlaceInfo
- AdWordsLocationExtensions
- LatLng
- OpenInfo
- OpenForBusiness
- Meta veri
- Profil
- RelationshipData
- RelevantLocation
- RelationType
- MoreHours
- ServiceItem
- StructuredServiceItem
- FreeFormServiceItem
- Etiket
- Para
- Yöntemler
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 ( |
Alanlar | |
---|---|
name |
Bu konum için şu biçimdeki Google tanımlayıcısı: |
languageCode |
Sabit. Konumun dili. Oluşturma sırasında ayarlanır ve güncellenemez. |
storeCode |
İ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 |
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, |
phoneNumbers |
İsteğe bağlı. Müşterilerin işletmeyle iletişime geçmek için kullanabileceği farklı telefon numaralarıdır. |
categories |
İsteğe bağlı. İşletmeyi tanımlayan farklı kategoriler. |
storefrontAddress |
İ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ş |
websiteUri |
İ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 |
İsteğe bağlı. İşletmenin çalışma saatleri. |
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 |
İ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[] |
İ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 |
İsteğe bağlı. AdWords'de yer alan ek bilgilerdir. |
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 |
openInfo |
İsteğe bağlı. Konumun şu anda açık olup olmadığını gösteren bir işaret. |
metadata |
Yalnızca çıkış. Kullanıcı tarafından düzenlenemeyen ek bilgiler. |
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 |
İsteğe bağlı. Bununla ilgili tüm konumlar ve zincirler. |
moreHours[] |
İsteğe bağlı. Bir işletmenin farklı departmanları veya belirli müşteriler için diğer çalışma saatleri. |
serviceItems[] |
İ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. |
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. 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 |
Zorunlu. Bağımsız işletmenizin konumuna mümkün olduğunca doğrudan bağlanan bir telefon numarası. Mümkünse çağrı merkezi yardım hattı numarası yerine yerel telefon numarası kullanın. |
additionalPhones[] |
İ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 ( |
Alanlar | |
---|---|
primaryCategory |
Zorunlu. Bu konumun faaliyet gösterdiği temel işi en iyi tanımlayan kategori. |
additionalCategories[] |
İsteğe bağlı. İşletmenizi açıklayan ek kategoriler. Kategoriler, müşterilerinizin ilgilendikleri hizmetler için 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 çalışma alanınızı genel olarak açıklamak için 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
Bu işletmenin ne olduğunu (ne yaptığını değil) açıklayan bir kategori. Geçerli kategori kimliklerinin listesi ve okunabilir adlarıyla eşleşmeler için categories.list
adresine bakın.
JSON gösterimi |
---|
{ "name": string, "displayName": string, "serviceTypes": [ { object ( |
Alanlar | |
---|---|
name |
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 |
Yalnızca çıkış. Kategorinin kullanıcılar tarafından okunabilen adı. Bu, konum okunurken ayarlanır. Konum değiştirilirken |
serviceTypes[] |
Yalnızca çıkış. Bu işletme kategorisinde kullanılabilen tüm hizmet türlerinin listesi. |
moreHoursTypes[] |
Yalnızca çıkış. Bu işletme kategorisi için kullanılabilen diğer çalışma saati türleri. |
ServiceType
İşletmenin sunduğu hizmet türünü açıklayan bir mesaj.
JSON gösterimi |
---|
{ "serviceTypeId": string, "displayName": string } |
Alanlar | |
---|---|
serviceTypeId |
Yalnızca çıkış. Bu hizmet türü için sabit bir kimlik (Google tarafından sağlanır). |
displayName |
Yalnızca çıkış. Hizmet türü için 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 |
Yalnızca çıkış. Google tarafından bu saat türü için sağlanan sabit bir kimlik. |
displayName |
Yalnızca çıkış. Saat türü için kullanıcılar tarafından okunabilir İngilizce görünen ad. |
localizedDisplayName |
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. posta teslimatı veya ödeme adresleri için). Bir posta adresi belirtildiğinde posta hizmeti, öğeleri posta kutusu veya benzeri bir yere teslim edebilir. Coğrafi konumları (yollar, şehirler, dağlar) modellemek için tasarlanmamıştır.
Tipik kullanımda adres, işlemin türüne bağlı olarak kullanıcı girişi veya mevcut verilerin içe aktarılması yoluyla oluşturulur.
Adres girme / düzenleme ile ilgili öneriler: - https://github.com/google/libaddressinput gibi uluslararası kullanıma hazır bir adres widget'ı kullanın) - Bu alanın kullanıldığı ülkelerin dışındaki alanlarda giriş veya düzenleme işlemleri için kullanıcılara kullanıcı arayüzü öğeleri sunulmamalıdır.
Bu şemanın nasıl kullanılacağı hakkında 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 |
Tüm yeni düzeltmeler eski düzeltmelerle geriye dönük olarak uyumlu olmalıdır. |
regionCode |
Zorunlu. Adresin bulunduğu ülkenin/bölgenin CLDR bölge kodu. Bu hiçbir zaman tahmin edilmez ve değerin doğru olduğundan emin olmak 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 sayfalarına göz atın. Örnek: İsviçre için "CH". |
languageCode |
İsteğe bağlı. 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 harf çevirisiyle eşleştirilmiş dille eşleşmesi beklenir. Bu durum belirli ülkelerde biçimlendirmeyi etkileyebilir. Ancak verilerin doğruluğu açısından kritik öneme sahip değildir ve hiçbir doğrulamayı veya biçimlendirmeyle ilgili olmayan diğer işlemleri etkilemez. Bu değer bilinmiyorsa yanlış olması muhtemel bir varsayılan değeri belirtmek yerine atlanmalıdır. Örnekler: "zh-Hant", "ja", "ja-Latn", "en". |
postalCode |
İsteğe bağlı. Adresin posta kodu. Bazı ülkeler, posta kodlarını kullanmaz veya zorunlu kılmaz ancak posta kodlarının kullanıldığı yerlerde adresin diğer bölümleriyle ek doğrulama işlemini tetikleyebilir (ör. ABD'de eyalet/posta kodu doğrulaması). |
sortingCode |
İsteğe bağlı. Ülkeye özgü ek sıralama kodu. Bu özellik çoğu bölgede kullanılmaz. Kullanıldığı yerlerde bu değer, "CEDEX" gibi bir dize ve isteğe bağlı olarak ardından bir sayı (ör. "CEDEX 7") veya sadece "sektör kodu" (Jamaika), "teslimat alanı göstergesi" (Malavi) veya "postane göstergesi" (ör. Fildişi Sahili) temsil eden bir sayıdır. |
administrativeArea |
İsteğe bağlı. Bir ülkenin 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. Daha açık belirtmek gerekirse, İspanya için bu, özerk topluluk değil, ilçedir (ör. "Katalonya" değil, "Barselona"). Birçok ülke, posta adreslerinde idari bölge kullanmaz. Örneğin, İsviçre'de bu alan boş bırakılmalıdır. |
locality |
İsteğe bağlı. Genellikle adresin şehir/ilçe bölümünü ifade eder. Örnekler: ABD şehri, BT topluluğu, Birleşik Krallık posta şehri. Dünyada, yerelliklerin iyi tanımlanmadığı veya bu yapıya tam olarak uymadığı bölgelerde yerelliği boş bırakın ve addressLines'ı kullanın. |
sublocality |
İsteğe bağlı. Adresin semti. Örneğin bu mahalleler, ilçeler, semtler olabilir. |
addressLines[] |
Bir adresin daha alt düzeylerini açıklayan yapılandırılmamış adres satırları. addressLines'daki değerler tür bilgisi içermediğinden ve bazen tek bir alanda birden çok değer içerebileceğinden (ör. "Austin, TX"), satır sırasının açık olması önemlidir. Adres satırlarının sırası, adresin ülkesi/bölgesi için "zarf siparişi" olmalıdır. Bunun değişiklik gösterebileceği yerlerde (ör. Japonya), address_language ifadesini açıkça belirtmek için kullanılır (örneğin, büyükten küçüğe sıralama için "ja", küçükten büyüğe sıralama için "ja-Latn" veya "en"). Bu şekilde, adresin en belirgin satırı dile göre seçilebilir. Bir adresin izin verilen minimum yapısal gösterimi, geri kalan tüm bilgilerin adres satırlarına yerleştirildiği bir AreaCode'dan oluşur. Böyle bir adresi coğrafi kodlama olmadan yaklaşık olarak biçimlendirmek mümkün olsa da, en azından kısmen çözümlenene kadar adres bileşenlerinin hiçbiri hakkında anlamsal akıl yürütme yapılamaz. Yalnızca AreaCode ve addressLines içeren bir adres oluşturduğunuzda (adresin hangi bölümlerinin yerel konumlar veya idari alanlar olması gerektiğini tahmin etmek yerine) tamamen yapılandırılmamış adreslerin işlenmesi için önerilen yöntem coğrafi kodlamadır. |
recipients[] |
İsteğe bağlı. Adresteki alıcı. Bu alan, belirli koşullar altında çok satırlı bilgiler içerebilir. Örneğin, "bakımı" bilgileri içerebilir. |
organization |
İsteğe bağlı. Adresteki kuruluşun adı. |
BusinessHours
Bu konumun açık olduğu dönemleri temsil eder. [TimePeriod][google.mybusiness.mybusinessinformation.v1.TimePeriod] örneklerinden oluşan bir koleksiyon barındırır.
JSON gösterimi |
---|
{
"periods": [
{
object ( |
Alanlar | |
---|---|
periods[] |
Zorunlu. Bu konumun açık olduğu saatlerin toplamı. Her dönem, konumun hafta boyunca açık olduğu bir saat aralığını temsil eder. |
TimePeriod
Belirtilen açık gün/saatle başlayıp belirtilen kapanış gününde/saatinde kapanan, işletmenin açık olduğu bir süreyi temsil eder. Kapanış saati, açılış saatinden sonra (ör. aynı günün ilerleyen saatlerinde veya sonraki bir günde) yapılmalıdır.
JSON gösterimi |
---|
{ "openDay": enum ( |
Alanlar | |
---|---|
openDay |
Zorunlu. Bu dönemin başladığı |
openTime |
Zorunlu. 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. |
closeDay |
Zorunlu. Bu dönemin bittiği |
closeTime |
Zorunlu. 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. |
DayOfWeek
Haftanın bir gününü temsil eder.
Sıralamalar | |
---|---|
DAY_OF_WEEK_UNSPECIFIED |
Haftanın günü belirtilmedi. |
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ş. API'ler artık saniyelere izin vermeyi tercih edebilir. İlgili türler şunlardır: google.type.Date
ve google.protobuf.Timestamp
.
JSON gösterimi |
---|
{ "hours": integer, "minutes": integer, "seconds": integer, "nanos": integer } |
Alanlar | |
---|---|
hours |
24 saat biçiminde günün saatleri. 0 ile 23 arasında olmalıdır. API'ler, işletmenin kapanış saati gibi senaryolar için "24:00:00" değerine izin vermeyi tercih edebilir. |
minutes |
Günün saati dakikaları. 0 ile 59 arasında olmalıdır. |
seconds |
Dakikanın saniye cinsinden saniyeleri. Normalde 0 ile 59 arasında olmalıdır. Artık saniyelere izin veren API'ler 60 değerine izin verebilir. |
nanos |
Saniyenin nanosaniye cinsinden kısmı. 0 ile 999.999.999 arasında olmalıdır. |
SpecialHours
Bir konumun çalışma saatlerinin normal çalışma saatlerinden farklı olduğu bir dizi dönemi temsil eder.
JSON gösterimi |
---|
{
"specialHourPeriods": [
{
object ( |
Alanlar | |
---|---|
specialHourPeriods[] |
Zorunlu. İşletmenin normal çalışma saatlerine ilişkin istisnalar listesi. |
SpecialHourPeriod
Bir konumun çalışma saatlerinin normal çalışma saatlerinden farklı olduğu tek bir dönemi temsil eder. Özel bir saat dönemi, 24 saatten daha kısa bir aralığı temsil etmelidir. openTime
ve startDate
, closeTime
ve endDate
tarihinden önce gelmelidir. closeTime
ve endDate
, belirtilen startDate
tarihinden sonraki gün saat 11:59'a kadar çıkabilir. Ö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 ( |
Alanlar | |
---|---|
startDate |
Zorunlu. Bu özel saat döneminin başladığı takvim tarihi. |
openTime |
İ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. |
endDate |
İsteğe bağlı. Bu özel saat döneminin sona erdiği takvim tarihi. |
closeTime |
İ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 |
İsteğe bağlı. True (doğru) değerine ayarlanırsa |
Tarih
Takvim tarihinin tamamını veya bir kısmını (ör. doğum günü) temsil eder. Günün saati ve saat dilimi, başka bir yerde belirtilmiş veya önemsiz. Tarih, Miladi Takvim ile görecelidir. Aşağıdakilerden birini gösterebilir:
- Sıfır olmayan yıl, ay ve gün değerleriyle tam tarih.
- Sıfır yıllı bir ay ve gün (örneğin, 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:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
JSON gösterimi |
---|
{ "year": integer, "month": integer, "day": integer } |
Alanlar | |
---|---|
year |
Tarihin yılı. 1 ile 9999 arasında veya yıl içermeyen bir tarih belirtmek için 0 olmalıdır. |
month |
Yılın ayı. 1 ile 12 arasında veya ay ve gün olmadan bir yıl belirtmek için 0 olmalıdır. |
day |
Ayın günü. 1 ile 31 arasında olup yıl ve ay için geçerli olmalıdır veya tek başına yıl ya da günün önemli olmadığı yıl ve ay belirtmek için 0 olmalıdır. |
ServiceAreaBusiness
Hizmet bölgesi işletmeleri, hizmetlerini müşterinin bulunduğu konumda sunar (örneğin, çilingir veya tesisatçı).
JSON gösterimi |
---|
{ "businessType": enum ( |
Alanlar | |
---|---|
businessType |
Zorunlu. Hizmet bölgesi işletmesinin [tür] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] değerini belirtir. |
places |
Bu işletmenin hizmet verdiği bölge, bir dizi yer aracılığıyla tanımlanır. |
regionCode |
Sabit. Bu hizmet bölgesi işletmesinin bulunduğu ülkenin/bölgenin CLDR bölge kodu. Ayrıntılı bilgi için http://cldr.unicode.org/ ve http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html sayfalarına göz atın. Örnek: İsviçre için "CH". Bu alan, CUSTOMER_LOCATION_ONLY işletmeler için zorunludur. Aksi takdirde yoksayılır. Burada belirtilen bölge, söz konusu işletmenin hizmet sunduğu alanlara (ör. bulunduğu bölge dışındaki bölgelerde hizmet sağlayan hizmet bölgesi işletmeleri) farklı olabilir. Konum, oluşturulduktan sonra doğrulama gerektiriyorsa doğrulama amacıyla sağlanan adres bu bölgede bulunmalı ve işletme sahibi veya yetkili temsilcisi sağlanan doğrulama adresine posta alabiliyor olmalıdır. |
BusinessType
Bu işletmenin, hizmetleri yalnızca müşterinin bulunduğu konumda mı (örneğin, çekici bir kamyon) yoksa hem adreste hem de fiziksel bir konumda mı (örneğin, müşterilere de teslimat yapan yemek alanı olan bir pizzacı) mı sunduğunu belirtir.
Sıralamalar | |
---|---|
BUSINESS_TYPE_UNSPECIFIED |
Yalnızca çıkış. Belirtilmedi. |
CUSTOMER_LOCATION_ONLY |
Yalnızca çevrede (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 bu alan boş olarak ayarlanmalıdır. |
CUSTOMER_AND_BUSINESS_LOCATION |
İşletme adresinde ve çevresinde hizmet sunulur. |
Yerler
Bir dizi yerle temsil edilen alanların birleşimini tanımlar.
JSON gösterimi |
---|
{
"placeInfos": [
{
object ( |
Alanlar | |
---|---|
placeInfos[] |
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 |
Zorunlu. Yerin yerelleştirilmiş adı. Örneğin, |
placeId |
Zorunlu. Yerin kimliği. Bir bölgeye karşılık gelmelidir. (https://developers.google.com/places/web-service/supported_types#table3) |
AdWordsLocationExtensions
AdWords'de yer alan ek bilgilerdir.
JSON gösterimi |
---|
{ "adPhone": string } |
Alanlar | |
---|---|
adPhone |
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 çiftle 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 |
Derece cinsinden enlem. [-90.0, +90.0] aralığında olmalıdır. |
longitude |
Derece cinsinden boylam. [-180.0, +180.0] aralığında olmalıdır. |
OpenInfo
İşletmenin açılış durumuyla ilgili bilgiler.
JSON gösterimi |
---|
{ "status": enum ( |
Alanlar | |
---|---|
status |
Zorunlu. Konumun şu anda faaliyette olup olmadığını belirtir. Kapalı olarak güncellenmediği sürece tüm konumlar varsayılan olarak açıktır. |
canReopen |
Yalnızca çıkış. Bu işletmenin yeniden açılmaya uygun olup olmadığını belirtir. |
openingDate |
İsteğe bağlı. Konumun ilk açıldığı tarih. Tam gün bilinmiyorsa yalnızca ay ve yıl belirtilebilir. Tarih geçmişte olmalı veya en fazla bir yıl sonrası olmalıdır. |
OpenForBusiness
Bir konumun durumunu belirtir.
Sıralamalar | |
---|---|
OPEN_FOR_BUSINESS_UNSPECIFIED |
Belirtilmedi. |
OPEN |
Konumun açık olduğunu belirtir. |
CLOSED_PERMANENTLY |
Konumun kalıcı olarak kapatıldığını belirtir. |
CLOSED_TEMPORARILY |
Konumun geçici olarak kapatıldığını belirtir. |
Meta veri
Konum hakkında 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 |
Yalnızca çıkış. Bu konumla ilişkili yer kimliğinin, müşteri tarafından güncellenmesi veya reddedilmesi gereken güncellemeler içerip içermediğini belirtir. Bu boole ayarlanırsa doğrulanması gereken bilgileri aramak için |
hasPendingEdits |
Yalnızca çıkış. Bu Konuma ait herhangi bir mülkün, düzenleme bekleme durumunda olup olmadığını belirtir. |
canDelete |
Yalnızca çıkış. Konumun API kullanılarak silinip silinemeyeceğini belirtir. |
canOperateLocalPost |
Yalnızca çıkış. Girişin yerel yayınları yönetip yönetemeyeceğini belirtir. |
canModifyServiceList |
Yalnızca çıkış. Girişin, hizmet listesini değiştirip değiştiremeyeceğini belirtir. |
canHaveFoodMenus |
Yalnızca çıkış. Girişin yemek menüsü için uygun olup olmadığını gösterir. |
canOperateHealthData |
Yalnızca çıkış. Konumun, sağlık verileri üzerinde çalışıp çalışamayacağını belirtir. |
canOperateLodgingData |
Yalnızca çıkış. Konumun, Konaklama verileri üzerinde çalışılıp çalışamayacağını belirtir. |
placeId |
Yalnızca çıkış. Bu konum Google Haritalar'da görünüyorsa, bu alan konuma ait 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 |
Yalnızca çıkış. Bu konumun çoğaltıldığı konum kaynağı. |
mapsUri |
Yalnızca çıkış. Haritalar'daki konumun bağlantısı. |
newReviewUri |
Yalnızca çıkış. Google Arama'da, müşterilerin konumla ilgili yorum bırakabileceği sayfanın bağlantısı. |
canHaveBusinessCalls |
Yalnızca çıkış. Girişin işletme aramaları için uygun olup olmadığını belirtir. |
hasVoiceOfMerchant |
Yalnızca çıkış. Girişte Satıcının Sesi özelliği olup olmadığını belirtir. Bu boole yanlışsa, neden Merchant of Merchant'a sahip olmadıklarıyla ilgili ayrıntıları almak için locations.getVoiceOfMerchantState API'yi çağırmanız gerekir. |
Profil
Konumun profiliyle ilgili tüm bilgiler.
JSON gösterimi |
---|
{ "description": string } |
Alanlar | |
---|---|
description |
Zorunlu. Konumun kendi sesinizle açıklamasıdır, başkaları tarafından düzenlenemez. |
RelationshipData
Bununla ilgili tüm üst ve alt konumlara ait bilgiler.
JSON gösterimi |
---|
{ "parentLocation": { object ( |
Alanlar | |
---|---|
parentLocation |
Bu konumun ilişkili olduğu üst konum. |
childrenLocations[] |
Bu konumun ilişkili olduğu çocuk konumlarının listesi. |
parentChain |
Bu konumun üyesi olduğu Zincirin kaynak adı. [Zincir Kimliği nasıl bulunur?] [Locations.SearchChains] |
RelevantLocation
Mevcut konumla alakalı başka bir konum hakkında bilgiler. İlişki DEPARTMENT_OF veya INDEPENDENT_ESTABLISHMENT_OF arasından herhangi biri olabilir ve burada belirtilen konum, konumun her iki tarafında da (üst/alt) olabilir.
JSON gösterimi |
---|
{
"placeId": string,
"relationType": enum ( |
Alanlar | |
---|---|
placeId |
Zorunlu. İlişkinin diğer tarafındaki konumu yerkimliğiyle belirtin. |
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ı marka/üst yönetimi/kuruluşu paylaşan, ancak mağaza çalışma saatleri veya telefon numaraları gibi farklı temel özelliklere sahip iki konum arasındaki ilişkiyi temsil eder. Örneğin, Migros Eczanesi Migros Toptan Satış departmanında bir bölümdür. |
INDEPENDENT_ESTABLISHMENT_IN |
Bu, 2 şubenin aynı fiziksel konumda, farklı şirketlerde (örneğin, Kasadaki Starbucks, bir alışveriş merkezindeki mağazalar) aynı fiziksel konumda bulunduğu durumları 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 ( |
Alanlar | |
---|---|
hoursTypeId |
Zorunlu. Çalışma saatlerinin türü. Müşteriler, bulundukları konuma ait kategorilerde desteklenen saat türlerini öğrenmek için {#link businessCategory:BatchGet}'i aramalıdır. |
periods[] |
Zorunlu. Bu konumun açık olduğu zaman koleksiyonu. Her dönem, konumun hafta boyunca açık olduğu bir saat aralığını temsil eder. |
ServiceItem
Tek bir hizmet öğesini açıklayan bir 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 ( |
Alanlar | |
---|---|
price |
İsteğe bağlı. Hizmet öğesinin parasal fiyatını gösterir. Fiyat eklenirken currencyCode ve birimler ayarlanmasını öneririz. Bu, hizmet öğesi için sabit fiyat olarak kabul edilir. |
service_item_info alanı. Aşağıdaki alanlardan biri her zaman ayarlanmalıdır. service_item_info şunlardan yalnızca biri olabilir: |
|
structuredServiceItem |
İsteğe bağlı. Bu alanda, yapılandırılmış hizmet verilerinin büyük/küçük harf ayarı ayarlanır. |
freeFormServiceItem |
İsteğe bağlı. Bu alan, serbest biçimli hizmet verileri için büyük/küçük harf kullanımı olarak ayarlanır. |
StructuredServiceItem
Satıcı tarafından sunulan yapılandırılmış bir hizmeti temsil eder. Ör. tuvalet_montajı.
JSON gösterimi |
---|
{ "serviceTypeId": string, "description": string } |
Alanlar | |
---|---|
serviceTypeId |
Zorunlu. |
description |
İsteğe bağlı. 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ı hizmet verilerimizin bir parçası olarak sunulmayan hizmetlerdir. Satıcı, bu tür hizmetlerin adlarını coğrafi satıcı platformu üzerinden manuel olarak girer.
JSON gösterimi |
---|
{
"category": string,
"label": {
object ( |
Alanlar | |
---|---|
category |
Zorunlu. Bu alan, kategori adını (kategorinin sabit kimliği) temsil eder. |
label |
Zorunlu. Öğenin dil etiketli etiketleri. Öğe adlarının 140 karakter, açıklamaların ise 250 karakterin altında 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. |
Etiket
Fiyat listesi, bölüm veya öğe görüntülenirken kullanılacak etiket.
JSON gösterimi |
---|
{ "displayName": string, "description": string, "languageCode": string } |
Alanlar | |
---|---|
displayName |
Zorunlu. Fiyat listesi, bölüm veya öğe için görünen ad. |
description |
İsteğe bağlı. Fiyat listesinin, bölümün veya öğenin açıklaması. |
languageCode |
İ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 birimi
Para birimi türüyle birlikte para tutarını temsil eder.
JSON gösterimi |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
Alanlar | |
---|---|
currencyCode |
ISO 4217'de tanımlanan üç harfli para birimi kodu. |
units |
Tutarın tam birimleri. Örneğin |
nanos |
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. |
Yöntemler |
|
---|---|
|
Giriş yapmış kullanıcıya ait yeni bir konum oluşturur. |
|
Belirtilen hesap için konumları listeler. |