REST Resource: accounts.locations

Kaynak: Konum

Konum. Bu alanların ayrıntılı açıklaması için yardım merkezi makalesine veya geçerli işletme kategorilerinin listesi için kategori uç noktasına bakın.

JSON gösterimi
{
  "name": string,
  "languageCode": string,
  "storeCode": string,
  "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 bağlamında bu alan doldurulmaz.

languageCode

string

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

storeCode

string

Bu konumun belirli bir hesapta benzersiz olması gereken harici tanımlayıcı. Bu, konumu kendi kayıtlarınızla ilişkilendirmenin bir yoludur.

locationName

string

Konum adı; mağazanızda, web sitenizde ve belgelerinizde düzenli olarak kullanıldığı ve müşteriler tarafından bilinen, işletmenizin gerçek dünyadaki adını yansıtmalıdır. Gerektiğinde ek bilgiler kaynağın diğer alanlarına eklenebilir (örneğin, Address, Categories). Adınıza gereksiz bilgiler eklemeyin (örneğin, "Google Inc. - Mountain View Şirket Merkezi" yerine "Google" ifadesini tercih edin). Pazarlama kısa açıklamaları, mağaza kodları, özel karakterler, çalışma saatleri veya kapalı/açık olma durumu, telefon numaraları, web sitesi URL'leri, hizmet/ürün bilgileri, konum/adres veya yol tarifleri ya da çevre bilgileri (örneğin, "Duane Reade'deki Chase ATM").

primaryPhone

string

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

additionalPhones[]

string

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 açıklayan kesin ve doğru bir adres. Uzak yerlerde bulunan posta kutuları veya posta kutuları kabul edilmez. Şu anda adreste en fazla beş addressLines değeri belirtebilirsiniz.

primaryCategory

object (Category)

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

additionalCategories[]

object (Category)

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

websiteUrl

string

Bu işletmenin URL'si. Mümkünse tüm konumları veya markayı temsil eden genel bir web sitesi/URL yerine işletmenin ilgili konumunu temsil eden bir URL kullanın.

regularHours

object (BusinessHours)

İş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 dahildir. Bunlar, normal çalışma saatlerini geçersiz kılar.

serviceArea

object (ServiceAreaBusiness)

Hizmet bölgesi işletmeleri, hizmetlerini müşterinin bulunduğu yerde sağlar. Bu işletme bir hizmet bölgesi işletmesiyse bu alan, işletmenin hizmet verdiği bölgeleri açıklar.

locationKey

object (LocationKey)

Bu işletmeyi Google+ sayfası ve Google Haritalar Rehber gibi diğer Google mülklerine bağlayan 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; onları yalnızca siz görebilirsiniz. 255 karakterle sınırlıdır (etiket başına).

adWordsLocationExtensions

object (AdWordsLocationExtensions)

AdWords'de gösterilen ek bilgiler.

latlng

object (LatLng)

Kullanıcı tarafından sağlanan enlem ve boylam. Bir konum oluşturulurken, sağlanan adresin coğrafi kodları başarıyla kodlanırsa bu alan yoksayılır. Bu alan yalnızca kullanıcı tarafından sağlanan latlng değeri oluşturma sırasında kabul edildiyse veya latlng değeri İşletme Profili web sitesi aracılığıyla güncellendiyse alma isteklerinde döndürülür. Bu alan güncellenemez.

openInfo

object (OpenInfo)

Konumun o 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 konumun özellikleri.

metadata

object (Metadata)

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

priceLists[]
(deprecated)

object (PriceList)

Desteği sonlandırıldı: Bu konum için fiyat listesi bilgileri.

profile

object (Profile)

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

relationshipData

object (RelationshipData)

Bununla ilgili tüm konumlar ve zincir.

moreHours[]

object (MoreHours)

Bir işletmenin farklı departmanları veya belirli müşterileri için daha fazla çalışma saati.

BusinessHours

Bu konumun faaliyete açık olduğu dönemleri gösterir. TimePeriod örnekten oluşan bir koleksiyon içerir.

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

object (TimePeriod)

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

TimePeriod

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

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

enum (DayOfWeek)

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

openTime

string

24 saat ISO 8601 genişletilmiş biçimde (sa:dk) saat. Geçerli değerler 00:00-24:00 arasındadır; burada 24:00, belirtilen gün alanının sonundaki gece yarısını temsil eder.

closeDay

enum (DayOfWeek)

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

closeTime

string

24 saat ISO 8601 genişletilmiş biçimde (sa:dk) saat. Geçerli değerler 00:00-24:00 arasındadır; burada 24:00, belirtilen gün alanının sonundaki gece yarısını temsil eder.

HaftanınGünü

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

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

SpecialHours

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

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

object (SpecialHourPeriod)

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

SpecialHourPeriod

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

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

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

startDate=2015-11-23, openTime=13:00, closeTime=11:59
startDate=2015-11-23, endDate=2015-11-24, openTime=13:00,
closeTime=12:00 startDate=2015-11-23, endDate=2015-11-25,
openTime=08:00, closeTime=18:00
JSON gösterimi
{
  "startDate": {
    object (Date)
  },
  "openTime": 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 üzerindeki duvar süresi (24 saatlik ISO 8601 genişletilmiş biçiminde ifade edilir). (ss:dd) Geçerli değerler 00:00-24:00 arasındadır; burada 24:00, belirtilen gün alanının sonundaki gece yarısını temsil eder. isClosed false (yanlış) değerine ayarlanmışsa bu değer belirtilmelidir.

endDate

object (Date)

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

closeTime

string

24 saat ISO 8601 genişletilmiş biçimde ifade edilen, endDate tarihinde bir konum kapatıldığında duvar süresi. (ss:dd) Geçerli değerler 00:00-24:00 arasındadır; burada 24:00, belirtilen gün alanının sonundaki gece yarısını temsil eder. isClosed yanlış ise belirtilmelidir.

isClosed

boolean

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

ServiceAreaBusiness

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

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şinin type bilgisini gösterir.

Birleştirme alanı coverageArea. İş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 çevresinde yer alır.

places

object (Places)

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

BusinessType

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

Sıralamalar
BUSINESS_TYPE_UNSPECIFIED Yalnızca çıkış. Belirtilmedi.
CUSTOMER_LOCATION_ONLY Yalnızca bulunduğu bölgenin yakınında (işletme adresinde değil) hizmet sunuyor.
CUSTOMER_AND_BUSINESS_LOCATION İşletme adresinde ve yakınında hizmet verir.

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ımlanan 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 çift olarak ifade edilir. Aksi belirtilmedikçe bu nesne WGS84 standardına uygun olmalıdır. Değerler normalleştirilmiş aralıklar içinde olmalıdır.

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

number

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

longitude

number

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

Yerler

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

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

object (PlaceInfo)

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

PlaceInfo

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

JSON gösterimi
{
  "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 alternatif/vekil anahtar referansları.

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ğrulanmışsa ve Google Haritalar'a bağlıysa/Google Haritalar'da görünüyorsa bu alan konumun yer kimliğiyle doldurulur. Bu kimlik çeşitli Places API'lerinde kullanılabilir.

Bu konum doğrulanmamışsa, konum Google Haritalar'da görünen bir yerle ilişkilendirilmişse bu alan doldurulabilir.

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

Ek explicitNoPlaceId denetimi, ayarlanmayan bir yer kimliğinin kasıtlı olup olmadığını belirler.

explicitNoPlaceId

boolean

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

requestId

string

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

AdWordsLocationExtensions

AdWords'de gösterilen ek bilgiler.

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 açık olup olmadığını gösterir. Kapalı olacak şekilde güncellenmediği sürece tüm konumlar varsayılan olarak açıktır.

canReopen

boolean

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

openingDate

object (Date)

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

OpenForBusiness

Bir konumun durumunu gösterir.

Sıralamalar
OPEN_FOR_BUSINESS_UNSPECIFIED Belirtilmedi.
OPEN Konumun açık olduğunu gösterir.
CLOSED_PERMANENTLY Konumun kalıcı olarak kapandığını gösterir.
CLOSED_TEMPORARILY Konumun geçici olarak kapatıldığını belirtir. Bu değer yalnızca yayınlanan konumlara (ör. locationState.is_publish = true) uygulanabilir. Durum alanını bu değerle güncellerken, müşterilerin updateMask özelliğini açıkça openInfo.status olarak ayarlaması gerekir. Bu güncelleme çağrısı sırasında başka güncelleme maskesi ayarlanamaz. Bu geçici bir kısıtlama olup yakında gevşetilecektir.

LocationState

Bir Konumun durumunu yansıtan 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ğinde güncelleme olup olmadığını belirtir.

isDuplicate

boolean

Yalnızca çıkış. Konumun başka bir konumun kopyası 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ış. Konumla ilgili incelemenin beklemede olup olmadığını belirtir.

isDisabled

boolean

Yalnızca çıkış. Konumun devre dışı bırakılıp bırakılmadığı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 ServiceList'i 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.

hasPendingEdits

boolean

Yalnızca çıkış. Bu Konum'un özelliklerinden herhangi birinin 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 kullanılıp kullanılamayacağını belirtir.

Özellik

Konum özelliği. Özellikler, bir konum hakkında ek bilgi sağlar. Bir konum için ayarlanabilecek ö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 eklenip 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 beklenen türle eşleşmelidir; AttributeValueType öğesidir. 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ğeri türü REPEATED_ENUM olduğunda bu, özellik değerini içerir ve diğer değerler alanları boş olmalıdır.

urlValues[]

object (UrlAttributeValue)

Özellik değeri türü URL olduğunda bu alan, söz konusu ö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, iki değer kimliği listesinden oluşur: ayarlananlar (doğru) ve ayarlanmamış olanlar (yanlış). Eksik değerler bilinmeyen olarak kabul edilir. En az bir değer belirtilmelidir.

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

string

Ayarlanan enum değerleri.

unsetValues[]

string

Ayarlanmamış sıralama değerleri.

UrlAttributeValue

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

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

string

URL.

Meta veri

Konumla ilgili olarak 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 kopyalandığı konumla ilgili bilgiler. Yalnızca locationState.is_duplicate doğru olduğunda mevcut olur. Desteği sonlandırıldı: Yinelenenler için artık ayrıntılı bilgi desteklenmiyor.

mapsUrl

string

Haritalar'da konumun bağlantısı.

newReviewUrl

string

Müşterilerin konumla ilgili yorum bırakabileceği Google Arama sayfasına bağlantı.

Kopyala

Bu konumun kopyalandığı konumla ilgili bilgiler.

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

string

Bu öğenin çoğaltıldığı konumun kaynak adı. Yalnızca kimliği doğrulanan kullanıcının söz konusu konuma erişim hakları varsa ve bu konum silinmezse doldurulur.

placeId

string

Bu öğenin yinelendiği konumun yer kimliği.

access

enum (Access)

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

Erişim

Kullanıcının, kopyalandığı konuma erişim düzeyi. Bu, Sahiplik öğesinin yerini alır ve onun yerine kullanılmalıdır.

Sıralamalar
ACCESS_UNSPECIFIED Belirtilmedi.
ACCESS_UNKNOWN Kullanıcının kopyalandığı konuma erişimi olup olmadığı belirlenemiyor.
ALLOWED Kullanıcı, kopyalandığı konuma erişebiliyor.
INSUFFICIENT Kullanıcının kopyalandığı 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, yiyecek fiyat listeleri kahvaltı/öğle yemeği/akşam menülerini, hamburger/biftek/deniz ürünleri ile ilgili bölümleri 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 Konum içinde 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 kopyalanan 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.

Şirket

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

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

string

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

description

string

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

languageCode

string

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

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 Konum içinde kopyalanamaz.

labels[]

object (Label)

Zorunlu. Bölüm için dil etiketli etiketler. Bölüm adlarının ve açıklamalarının en fazla 140 karakter 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 YİYECEK'tir.

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 verilerine sahip 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 Konum içinde kopyalanamaz.

labels[]

object (Label)

Zorunlu. Öğe için dil etiketli etiketler. Öğe adlarının 140 karakter veya daha kısa, açıklamaların ise 250 karakter veya daha kısa olmasını öneririz. En az bir etiket grubu gereklidir.

price

object (Money)

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

Para

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

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

string

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

units

string (int64 format)

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

nanos

integer

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

Profil

Konumun profiliyle ilgili tüm bilgiler.

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

string

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

RelationshipData

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

JSON gösterimi
{
  "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. Saat türü. Müşteriler, bulundukları konumların kategorileri için desteklenen saat türlerini öğrenmek üzere {#link businessCategory:BatchGet} numaralı telefonu aramalıdır.

periods[]

object (TimePeriod)

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

Yöntemler

associate

Bir konumu bir yer kimliğiyle ilişkilendirir.

batchGet

Belirli bir hesaptaki belirtilen tüm konumları alır.

batchGetReviews

Belirtilen tüm konumlar için yorumların sayfalara ayrılmış 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

Konum silinir.

fetchVerificationOptions

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

findMatches

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

get

Belirtilen konumu alır.

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 konum için belirtilen hizmet listesini alın.

list

Belirtilen hesaba ilişkin 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)

Kullanıcının sahip olduğu bir hesaptaki konumu, aynı kullanıcının yönettiği başka bir hesaba taşır.

updateFoodMenus

Belirli bir konumun 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.