REST Resource: accounts.locations

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,
  "locationName": string,
  "primaryPhone": string,
  "additionalPhones": [
    string
  ],
  "address": {
    object (PostalAddress)
  },
  "primaryCategory": {
    object (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ],
  "websiteUrl": string,
  "regularHours": {
    object (BusinessHours)
  },
  "specialHours": {
    object (SpecialHours)
  },
  "serviceArea": {
    object (ServiceAreaBusiness)
  },
  "locationKey": {
    object (LocationKey)
  },
  "labels": [
    string
  ],
  "adWordsLocationExtensions": {
    object (AdWordsLocationExtensions)
  },
  "latlng": {
    object (LatLng)
  },
  "openInfo": {
    object (OpenInfo)
  },
  "locationState": {
    object (LocationState)
  },
  "attributes": [
    {
      object (Attribute)
    }
  ],
  "metadata": {
    object (Metadata)
  },
  "priceLists": [
    {
      object (PriceList)
    }
  ],
  "profile": {
    object (Profile)
  },
  "relationshipData": {
    object (RelationshipData)
  },
  "moreHours": [
    {
      object (MoreHours)
    }
  ]
}
Alanlar
name

string

Bu konum için şu biçimdeki Google tanımlayıcısı: accounts/{accountId}/locations/{locationId}

Eşleşmeler söz konusu olduğunda bu alan doldurulmaz.

languageCode

string

Konumun dili. Oluşturma sırasında ayarlanır ve güncellenemez.

storeCode

string

Bu konumun harici tanımlayıcısı. Bu tanımlayıcı, belirli bir hesapta benzersiz olmalıdır. Bu şekilde konumu kendi kayıtlarınızla ilişkilendirebilirsiniz.

locationName

string

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, Address, Categories) ek bilgiler yer alabilir. Adınıza gereksiz bilgiler eklemeyin (örneğin, "Google Inc. - Mountain View Şirket Merkezi" yerine "Google"ı 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 koruma bilgileri (örneğin, "Duane Reade'deki Chase ATM") eklemeyin.

primaryPhone

string

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[]

string

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

address

object (PostalAddress)

İşletmenizin konumunu belirten tam ve doğru adrestir. Uzak konumlarda bulunan posta kutuları kabul edilmez. Şu anda, adreste en fazla beş addressLines değeri belirtebilirsiniz.

primaryCategory

object (Category)

Bu konumun faaliyet gösterdiği temel işi en iyi tanımlayan kategori.

additionalCategories[]

object (Category)

İş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.

websiteUrl

string

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

object (BusinessHours)

İşletmenin çalışma saatleri.

specialHours

object (SpecialHours)

İş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.

serviceArea

object (ServiceAreaBusiness)

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.

locationKey

object (LocationKey)

Bu işletmeyi Google+ Sayfası ve Google Haritalar Yerler gibi diğer Google mülklerine bağlayan bir anahtar koleksiyonu.

labels[]

string

İş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. 255 karakterle sınırlıdır (etiket başına).

adWordsLocationExtensions

object (AdWordsLocationExtensions)

AdWords'de yer alan ek bilgilerdir.

latlng

object (LatLng)

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 latlng değeri oluşturma sırasında kabul edilmişse veya latlng değeri İşletme Profili web sitesi üzerinden güncellenmişse alma isteklerinde döndürülür. Bu alan güncellenemiyor.

openInfo

object (OpenInfo)

Konumun şu anda açık olup olmadığını gösteren bir işaret.

locationState

object (LocationState)

Yalnızca çıkış. Bir konumun durumunu yansıtan boole grubu.

attributes[]

object (Attribute)

Bu konum için özellikler

metadata

object (Metadata)

Yalnızca Çıkış. Kullanıcı tarafından düzenlenemeyen ek bilgiler.

priceLists[]
(deprecated)

object (PriceList)

Kullanımdan kaldırıldı: Bu konum için fiyat listesi bilgileri.

profile

object (Profile)

İşletmenizi kendi sesinizle anlatır ve işletmenizin benzersiz hikayesini ve tekliflerinizi kullanıcılarla paylaşır.

relationshipData

object (RelationshipData)

Bununla ilgili tüm konumlar ve zincirler.

moreHours[]

object (MoreHours)

Bir işletmenin farklı departmanları veya belirli müşteriler için diğer çalışma saatleri.

BusinessHours

Bu konumun açık olduğu dönemleri temsil eder. TimePeriod örnekten oluşan bir koleksiyon tutar.

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

object (TimePeriod)

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 (DayOfWeek),
  "openTime": string,
  "closeDay": enum (DayOfWeek),
  "closeTime": string
}
Alanlar
openDay

