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ı.

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.

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.

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ı.

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 en fazla bir alan 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 BatchGetCategories 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.

Yöntemler

create

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

list

 Belirtilen hesapla ilgili konumları listeler.