enum (DayOfWeek)

Bu dönemin başladığı day of the week tarihini belirtir.

openTime

string

24 saat ISO 8601 genişletilmiş biçimde (ss:dd) saat. 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

enum (DayOfWeek)

Bu dönemin bittiği day of the week bilgisini belirtir.

closeTime

string

24 saat ISO 8601 genişletilmiş biçimde (ss:dd) saat. 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

SpecialHours

Bir konumun çalışma saatlerinin normal çalışma saatlerinden farklı olduğu bir dizi dönemi temsil eder.

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

object (SpecialHourPeriod)

İş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 (Date)
  },
  "openTime": string,
  "endDate": {
    object (Date)
  },
  "closeTime": string,
  "isClosed": boolean
}
Alanlar
startDate

object (Date)

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

openTime

string

Bir konum açıldığında startDate itibarıyla geçerli olan duvar süresi. 24 saat ISO 8601 genişletilmiş biçiminde ifade edilir. (ss:dd) 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. isClosed yanlış ise bu değer belirtilmelidir.

endDate

object (Date)

Bu özel saat döneminin sona erdiği takvim tarihi. endDate alanı ayarlanmazsa startDate için belirtilen tarih varsayılan olarak ayarlanır. Ayarlanırsa bu alan, startDate ile eşit veya bu tarihten en fazla 1 gün sonra olmalıdır.

closeTime

string

Bir konum kapatıldığında endDate üzerindeki duvar süresi (24 saatlik ISO 8601 genişletilmiş biçimiyle ifade edilir). (ss:dd) 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. isClosed yanlış ise bu değer belirtilmelidir.

isClosed

boolean

True (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ı olan konum olarak değerlendirilir.

ServiceAreaBusiness

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

JSON gösterimi
{
  "businessType": enum (BusinessType),

  // Union field coverageArea can be only one of the following:
  "radius": {
    object (PointRadius)
  },
  "places": {
    object (Places)
  }
  // End of list of possible types for union field coverageArea.
}
Alanlar
businessType

enum (BusinessType)

Hizmet bölgesi işletmesinin type bilgisini belirtir.

coverageArea alanı. İşletmenin hizmet sunduğu kapsama alanını belirtir. coverageArea şunlardan yalnızca biri olabilir:
radius

object (PointRadius)

Yalnızca çıkış. Bu işletmenin hizmet verdiği bölge bir noktanın merkezindedir.

places

object (Places)

Bu işletmenin hizmet verdiği bölge, bir dizi yer aracılığıyla tanımlanı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.
CUSTOMER_AND_BUSINESS_LOCATION İşletme adresinde ve çevresinde hizmet sunulur.

PointRadius

Belirli bir noktanın çevresindeki yarıçap (enlem/boylam).

JSON gösterimi
{
  "latlng": {
    object (LatLng)
  },
  "radiusKm": number
}
Alanlar
latlng

object (LatLng)

Yarıçapla tanımlanmış bir alanın merkezini belirten enlem/boylam.

radiusKm

number

Noktanın çevresindeki alanın kilometre cinsinden mesafesi.

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

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.

Yerler

Bir dizi yerle 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
{
  "name": string,
  "placeId": string
}
Alanlar
name

string

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

placeId

string

Yerin kimliği. Bir bölgeye karşılık gelmelidir.

LocationKey

Bir konum için anahtar referansları/vekilleri.

JSON gösterimi
{
  "plusPageId": string,
  "placeId": string,
  "explicitNoPlaceId": boolean,
  "requestId": string
}
Alanlar
plusPageId

string

Yalnızca çıkış. Bu konumla ilişkilendirilmiş bir Google+ sayfası varsa bu alan, söz konusu konumun Google+ sayfası kimliğiyle doldurulur.

placeId

string

Bu konum doğrulandıysa ve Google Haritalar'a bağlıysa/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 konum doğrulanmamışsa ve konumun Google Haritalar'da görünen bir yerle ilişkilendirilmesi durumunda bu alan doldurulabilir.

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

Ek explicitNoPlaceId bool, ayarlanmamış bir yer kimliğinin kasıtlı olup olmadığını nitelendirir.

explicitNoPlaceId

boolean

Yalnızca çıkış. Doğru değeri, ayarlanmamış yer kimliğinin kasıtlı olduğunu gösterir. Bu değer, henüz hiçbir ilişkilendirme yapılmamasından farklıdır.

requestId

string

Yalnızca çıkış. Bu konumu oluşturmak için requestId kullanıldı. Bu konum Google Benim İşletmem API'si veya İşletme Profili Konumları'nın dışında oluşturulmuşsa boş olabilir.

AdWordsLocationExtensions

AdWords'de yer alan ek bilgilerdir.

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

string

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

OpenInfo

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

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

enum (OpenForBusiness)

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

boolean

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

openingDate

object (Date)

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. Bu değer yalnızca yayınlanan konumlara uygulanabilir (ör. locationState.is_publish = true). Durum alanını bu değere güncellerken, istemcilerin updateMask değerini açıkça openInfo.status olarak ayarlaması gerekir. Bu güncelleme görüşmesi sırasında başka güncelleme maskesi ayarlanamaz. Bu geçici bir kısıtlamadır ve yakında gevşetilecektir.

LocationState

Bir Konumun durumunu yansıtan bir boole grubu içerir.

JSON gösterimi
{
  "isGoogleUpdated": boolean,
  "isDuplicate": boolean,
  "isSuspended": boolean,
  "canUpdate": boolean,
  "canDelete": boolean,
  "isVerified": boolean,
  "needsReverification": boolean,
  "isPendingReview": boolean,
  "isDisabled": boolean,
  "isPublished": boolean,
  "isDisconnected": boolean,
  "isLocalPostApiDisabled": boolean,
  "canModifyServiceList": boolean,
  "canHaveFoodMenus": boolean,
  "hasPendingEdits": boolean,
  "hasPendingVerification": boolean,
  "canOperateHealthData": boolean,
  "canOperateLodgingData": boolean
}
Alanlar
isGoogleUpdated

boolean

Yalnızca çıkış. Bu konumla ilişkili yer kimliğinin güncellenmesi olup olmadığını belirtir.

isDuplicate

boolean

Yalnızca çıkış. Konumun başka bir konumun tekrarı olup olmadığını belirtir.

isSuspended

boolean

Yalnızca çıkış. Konumun askıya alınıp alınmadığını belirtir. Askıya alınan konumlar, Google ürünlerinde son kullanıcılara gösterilmez. Bunun bir hata olduğunu düşünüyorsanız Yardım Merkezi makalesini inceleyin.

canUpdate

boolean

Yalnızca çıkış. Konumun güncellenip güncellenemeyeceğini belirtir.

canDelete

boolean

Yalnızca çıkış. Konumun Google Benim İşletmem API'si kullanılarak silinip silinemeyeceğini belirtir.

isVerified

boolean

Yalnızca çıkış. Konumun doğrulanıp doğrulanmadığını belirtir.

needsReverification

boolean

Yalnızca çıkış. Konumun yeniden doğrulama gerektirip gerektirmediğini belirtir.

isPendingReview

boolean

Yalnızca çıkış. Konumun incelenmesinin beklemede olup olmadığını belirtir.

isDisabled

boolean

Yalnızca çıkış. Konumun devre dışı olup olmadığını belirtir.

isPublished

boolean

Yalnızca çıkış. Konumun yayınlanıp yayınlanmadığını belirtir.

isDisconnected

boolean

Yalnızca çıkış. Konumun Google Haritalar'daki bir yerle bağlantısının kesilip kesilmediğini belirtir.

isLocalPostApiDisabled

boolean

Yalnızca çıkış. accounts.locations.localPosts'un bu konum için devre dışı bırakılıp bırakılmadığını belirtir.

canModifyServiceList

boolean

Yalnızca çıkış. Girişin bir Hizmet Listesi'ni değiştirip değiştiremeyeceğini belirtir.

canHaveFoodMenus

boolean

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

hasPendingEdits

boolean

Yalnızca çıkış. Bu Konuma ait herhangi bir mülkün, düzenleme bekleme durumunda olup olmadığını belirtir.

hasPendingVerification

boolean

Yalnızca çıkış. Konumun bekleyen doğrulama istekleri olup olmadığını belirtir.

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 çalışılıp çalışamayacağını belirtir.

Özellik

Bir konum özelliği. Özellikler, bir konum hakkında ek bilgiler sağlar. Bir konum için ayarlanabilen özellikler, söz konusu konumun özelliklerine (ör. kategori) göre değişiklik gösterebilir. Kullanılabilir özellikler Google tarafından belirlenir ve API değişiklikleri olmadan eklenebilir ve kaldırılabilir.

JSON gösterimi
{
  "attributeId": string,
  "valueType": enum (AttributeValueType),
  "values": [
    value
  ],
  "repeatedEnumValue": {
    object (RepeatedEnumAttributeValue)
  },
  "urlValues": [
    {
      object (UrlAttributeValue)
    }
  ]
}
Alanlar
attributeId

string

Özelliğin kimliği. Özellik kimlikleri Google tarafından sağlanır.

valueType

enum (AttributeValueType)

Yalnızca çıkış. Bu özelliğin içerdiği değerin türü. Bu, değerin nasıl yorumlanacağını belirlemek için kullanılmalıdır.

values[]

value (Value format)

Bu özelliğin değerleri. Sağlanan değerlerin türü, söz konusu özellik için beklenenle eşleşmelidir. AttributeValueType. Bu, birden fazla özellik değerinin sağlanabileceği yinelenen bir alandır. Özellik türleri yalnızca bir değeri destekler.

repeatedEnumValue

object (RepeatedEnumAttributeValue)

Özellik değer türü REPEATED_ENUM olduğunda özellik değerini içerir ve diğer değer alanları boş olmalıdır.

urlValues[]

object (UrlAttributeValue)

Özellik değeri türü URL ise bu alan, bu özelliğe ait değerleri içerir ve diğer değerler alanları boş olmalıdır.

RepeatedEnumAttributeValue

valueType değeri REPEATED_ENUM olan bir özelliğin değerleri. Bu liste, ayarlanan (doğru) ve ayarlanmamış (false) olmak üzere iki değer kimliği listesinden oluşur. Eksik değerler bilinmeyen olarak kabul edilir. En az bir değer belirtilmelidir.

JSON gösterimi
{
  "setValues": [
    string
  ],
  "unsetValues": [
    string
  ]
}
Alanlar
setValues[]

string

Ayarlanan sıralama değerleri.

unsetValues[]

string

Ayarlanmamış enum değerleri.

UrlAttributeValue

valueType URL'ye sahip bir özelliğin değerleri.

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

string

URL.

Meta veri

Konum hakkında kullanıcılar tarafından düzenlenemeyen ek bilgiler.

JSON gösterimi
{
  "duplicate": {
    object (Duplicate)
  },
  "mapsUrl": string,
  "newReviewUrl": string
}
Alanlar
duplicate
(deprecated)

object (Duplicate)

Bu konumun yinelendiği konumla ilgili bilgiler. Yalnızca locationState.is_duplicate doğru olduğunda mevcut. Kullanımdan kaldırıldı: Yinelenenlerle ilgili ayrıntılı bilgileri artık desteklemiyoruz.

mapsUrl

string

Haritalar'daki konumun bağlantısı.

newReviewUrl

string

Google Arama'da, müşterilerin konumla ilgili yorum bırakabileceği sayfanın bağlantısı.

Kopyasını Oluştur

Bu konumun yinelendiği konumla ilgili bilgiler.

JSON gösterimi
{
  "locationName": string,
  "placeId": string,
  "access": enum (Access)
}
Alanlar
locationName

string

Bunun çoğaltıldığı konumun kaynak adı. Yalnızca kimliği doğrulanan kullanıcının bu konum için erişim hakları varsa ve bu konum silinmezse doldurulur.

placeId

string

Bunun kopyalandığı konumun yer kimliği.

access

enum (Access)

Kullanıcının yinelenen konuma erişimi olup olmadığını belirtir.

Erişim

Kullanıcının çoğaltıldığı konuma erişim düzeyi. Bu, Sahiplik'in yerini alır ve onun yerine kullanılmalıdır.

Sıralamalar
ACCESS_UNSPECIFIED Belirtilmedi.
ACCESS_UNKNOWN Kullanıcının, kopyalanan konuma erişimi olup olmadığı belirlenemedi.
ALLOWED Kullanıcının kopyaladığı konuma erişimi var.
INSUFFICIENT Kullanıcının yinelenen konuma erişimi yok.

PriceList

Kullanımdan kaldırıldı: Öğe fiyatı bilgilerinin listesi. Fiyat listeleri, her biri bir veya daha fazla öğe içeren bir veya daha fazla bölüm içeren bir veya daha fazla fiyat listesi şeklinde yapılandırılır. Örneğin, gıda fiyat listeleri burger/biftek/deniz ürünleri için bölümler içeren kahvaltı/öğle yemeği/akşam yemeği menülerini temsil edebilir.

JSON gösterimi
{
  "priceListId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "sourceUrl": string,
  "sections": [
    {
      object (Section)
    }
  ]
}
Alanlar
priceListId

string

Zorunlu. Fiyat listesinin kimliği. Fiyat listesi, bölüm ve öğe kimlikleri bu Konumda kopyalanamaz.

labels[]

object (Label)

Zorunlu. Fiyat listesi için dil etiketli etiketler.

sourceUrl

string

Fiyat listesinin alındığı isteğe bağlı kaynak URL'si. Örneğin bu, menü bilgilerini doldurmak için otomatik olarak kazınan sayfanın URL'si olabilir.

sections[]

object (Section)

Zorunlu. Bu fiyat listesi için bölümler. Her fiyat listesinde en az bir bölüm olmalıdır.

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

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.

Bölüm

Fiyat listesinin bir veya daha fazla öğe içeren bölümü.

JSON gösterimi
{
  "sectionId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "sectionType": enum (SectionType),
  "items": [
    {
      object (Item)
    }
  ]
}
Alanlar
sectionId

string

Zorunlu. Bölümün kimliği. Fiyat listesi, bölüm ve öğe kimlikleri bu Konumda kopyalanamaz.

labels[]

object (Label)

Zorunlu. Bölüm için dil etiketli etiketler. Bölüm adlarının ve açıklamalarının 140 karakter veya daha kısa olmasını öneririz. En az bir etiket grubu gereklidir.

sectionType

enum (SectionType)

İsteğe bağlı. Mevcut fiyat listesi bölümünün türü. Varsayılan değer FOOD'dur.

items[]

object (Item)

Fiyat listesinin bu bölümünde yer alan öğeler.

SectionType

Bölümün türü.

Sıralamalar
SECTION_TYPE_UNSPECIFIED Belirtilmedi.
FOOD Bölümde yiyecekleri temsil eden öğeler var.
SERVICES Bölüm, hizmetleri temsil eden öğeler içeriyor.

Öğe

Tek bir liste öğesi. Fiyat listesindeki bir öğenin her varyasyonu, kendi fiyat verileri içeren kendi Öğesine sahip olmalıdır.

JSON gösterimi
{
  "itemId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "price": {
    object (Money)
  }
}
Alanlar
itemId

string

Zorunlu. Öğenin kimliği. Fiyat listesi, bölüm ve öğe kimlikleri bu Konumda kopyalanamaz.

labels[]

object (Label)

Zorunlu. Öğenin dil etiketli etiketleri. Öğe adlarının 140 karakter, açıklamaların ise 250 karakterin altında olmasını öneririz. En az bir etiket grubu gereklidir.

price

object (Money)

İsteğe bağlı. Öğenin fiyatı.

Para birimi

Para birimi türüyle birlikte para tutarı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 1 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,units=-1 ve nanos=-750.000.000 olarak temsil edilir.

Profil

Konumun profiliyle ilgili tüm bilgiler.

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

string

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
{
  "parentChain": string
}
Alanlar
parentChain

string

Bu konumun üyesi olduğu Zincirin kaynak adı. How to find Chain ID

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ü. Müşteriler, bulundukları konuma ait kategorilerde desteklenen saat türlerini öğrenmek için {#link businessCategory:BatchGet}'i aramalıdır.

periods[]

object (TimePeriod)

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.

Yöntemler

associate

Bir konumu bir yer kimliğiyle ilişkilendirir.

batchGet

Belirtilen hesaptaki tüm belirtilen konumları alır.

batchGetReviews

Belirtilen tüm konumların sayfalara ayrılmış inceleme listesini döndürür.

clearAssociation

Bir konum ile yer kimliği arasındaki ilişkilendirmeyi temizler.

create

Belirtilen hesaba ait yeni bir location oluşturur ve bunu döndürür.

delete

Konumu siler.

fetchVerificationOptions

Belirli bir dildeki bir konum için uygun olan tüm doğrulama seçeneklerini bildirir.

findMatches

Belirtilen konumla eşleşen tüm olası konumları bulur.

get

Belirtilen konumu getirir.

getFoodMenus

Belirli bir konumdaki yemek menülerini döndürür.

getGoogleUpdated

Belirtilen konumun Google tarafından güncellenmiş sürümünü alır.

getHealthProviderAttributes

Belirli bir konumun Sağlık hizmeti sağlayıcısı özelliklerini döndürür.

getServiceList

Bir konumun belirtilen hizmet listesini alın.

list

Belirtilen hesap için konumları listeler.

patch

Belirtilen konumu günceller.

reportInsights

Konuma göre bir veya daha fazla metrikle ilgili analizleri içeren bir rapor döndürür.

transfer
(deprecated)

Konumu, kullanıcıya ait bir hesaptan aynı kullanıcının yönettiği başka bir hesaba taşır.

updateFoodMenus

Belirli bir konumdaki yemek menülerini günceller.

updateHealthProviderAttributes

Belirli bir konumun Sağlık hizmeti sağlayıcısı özelliklerini günceller.

updateServiceList

Bir konumun belirtilen hizmet listesini günceller.

verify

Bir konum için doğrulama işlemini başlatır.