İlişkisel envanter şeması

Bu sayfada, Google'a sağladığınız Sipariş Uçtan Uca veri feed'lerinin (Gıda Kataloğu Spesifikasyonu) biçimi açıklanmaktadır. Bu bilgilerin makine tarafından okunabilir bir sürümü için JSON şemasını indirebilirsiniz.

Genel gereksinimler

Tüzel kişiler, feed'lerde her tüzel kişi için bir satırda olacak şekilde yapılandırılmalıdır (tüzel kişiler yeni satır karakterleriyle ayrılır). Bu sayfada yer alan JSON örnekleri, okunabilirlik açısından bu yapıya uymaz. Ancak feed'lerinizi gönderirken bu yapıya uymanız gerekir. Örneğin, bir menü öğesi aşağıdaki kod gibi yapılandırılmalıdır:

{"@type": "Menu","name": "Coffee Shop A","@id": "1535"}

Her "Restaurant" öğesinde iki Hizmet öğesi olabilir ("DELIVERY" ve "TAKEOUT" hizmet türleri için birer tane). Her "Hizmet" öğesinin yalnızca bir "Menü" öğesi olabilir.

Alt öğeler birden fazla restoranda yeniden kullanılabilir.

JSON değeri yönergeleri

Tür zorlama

Bir JSON değerinin türü, değer gerekli türe zorlanabileceği sürece şemada tanımlanan türden farklı olabilir. Örneğin, dize özellikleri hem dize hem de tam sayı değerlerini giriş olarak kabul edebilir. Benzer şekilde, tam sayı özellikleri, dize geçerli bir tam sayıya ayrıştırılabileceği sürece dize değerini kabul edebilir.

Tür zorlama, yinelenen mülkler için de geçerlidir. Tekrarlanan özellikler, parantez [] içine alınmadan giriş olarak değer kabul edebilir. Örneğin, OperationHours.serviceId mülkü hem "service_id" hem de ["service_id"] değerini geçerli giriş olarak kabul eder.

DateTime ve Saat Değerleri

DateTime, schema.org türünü temel alır ve aksi belirtilmedikçe ISO 8601 biçimini takip etmeli, tarih, saat ve saat dilimini içermelidir. DateTime için aşağıdaki söz dizimini kullanın:

// DateTime format:
YYYY-MM-DDTHH:MM:SS[∓HH:MM|Z]

Örneğin:

2017-05-01T06:30:00-07:00 // UTC minus 7 hours
2017-05-01T06:30:00Z  // UTC time zone. The optional "Z" suffix represents the UTC time zone.

Time, belirli bir restoranın veya hizmet konumunun yerel saatidir. schema.org türünü temel alır ve ISO 8601 biçimini de izlemelidir. Zaman için şu söz dizimi kullanılır:

// Time format:
THH:MM:SS

Örneğin:

T08:08:00 // 8:08 AM

DateTime veya Time belirtirken aşağıdakileri göz önünde bulundurun:

  • Saatten önceki "T" ön eki biçimin bir parçasıdır ve gereklidir.
  • DATETIME için saat dilimi belirtilmelidir. TIME için gerekli değildir.
  • Saat, restoranın veya hizmetin yerel saatinde belirtilmelidir.

Restoran verileri

Restoran (zorunlu)

Uygulanması gereken bir öğe. Bir restoranı tanımlar.

Aşağıdaki tabloda Restaurant türünün özellikleri listelenmektedir:

Mülk Tür Açıklama
@type Const

Zorunlu.

Değer: Restaurant

@id String

Zorunlu.

Restoranın veya teslimat sağlayıcının benzersiz tanımlayıcısıdır.

Örnek: restaurant_1

name String

Zorunlu.

Restoranın adı.

Örnek: Foo

description String

Restoranın açıklaması.

Örnek: Best seafood in town

url Url

Restoranı temsil eden URL. Toplayıcı alanına kıyasla restoran alanı tercih edilir.

Örnek: http://www.provider.com/somerestaurant

sameAs Url

Restoranın resmi web sitesi.

Örnek: http://www.provider2.com/somerestaurant

telephone String

Restoranın telefon numarası.

Örnek: +12345665898

streetAddress String

Zorunlu.

Restoranın açık adresi.

Örnek: 12345 Bar Avenu

addressLocality String

Zorunlu.

Yerleşim yeri veya şehir.

Örnek: San Francisco

addressRegion String

Zorunlu.

Bölge veya eyalet.

Örnek: CA

postalCode String

Zorunlu.

Posta kodu.

Örnek: 94124

addressCountry String

Zorunlu.

İki harfli ISO 3166-1 alfa-2 ülke kodu.

Örnek: US

latitude Number

Derece cinsinden enlem. Değerler [[-90, 90]] aralığıyla sınırlıdır. Hassasiyet, en az 5 ondalık basamak olmalıdır.

Örnek: 35.7392607

longitude Number

Boylam (derece cinsinden). Değerler [[-180, 180]] aralığıyla sınırlıdır. Hassasiyet, en az 5 ondalık basamak olmalıdır.

Örnek: -120.3895522

dealId List<String>

Restorandan geçerli Deal'ler.

imprint String

Restoran baskısı, restoranla ilgili yasal ad, yasal adres ve sicil numarası gibi ek bilgilerin yer aldığı bir bölümdür. Bu bilgiler " " kullanılarak biçimlendirilebilir.

Örnek:

Three Brothers Tacos
123 FooSt
Mountain View
CA 94041, United States
email: contact@threebrotherstacos.com

Commercial Register: 123456789

economicOperator String

Varsa restoranla ilişkili ekonomik işletmeci bilgileri. Bu bilgiler, Satıcı Bilgileri bölümünde gösterilir. Metin, " " kullanılarak biçimlendirilebilir.

Örnek:

XYZ Corp
123 Main Street
555-555-5555

dateModified ISO Zaman Damgası

Restoran öğesi feed'inin ISO zaman damgası biçiminde ancak dize türüne sahip son değiştirilme tarihi ve saati.

Örnek: 2017-01-02T00:00:00-07:00

Aşağıdaki örnekte bir Restaurant öğesi gösterilmektedir:

Örnek

{
  "@type": "Restaurant",
  "@id": "10824",
  "name": "Pronto Wood Fired Pizzeria",
  "url": "https://www.provider.com/pronto-wood-fired-pizzeria",
  "telephone": "+16503659978",
  "streetAddress": "2560 El Camino Real",
  "addressLocality": "Palo Alto",
  "addressRegion": "CA",
  "postalCode": "94061",
  "addressCountry": "US",
  "latitude": 37.472842,
  "longitude": -122.217144
}

Fırsat

Alışveriş sepetine uygulanabilecek indirim türleri.

Aşağıdaki tabloda Deal türünün özellikleri listelenmektedir:

Mülk Tür Açıklama
@type Const

Zorunlu.

Değer: Deal

@id String

Zorunlu.

Anlaşmanın benzersiz tanımlayıcısı.

Örnek: FREEDELIVERY

dealCode String

Zorunlu.

İş ortağı başına anlaşma başına benzersiz anlaşma kimliği. Bu kimlik, promosyon sisteminizde anlaşmayı benzersiz şekilde tanımlamalıdır. Google, doğrulama için CheckoutRequest öğesinin promotions.coupon alanında bu tanımlayıcıyı size gönderir.

Örnek: ADETRE23

applicableServiceType List<ServiceType>

Bu anlaşmanın geçerli olduğu hizmet. Varsayılan olarak, fırsatın herkes için geçerli olduğu varsayılır.

eligibleMaxOrders Tamsayı

Bu anlaşma yalnızca kullanıcının geçmişte bu sayıdan az veya eşit sayıda başarılı siparişi olduğunda uygundur.

availabilityId List<String>

Menü bölümünün ne zaman kullanılabileceğiyle ilgili ayrıntılar sağlayan müsaitlik durumu öğelerinin @id değerleri.

Örnek: [ "availability_1" ]

isDisabled Boole

Bu, diğer geçerlilik kontrollerini geçersiz kılar.

dealType DealType

Zorunlu.

İndirimin uygulanacağı fırsat kategorisi. Kategori, alışveriş sepeti toplamının tamamı, hizmet ücretleri veya teslimat ücretleri olabilir.

priceCurrency String

discount is defined olduğunda gereklidir.

eligibleTransactionVolumeMin is defined olduğunda gereklidir.

İndirimin para birimi (3 harfli ISO 4217 biçiminde).

Örnek: USD

eligibleTransactionVolumeMin Number

Bu promosyonun geçerli olduğu para birimi cinsinden işlem hacmi.

termsOfServiceUrl Url

Zorunlu.

Kullanıcılar tarafından okunabilen hizmet şartları dokümanları.

dateModified ISO Zaman Damgası

Anlaşma öğesi feed'inin son değiştirildiği tarih ve saat (ISO zaman damgası biçiminde ancak dize türüne sahip).

Örnek: 2017-01-02T00:00:00-07:00

Aşağıdaki mülk gruplarından tam olarak biri gereklidir.
discount 1. Grup Number

İndirimin sayı olarak değeri.

discountPercentage 2. Grup Number

İndirimin değeri, orijinal fiyatın yüzdesi olarak.

Aşağıdaki örnekte bir Deal öğesi gösterilmektedir:

1. Örnek

{
  "@type": "Deal",
  "@id": "ONEDOLLARFEE",
  "dealCode": "THREEDOLLARFEE",
  "dealType": "CART_OFF",
  "availabilityId": [
    "availability_may2020"
  ],
  "termsOfServiceUrl": "http://www.provider.com/onedollardeal",
  "applicableServiceType": [
    "TAKEOUT"
  ],
  "discount": 3,
  "priceCurrency": "USD"
}

2. Örnek

{
  "@type": "Deal",
  "@id": "10PERCOFF",
  "dealCode": "10PERCOFF",
  "dealType": "CART_OFF",
  "availabilityId": [
    "availability_weekdays_evening"
  ],
  "termsOfServiceUrl": "http://www.provider.com/deal",
  "discountPercentage": 10,
  "priceCurrency": "USD"
}

3. Örnek

{
  "@type": "Deal",
  "@id": "FREEDELIVERY",
  "dealCode": "FREEDELIVERY",
  "dealType": "DELIVERY_OFF",
  "availabilityId": [
    "availability_may"
  ],
  "applicableServiceType": [
    "DELIVERY"
  ],
  "termsOfServiceUrl": "http://www.provider.com/free_delivery_deal",
  "discountPercentage": 100,
  "eligibleTransactionVolumeMin": 25,
  "priceCurrency": "USD"
}

Hizmet verileri

Hizmet (zorunlu)

Bir restoranın yemek siparişi hizmetiyle ilgili ayrıntıları açıklar. Service, uygulanması gereken bir öğedir.

Aşağıdaki tabloda Service türünün özellikleri listelenmektedir:

Mülk Tür Açıklama
@type Const

Zorunlu.

Değer: Service

@id String

Zorunlu.

Siparişin karşılanması hizmetini tanımlayan tanımlayıcı.

Örnek: service_1

serviceType ServiceType

Zorunlu.

Sunulan hizmetin türü. Olası değerler: "DELIVERY" veya "TAKEOUT".

Örnek: DELIVERY

restaurantId String

Zorunlu.

Bu Hizmet öğesiyle ilişkili Restoran öğesinin @id değeri.

Örnek: restaurant_1

menuId String

Zorunlu.

Bu Hizmet öğesiyle ilişkili Menü öğesinin @id değeri.

Örnek: menu_1

dateModified ISO Zaman Damgası

Hizmet öğesi feed'inin ISO zaman damgası biçimindeki son değiştirilme tarihi ve saati.

Örnek: 2017-01-02T00:00:00-07:00

isDisabled Boole

Öğenin devre dışı olup olmadığını belirtir. Bu türü yalnızca beklenmedik bir olay nedeniyle öğeyi devre dışı bırakmanız gerektiğinde ve hizmetin ne zaman yeniden kurulacağını bilmediğinizde kullanın (ör. tatillerde kullanmayın).

Örnek: true

servingConfig ServingConfig

Çeşitli özellikleri kontrol etmek için kullanılan hizmetin yayınlama yapılandırması (ör. promosyon widget'ını devre dışı bırakma vb.).

actionLinkUrl String

Yemek siparişi için uçtan uca deneyimden yönlendirmeye geçiş sırasında kullanılacak bir teslimat/paket servisi URL'sini içerir.

Aşağıdaki örnekte bir Service öğesi gösterilmektedir:

1. Örnek

{
  "@type": "Service",
  "@id": "10824/takeout",
  "serviceType": "TAKEOUT",
  "menuId": "10824",
  "restaurantId": "10824",
  "actionLinkUrl": "https://www.rwgpartnerwebsite.com/foodorderpickup/merchant_foepa_3"
}

2. Örnek

{
  "@type": "Service",
  "@id": "10824/delivery",
  "serviceType": "DELIVERY",
  "menuId": "10824",
  "restaurantId": "10824",
  "actionLinkUrl": "https://www.rwgpartnerwebsite.com/foodorderdelivery/merchant_foepa_3"
}

ServiceArea

Yiyeceklerin teslim edilebileceği coğrafi bölgeyi tanımlar. İlişkili Service öğesinde serviceType "DELIVERY" olarak ayarlanmışsa bu öğenin uygulanması gerekir.

Aşağıdaki tabloda ServiceArea türünün özellikleri listelenmektedir:

Mülk Tür Açıklama
@type Const

Zorunlu.

Değer: ServiceArea

@id String

Zorunlu.

Hizmet alanının benzersiz tanımlayıcısı.

Örnek: service_area_1

serviceId List<String>

Zorunlu.

Bu ServiceArea varlığıyla ilişkili Service öğesinin @id değeri.

Örnek: [ "service_1" ]

dateModified ISO Zaman Damgası

ServiceArea öğe feed'inin ISO zaman damgası biçiminde ancak dize türüne sahip son değiştirilme tarihi ve saati.

Örnek: 2017-01-02T00:00:00-07:00

exclude Boole

Bu hizmet bölgesini toplam teslimat bölgesinden hariç tutun. Örneğin, bir posta kodu daha büyük bir poligon alanından hariç tutulabilir.

Aşağıdaki mülk gruplarından tam olarak biri gereklidir.
polygon 1. Grup List<String>

Üç veya daha fazla boşlukla ayrılmış nokta dizisi olarak ifade edilen bir poligon ya da çoklu poligon. İlk ve son noktaların aynı olması önerilir ancak zorunlu değildir. Bir poligon veya çoklu poligondaki her nokta, bir enlem noktası ve ardından bir boylam noktasıyla tanımlanır. Ayrıca, noktaları saat yönünün tersine belirtmeniz gerekir.

Örnek: [ "37.806000 -122.425592 37.775849 -122.419043 37.795547 -122.394046 37.808747" ]

geoMidpointLatitude 2. Grup Number

ÇEMBER alanının merkezindeki enlem koordinatını gösterir.

Örnek: 37.806000

geoMidpointLongitude 2. Grup Number

ÇEMBER alanının ortasındaki boylam koordinatını gösterir.

Örnek: -122.425592

geoRadius 2. Grup Tamsayı

ÇEMBER alanının yaklaşık yarıçapını (metre cinsinden) gösterir.

Örnek: 10000

postalCode 3. Grup String

Posta kodunu belirtir.

Örnek: 91234

addressCountry 3. Grup String

İki harfli ISO 3166-1 alfa-2 ülke kodunu belirtir

Örnek: US

Aşağıdaki örnekte bir ServiceArea öğesi gösterilmektedir:

Örnek

{
  "@type": "ServiceArea",
  "@id": "28427",
  "serviceId": [
    "10824/delivery"
  ],
  "polygon": [
    "37.4818562 -122.25801303 37.48247836 -122.25801303 37.48434484 -122.25621319 37.48621133 -122.25424681 37.49181077 -122.24704744 37.49305509 -122.24541414 37.49429942 -122.2436143 37.49803238 -122.23821477 37.49803238 -122.21285044 37.49367726 -122.15885517 37.49056645 -122.15722187 37.48621133 -122.15542202 37.48558917 -122.15525548 37.4818562 -122.15525548 37.43191387 -122.17865343 37.43191387 -122.23444854"
  ]
}

ÇalışmaSaatleri (zorunlu)

Kullanıcıların akışa erişip en kısa sürede veya gelecekte sipariş verebileceği sipariş aralığını tanımlar. OperationHours özelliğinin uygulanması zorunludur ve varsayılan olarak tüm günlerde tüm saatlerde çalışmayı temsil eder.

OperationHours opens ve closes özellikleri, kullanıcıların sipariş verebildiği online sistemin açılış ve kapanış saatlerini belirtir. Bu online sistem saatlerinde, kullanıcıların siparişlerinin ne zaman karşılanabileceğini belirtmek için ServiceHours simgesini kullanarak açılış ve kapanış saatlerini belirtin.

Saatler, hizmetin yerel saatinde belirtilmelidir. opens değerine saat dilimi eklemeyin. Bir saat dilimi belirtilirse Google bu bilgiyi yoksayar. Daha fazla bilgi için Tarih ve saat biçimleri bölümüne bakın.

Aşağıdaki tabloda OperationHours türünün özellikleri listelenmektedir:

Mülk Tür Açıklama
@type Const

Zorunlu.

Değer: OperationHours

@id String

Zorunlu.

Kullanıcıların akışa erişip en kısa sürede/gelecekte sipariş verebileceği sipariş aralığını tanımlayan öğenin benzersiz tanımlayıcısıdır.

Örnek: operation_hour_1

serviceId List<String>

Zorunlu.

Bu OperationHours varlığıyla ilişkili Service varlığı için @id değeri.

Örnek: [ "service_1" ]

opens ISO zamanı (yerel)

Kullanıcıların sipariş verebileceği zamanı ISO biçiminde belirtir.

Örnek: T00:00

closes ISO zamanı (yerel)

Kullanıcıların sipariş veremedikleri zamanı ISO biçiminde belirtir.

Örnek: T16:00

dayOfWeek List<DayOfWeek>

Bu çalışma saatlerinin geçerli olduğu haftanın günlerinin listesi. Kabul edilen değerler: "MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY", "SATURDAY" ve "SUNDAY".

Örnek: [ "MONDAY", "TUESDAY" ]

validFrom ISO Zaman Damgası

isSpecialHour = true olduğunda gereklidir.

Kullanıcıların akışa erişip en kısa sürede/gelecekte sipariş verebileceği sipariş aralığının başlangıç zamanını belirten ISO zaman damgası.

Örnek: 2017-01-01T00:00:00-07:00

validThrough ISO Zaman Damgası

isSpecialHour = true olduğunda gereklidir.

Kullanıcıların akışa erişemeyeceği ve en kısa sürede/gelecekte sipariş veremeyeceği sipariş aralığının bitiş zamanını belirten ISO zaman damgası.

Örnek: 2017-01-02T00:00:00-07:00

isSpecialHour Boole

OperationHours özelliğinin özel çalışma saatleri için olup olmadığını belirten bir boole değeri. Kabul edilen değerler "false" ve "true"dur.

Örnek: False

dateModified ISO Zaman Damgası

OperationHours öğe feed'inin ISO zaman damgası biçiminde ancak dize türüne sahip son değiştirilme tarihi ve saati.

Örnek: 2017-01-02T00:00:00-07:00

Aşağıdaki örnekte bir OperationHours öğesi gösterilmektedir:

1. Örnek

{
  "@type": "OperationHours",
  "@id": "10824/deliveryOh",
  "serviceId": [
    "10824/delivery"
  ],
  "isSpecialHour": false
}

2. Örnek

{
  "@type": "OperationHours",
  "@id": "10824/takeoutOh",
  "serviceId": [
    "10824/takeout"
  ],
  "isSpecialHour": false
}

Çalışma saatleri (zorunlu)

Kullanıcıların teslimat aralıklarını (en kısa sürede veya gelecekteki aralıklar) seçebileceği teslimat aralığını açıklar. ServiceHours'ün uygulanması zorunludur.

OperationHours opens ve closes özellikleri, kullanıcıların sipariş verebildiği online sistemin açılış ve kapanış saatlerini belirtir. Bu online sistem saatlerinde, kullanıcıların siparişlerinin ne zaman karşılanabileceğini belirtmek için ServiceHours simgesini kullanarak açılış ve kapanış saatlerini belirtin.

Saatler, hizmetin yerel saatinde belirtilmelidir. opens değerine saat dilimi eklemeyin. Bir saat dilimi belirtilirse Google bu bilgiyi yoksayar. Daha fazla bilgi için Tarih ve saat biçimleri bölümüne bakın.

Aşağıdaki tabloda ServiceHours türünün özellikleri listelenmektedir:

Mülk Tür Açıklama
@type Const

Zorunlu.

Değer: ServiceHours

@id String

Zorunlu.

Kullanıcıların teslimat aralıklarını (ör. en kısa sürede veya gelecekteki aralıklar) seçebileceği teslimat aralığını tanımlayan öğenin benzersiz tanımlayıcısıdır.

Örnek: service_hour_1

orderType OrderType

Zorunlu.

Çalışma saatlerinin en kısa sürede teslimat veya gelişmiş siparişler için geçerli olup olmadığını belirten bir dize. Kabul edilen değerler "ASAP" ve "ADVANCE".

Örnek: ASAP

serviceId List<String>

Zorunlu.

Bu ServiceHours varlığıyla ilişkili Service varlığının @id değeri.

Örnek: [ "service_1" ]

operationHoursId List<String>

isSpecialHour = false olduğunda gereklidir.

Bu ServiceHours varlığıyla ilişkili OperationHours varlığı için @id değeri.

Örnek: [ "operation_hour_1" ]

opens ISO zamanı (yerel)

Kullanıcıların siparişlerinin yerine getirilebileceği zamanı ISO biçiminde belirtir.

Örnek: T00:00

closes ISO zamanı (yerel)

Kullanıcıların siparişlerinin karşılanamayacağı zamanı ISO biçiminde belirtir.

Örnek: T16:00

dayOfWeek List<DayOfWeek>

Bu çalışma saatlerinin geçerli olduğu haftanın günlerinin listesi.

Örnek: [ "MONDAY", "TUESDAY" ]

validFrom ISO Zaman Damgası

isSpecialHour = true olduğunda gereklidir.

Kullanıcıların akışa erişip en kısa sürede/gelecekte sipariş verebileceği sipariş aralığının başlangıç zamanını belirten ISO zaman damgası.

Örnek: 2017-01-01T00:00:00-07:00

validThrough ISO Zaman Damgası

isSpecialHour = true olduğunda gereklidir.

Kullanıcıların akışa erişemeyeceği ve en kısa sürede/gelecekte sipariş veremeyeceği sipariş aralığının bitiş zamanını belirten ISO zaman damgası.

Örnek: 2017-01-02T00:00:00-07:00

isSpecialHour Boole

OperationHours özelliğinin özel çalışma saatleri için olup olmadığını belirten bir boole değeri. Kabul edilen değerler "false" ve "true"dur.

Örnek: False

leadTimeMin Tamsayı

En kısa sürede sipariş verildikten sonra minimum tahmini teslimat/teslimat süresi (dakika cinsinden). Bu özelliği ayarlamanızı önemle tavsiye ederiz.

Örnek: 60

leadTimeMax Tamsayı

En kısa sürede sipariş verildikten sonra tahmini maksimum teslimat/teslimat süresi (dakika cinsinden). Bu özelliği ayarlamanızı önemle tavsiye ederiz.

Örnek: 70

advanceBookingRequirementMin Tamsayı

orderType = "ADVANCE" olduğunda gereklidir.

Ön siparişin, sipariş tarihinden itibaren minimum kaç dakika içinde yerine getirilebileceği. Örneğin, bir ön siparişin yerine getirilmesinin en az 60 dakika sürmesi gerekiyorsa advanceBookingRequirementMin değeri 60 olur.

Örnek: 15

advanceBookingRequirementMax Tamsayı

orderType = "ADVANCE" olduğunda gereklidir.

Ön siparişin, sipariş verme zamanından itibaren maksimum kaç dakika içinde karşılanması gerektiği. Örneğin, bir ön siparişin 2 günden uzun bir süre sonra yerine getirilmesi kısıtlanmışsa advanceBookingRequirementMax değeri 2880'dir.

Örnek: 10080

advanceBookingSlotInterval String

orderType = "ADVANCE" olduğunda gereklidir.

Art arda gelen iki ön rezervasyon aralığı zamanı arasındaki aralık. Örneğin: Açılış ve kapanış saatleri 08:00 ile 20:00 arasındaysa ve advanceBookingSlotInterval 15 dakikaysa kullanıcı, 08:00, 08:15, 08:30, 08:45 ve 20:00'e kadar olan saatler arasından tercih yapabilir. Süre, ISO Dönem süresi olarak belirtilmelidir. Örneğin: "PT15M", 15 dakikalık aralıklar anlamına gelir.

Örnek: PT15M

dateModified ISO Zaman Damgası

ServiceHours öğe feed'inin ISO zaman damgası biçiminde ancak dize türüne sahip son değiştirilme tarihi ve saati.

Örnek: 2017-01-02T00:00:00-07:00

Aşağıdaki örnekte bir ServiceHours öğesi gösterilmektedir:

1. Örnek

{
  "@type": "ServiceHours",
  "@id": "613741/delivery",
  "orderType": "ASAP",
  "serviceId": [
    "10824/delivery"
  ],
  "opens": "T00:00",
  "closes": "T00:00",
  "isSpecialHour": true,
  "validFrom": "2017-12-25T00:00:00-07:00",
  "validThrough": "2017-12-25T23:59:00-07:00"
}

2. Örnek

{
  "@type": "ServiceHours",
  "@id": "10824/takeoutSh_0",
  "orderType": "ASAP",
  "serviceId": [
    "10824/takeout"
  ],
  "operationHoursId": [
    "10824/takeoutOh"
  ],
  "opens": "11:00",
  "closes": "21:00",
  "dayOfWeek": [
    "MONDAY",
    "TUESDAY",
    "WEDNESDAY",
    "THURSDAY"
  ],
  "isSpecialHour": false
}

Ücret

Bir ücreti tanımlar. İlişkili Service öğesinde serviceType "DELIVERY" olarak ayarlanmışsa feeType "DELIVERY" olarak ayarlanmış bir Fee gereklidir.

Aşağıdaki tabloda Fee türünün özellikleri listelenmektedir:

Mülk Tür Açıklama
@type Const

Zorunlu.

Değer: Fee

@id String

Zorunlu.

Ücreti açıklayan öğenin benzersiz tanımlayıcısı.

Örnek: service_fee_1

serviceId List<String>

Zorunlu.

Bu Ücret öğesiyle ilişkili Hizmet öğesinin @id değeri.

Örnek: [ "service_1" ]

feeType FeeType

Zorunlu.

Ücretin teslimat veya hizmet siparişleri için geçerli olup olmadığını belirten bir dize. Kabul edilen değerler: "DELIVERY" ve "SERVICE".

Örnek: DELIVERY

priceCurrency String

Zorunlu.

3 harfli ISO 4217 para birimi kodu.

Örnek: USD

basePrice Number

percentageOfCart veya pricePerMeter kullanıldığında geçerli olan ücretin taban fiyatı.

Örnek: 2.0

minPrice Number

Minimum ücret, percentageOfCart veya pricePerMeter kullanıldığında ücret değerini sınırlar.

Örnek: 2.0

maxPrice Number

Maks. ücret, percentageOfCart veya pricePerMeter kullanıldığında ücret değerini sınırlar.

Örnek: 10.0

eligibleRegion List<String>

Ücretin geçerli olduğu coğrafi-politik bölgeler için ServiceArea'nın @id değeri. Bu özelliği yalnızca teslimat ücretleri bölgeye göre değişiyorsa kullanın.

Örnek: [ "service_area_1" ]

eligibleTransactionVolumeMin Number

Bu ücret spesifikasyonunun geçerli olduğu, para birimi cinsinden minimum işlem hacmi.

Örnek: 50

eligibleTransactionVolumeMax Number

Bu ücret spesifikasyonunun geçerli olduğu, para birimi cinsinden maksimum işlem hacmi. Örneğin, belirli bir sipariş hacminin üzerindeyse ücret geçerli olmaz.

Örnek: 10

validFrom ISO Zaman Damgası

Ücretin geçerlilik süresinin başlangıç zamanını gösteren ISO zaman damgası.

Örnek: 2017-01-01T00:00:00-07:00

validThrough ISO Zaman Damgası

Ücretin geçerliliğini yitirdiği bitiş zamanını gösteren ISO zaman damgası.

Örnek: 2017-01-02T00:00:00-07:00

dateModified ISO Zaman Damgası

Ücret öğesi feed'inin, ISO zaman damgası biçiminde ancak dize türüne sahip son değiştirilme tarihi ve saati.

Örnek: 2017-01-02T00:00:00-07:00

priority Number

Sıfırdan büyük pozitif bir değer. Kullanıcının alışveriş sepeti için birden fazla ücret geçerli olduğunda, en yüksek öncelikli ücret daha düşük öncelikli ücretlere göre öncelikli olur. Bu alan sağlanırsa öncelik, hesaplanan önceliğe göre her zaman öncelikli olur.

Örnek: 3

Aşağıdaki mülk gruplarından tam olarak biri gereklidir.
price 1. Grup Number

Ücretin fiyatı. Fiyat sabit değilse fiyat yerine minPrice ve maxPrice sağlanabilir.

Örnek: 1.5

percentageOfCart 2. Grup Number

Alışveriş sepeti değerinin yüzdesi olarak ücret. Kabul edilen değerler, 0 ile 100 (dahil) arasındaki kayan nokta değerleridir.

Örnek: 9.00

pricePerMeter 3. Grup Number

Kullanıcıya olan mesafenin radyal uzunluğu için metre başına ücret. Ör. Kullanıcıya olan mesafe 5 km ve ücret 0,001 ABD doları ise kullanıcı ücreti 5 ABD doları olur.

Örnek: 0.001

Aşağıdaki örnekte bir Fee öğesi gösterilmektedir:

1. Örnek

{
  "@type": "Fee",
  "@id": "28427",
  "serviceId": [
    "10824/delivery"
  ],
  "feeType": "DELIVERY",
  "priceCurrency": "USD",
  "eligibleRegion": [
    "28427"
  ],
  "eligibleTransactionVolumeMin": 20,
  "price": 5
}

2. Örnek

{
  "@type": "Fee",
  "@id": "28427",
  "serviceId": [
    "10824/delivery"
  ],
  "feeType": "DELIVERY",
  "priceCurrency": "USD",
  "eligibleRegion": [
    "28427"
  ],
  "eligibleTransactionVolumeMin": 20,
  "pricePerMeter": 0.0005,
  "basePrice": 4
}

3. Örnek

{
  "@type": "Fee",
  "@id": "28427",
  "serviceId": [
    "10824/delivery"
  ],
  "feeType": "DELIVERY",
  "priceCurrency": "USD",
  "eligibleRegion": [
    "28427"
  ],
  "eligibleTransactionVolumeMin": 20,
  "pricePerMeter": 0.0005,
  "basePrice": 4,
  "minPrice": 5,
  "maxPrice": 50
}

4. Örnek

{
  "@type": "Fee",
  "@id": "28427",
  "serviceId": [
    "10824/delivery"
  ],
  "feeType": "DELIVERY",
  "priceCurrency": "USD",
  "eligibleRegion": [
    "28427"
  ],
  "eligibleTransactionVolumeMin": 20,
  "percentageOfCart": 5,
  "basePrice": 4
}

Örnek 5

{
  "@type": "Fee",
  "@id": "28427",
  "serviceId": [
    "10824/delivery"
  ],
  "feeType": "DELIVERY",
  "priceCurrency": "USD",
  "eligibleRegion": [
    "28427"
  ],
  "eligibleTransactionVolumeMin": 20,
  "percentageOfCart": 5,
  "basePrice": 4,
  "minPrice": 5,
  "maxPrice": 50
}

Uygulanması gereken bir öğe. Bir menüyü tanımlar.

Aşağıdaki tabloda Menu türünün özellikleri listelenmektedir:

Mülk Tür Açıklama
@type Const

Zorunlu.

Değer: Menu

@id String

Zorunlu.

Menünün benzersiz tanımlayıcısı.

Örnek: menu_1

name String

Kullanıcı menüye göz atarken menüyü tanımlayabilecek metin.

Örnek: Foo

disclaimer String

Menü için sorumluluk reddi beyanı. Örneğin, besin değeri bilgilerinin ve alerjenlerin açıklanması.

Örnek: Items may contain peanuts.

disclaimerUrl Url

Sorumluluk reddi beyanı hakkında daha fazla bilgi sağlayan bir sayfaya yönlendiren URL.

dateModified ISO Zaman Damgası

Menü öğesi feed'inin ISO zaman damgası biçiminde ancak dize türüne sahip son değiştirilme tarihi ve saati.

Örnek: 2017-01-02T00:00:00-07:00

Aşağıdaki örnekte bir Menu öğesi gösterilmektedir:

{
  "@type": "Menu",
  "@id": "10824"
}

Uygulanacak isteğe bağlı bir öğe. Menüdeki belirli bir bölümü açıklar.

Aşağıdaki tabloda MenuSection türünün özellikleri listelenmektedir:

Mülk Tür Açıklama
@type Const

Zorunlu.

Değer: MenuSection

@id String

Zorunlu.

Menü bölümünün benzersiz tanımlayıcısı.

Örnek: menu_section_1

menuId List<ReverseReference>

Bu MenuSection öğesiyle ilişkili menü öğesinin @id değeri.

Örnek: [ { "@id": "menu_id", "displayOrder": 4 } ]

menuSectionId List<String>

Bu MenuSection öğesine karşılık gelen alt MenuSection öğelerinin @id değerlerinin listesi.

Önemli: Yalnızca menuSectionId veya parentMenuSectionId(in child) referanslarından birini kullanmanız gerekir.

Örnek: [ "child_menu_section_1", "child_menu_section_2" ]

parentMenuSectionId List<ReverseReference>

Bu MenuSection öğesiyle ilişkili üst MenuSection öğesinin @id değeri.

Önemli: Yalnızca parentMenuSectionId veya menuSectionId(in parent) referanslarından birini kullanmanız gerekir.

Örnek: [ { "@id": "parent_menu_section_id", "displayOrder": 4 } ]

name String

Zorunlu.

Kullanıcı menüye göz atarken MenuSection öğesini tanımlayabilecek metin.

Örnek: Foo

description String

Menü bölümünün açıklaması.

Örnek: Example menu section description that helps users.

image Url

Menü bölümünün resminin URL'si.

Örnek: https://provider.com/someimage

menuItemId List<String>

Bu MenuSection öğesine karşılık gelen MenuItem öğelerinin @id değerlerinin listesi.

Önemli: Yalnızca menuItemId veya MenuItem.parentMenuSectionId referanslarından birini kullanmanız gerekir.

Örnek: [ "menu_item1", "menu_item2" ]

parentMenuItemId List<ReverseReference>

Bu MenuSection öğesine karşılık gelen üst MenuItem öğelerinin @id değerlerinin listesi.

Önemli: Yalnızca parentMenuItemId veya MenuItem.menuAddOnId referanslarından birini kullanmanız gerekir.

Örnek: [ { "@id": "parent_menu_item_id", "displayOrder": 4 } ]

parentMenuItemOptionId List<ReverseReference>

Bu MenuSection öğesine karşılık gelen üst MenuItemOption öğelerinin @id değerlerinin listesi.

Önemli: Yalnızca parentMenuItemOptionId veya MenuItemOption.menuAddOnId referanslarından birini kullanmanız gerekir.

Örnek: [ { "@id": "parent_menu_item_option_id", "displayOrder": 4 } ]

eligibleQuantityMax Tamsayı

Eklenti bölümünde seçilebilecek maksimum eklenti sayısı.

Örnek: 5

eligibleQuantityMin Tamsayı

Eklenti bölümünde seçilmesi gereken minimum eklenti sayısı.

Örnek: 1

defaultItemId List<String>

MenuSection eklentisindeki kullanıcılar için varsayılan olarak önceden seçilecek @id referanslı MenuItem öğelerinin listesi. Kullanıcılar nihai seçimleri değiştirebilir. defaultItemId belirtilmezse önceden seçili bir MenuItem olmaz.

Örnek: [ "item1", "item2" ]

availabilityId List<String>

Menü bölümünün ne zaman kullanılabileceğiyle ilgili ayrıntılar sağlayan müsaitlik durumu öğelerinin @id değerleri.

Örnek: [ "menu_availability_1" ]

numberOfFreeAddOns Tamsayı

Kullanıcının ücretsiz olarak seçebileceği eklenti sayısını belirtir. Yalnızca eklenti menü bölümleri için geçerlidir.

Örnek: 3

dateModified ISO Zaman Damgası

MenuSection öğe feed'inin ISO zaman damgası biçiminde ancak dize türüne sahip son değiştirilme tarihi ve saati.

Örnek: 2017-01-02T00:00:00-07:00

applicableServiceType List<ServiceType>

Bu MenuSection'nin geçerli olduğu hizmet. Varsayılan olarak, herkes için geçerli bir MenuSection varsayılır.

offeredById List<String>

Bu MenuSection özelliğinin kullanılabildiği Restaurant öğelerinin @id değerleri. Varsayılan olarak, MenuSection'nin tüm konumlarda kullanılabildiği varsayılır.

Örnek: [ "restaurant_id_1", "restaurant_id_55" ]

Aşağıdaki örnekte bir MenuSection öğesi gösterilmektedir:

{
  "@type": "MenuSection",
  "@id": "853705",
  "menuId": [
    {
      "@id": "10824",
      "displayOrder": 853705
    }
  ],
  "menuSectionId": [
    12345,
    43645
  ],
  "name": "Pasta",
  "applicableServiceType": [
    "TAKEOUT"
  ],
  "offeredById": [
    "italian_restaurant_location_1"
  ]
}
{
  "@type": "MenuSection",
  "@id": "427484",
  "menuId": [
    {
      "@id": "4287",
      "displayOrder": 964376
    }
  ],
  "menuItemId": [
    46784,
    42728
  ],
  "name": "Burger",
  "applicableServiceType": [
    "TAKEOUT",
    "DELIVERY"
  ]
}
{
  "@type": "MenuSection",
  "@id": "3138486",
  "name": "Choose a side:",
  "parentMenuItemId": [
    {
      "@id": "6680295",
      "displayOrder": 3138486
    }
  ],
  "eligibleQuantityMax": "5",
  "numberOfFreeAddOns": "2"
}
{
  "@type": "MenuSection",
  "@id": "3138482",
  "name": "Additional Pizza Toppings",
  "parentMenuItemId": [
    {
      "@id": "6680246",
      "displayOrder": 3138482
    }
  ],
  "eligibleQuantityMax": "3"
}

Kullanılabilirlik

Uygulanacak isteğe bağlı bir öğe. Bir MenuSection öğesinin yayınlandığı dönemi tanımlar.

Aşağıdaki tabloda Availability türünün özellikleri listelenmektedir:

Mülk Tür Açıklama
@type Const

Zorunlu.

Değer: Availability

@id String

Zorunlu.

Menü bölümünün kullanılabilirliğini açıklayan öğenin benzersiz tanımlayıcısı.

Örnek: menu_section_avail_1

availabilityStarts ISO zamanı (yerel)

Menü bölümünün kullanılabilirliğinin geçerli olduğu başlangıç zamanını gösteren ISO zaman damgası.

Örnek: T00:00

availabilityEnds ISO zamanı (yerel)

Menü bölümünün kullanılabilirliğinin geçersiz olduğu bitiş zamanını gösteren ISO zaman damgası.

Örnek: T16:00

availableDay List<DayOfWeek>

Menü bölümünün müsaitlik durumunun geçerli olduğu haftanın günlerinin listesi.

Örnek: [ "MONDAY", "TUESDAY" ]

validFrom ISO Zaman Damgası

Menü bölümünün kullanılabilirliğinin geçerli olduğu başlangıç zamanını gösteren ISO zaman damgası.

Örnek: 2017-01-01T00:00:00-07:00

validThrough ISO Zaman Damgası

Menü bölümünün kullanılabilirliğinin geçersiz olduğu bitiş zamanını gösteren ISO zaman damgası.

Örnek: 2017-01-02T00:00:00-07:00

dateModified ISO Zaman Damgası

ISO zaman damgası biçiminde ancak dize türüne sahip müsaitlik durumu öğesi feed'inin en son değiştirildiği tarih ve saat.

Örnek: 2017-01-02T00:00:00-07:00

Aşağıdaki örnekte bir Availability öğesi gösterilmektedir:

Örnek

{
  "@type": "Availability",
  "@id": "85343705",
  "availabilityStarts": "06:00",
  "availabilityEnds": "22:30",
  "availableDay": [
    "SATURDAY",
    "SUNDAY"
  ]
}

Uygulanması gereken bir öğe. Menu öğesindeki bir öğeyi tanımlar.

Aşağıdaki tabloda MenuItem türünün özellikleri listelenmektedir:

Mülk Tür Açıklama
@type Const

Zorunlu.

Değer: MenuItem

@id String

Zorunlu.

Menü öğesinin benzersiz tanımlayıcısıdır.

Örnek: menu_item_1

name String

Zorunlu.

Kullanıcı menüye göz atarken MenuItem öğesini tanımlayabilecek metin.

Örnek: Foo

description String

Menü öğesinin açıklaması.

Örnek: Foo

image Url

Menü öğesinin resminin URL'si.

Örnek: http://someprovider.com/someimage

parentMenuSectionId List<ReverseReference>

Bu MenuItem öğesine karşılık gelen üst MenuSection öğelerinin @id değerlerinin listesi.

Önemli: Yalnızca parentMenuSectionId veya MenuSection.menuItemId referanslarından birini kullanmanız gerekir.

Örnek: { "@id": "menu_section_parent_id", "displayOrder": 4 }

menuAddOnId List<String>

Bu MenuItem öğesine karşılık gelen eklenti bölümündeki MenuSection öğelerinin @id değerlerinin listesi.

Önemli: Yalnızca menuAddOnId veya MenuSection.parentMenuItemId referanslarından birini kullanmanız gerekir.

Örnek: menu_addon_1

nutrition NutritionInformation

Yemeğin besin bilgileri (özellikle kaloriler).

Örnek: { "calories": "120-150 Cal" }

allergen List<Allergen>

Bu MenuItem öğesinin alerjenleri.

Örnek: [ { "allergenType": "PEANUTS", "levelOfContainment": "MAY_CONTAIN" } ]

additive List<Additive>

Bu MenuItem öğesinin katkı maddeleri.

Örnek: [ { "additiveName": "Sodium nitrite", "levelOfContainment": "CONTAINS" } ]

suitableDiet List<RestrictedDiet>

Yemek, açıklanan diyet kısıtlamasına uygundur.

Örnek: [ "DIABETIC", "GLUTEN_FREE" ]

depositInfo DepositInfo

Bu MenuItem öğesinin ambalaj ve geri dönüşüm bilgileri.

Örnek: { "depositCode": "RECYCLABLE", "depositValue": "0.05", "depositValueCurrency": "USD" }

numberOfServings Tamsayı

Belirli bir menü öğesinde bulunan porsiyon sayısı.

Örnek: 2

dateModified ISO Zaman Damgası

MenuItem öğe feed'inin ISO zaman damgası biçiminde ancak dize türüne sahip son değiştirilme tarihi ve saati.

Örnek: 2017-01-02T00:00:00-07:00

Aşağıdaki örnekte bir MenuItem öğesi gösterilmektedir:

{
  "@type": "MenuItem",
  "@id": "18931508",
  "name": "Sauteed Baby Spinach",
  "parentMenuSectionId": [
    {
      "@id": "3138479",
      "displayOrder": 18931508
    }
  ]
}
{
  "@type": "MenuItem",
  "@id": "18931508",
  "name": "Hamburger",
  "parentMenuSectionId": [
    {
      "@id": "4645747",
      "displayOrder": 12345
    }
  ],
  "nutrition": {
    "calories": "400 cal"
  },
  "allergen": [
    {
      "allergenType": "GLUTEN",
      "levelOfContainment": "CONTAINS"
    }
  ],
  "additive": [
    {
      "additiveName": "Sodium nitrite",
      "levelOfContainment": "CONTAINS"
    }
  ],
  "suitableDiet": [
    "DIABETIC",
    "LOW_FAT"
  ]
}

Uygulanacak isteğe bağlı bir öğe. Kullanıcının yemek/kombinasyon seçerken yapması gereken seçimleri açıklar. Kullanıcı bir seçenek belirlemelidir.Aksi takdirde sipariş geçersiz kabul edilir (ör. kullanıcı pizza için küçük, orta veya büyük seçmelidir).

Aşağıdaki tabloda MenuItemOption türünün özellikleri listelenmektedir:

Mülk Tür Açıklama
@type Const

Değer: MenuItemOption

@id String

Zorunlu.

Menü öğesi seçeneğinin benzersiz tanımlayıcısıdır.

Örnek: menu_item_1_option

menuItemId ReverseReference

Zorunlu.

Bu MenuItemOption varlığıyla ilişkili MenuItem varlığının @id değeri.

Örnek: { "@id": "menu_item_1", "displayOrder": 4 }

optionType OptionType

Menü öğesi seçeneğinin boyut, seçenek veya pizza yanında kategorize edilip edilmediğini belirten bir dize. Kabul edilen değerler: "SIZE", "OPTION" ve "PIZZA_SIDE". "SIZE": MenuItemOption öğesinin boyutu. Örneğin, küçük, orta veya büyük. "OPTION": Beden dışındaki tüm varyantlar (ör. salata veya sandviç olarak sunulan bir yemek). "SIZE" ile "OPTION" arasında ayrım yapamıyorsanız "OPTION"u kullanın. "PIZZA_SIDE": Pizzalara özgüdür: Bu örnekte MenuItemOption yalnızca bir dilim/bütün pizza için geçerlidir (ör. sol tarafta, sağ tarafta veya pizzanın tamamında mantar sosu).

Örnek: SIZE

value Dize veya PizzaSide

optionType is defined olduğunda gereklidir.

Dize değeri veya enum değeri. Enum değerleri, PIZZA_SIDE seçenek türüne özeldir.

applicableParentOptionValue String

Bu seçeneğin kullanılabildiği üst öğenin seçenek değerini içeren bir dize.

Örnek: Small

menuAddOnId List<String>

Bu MenuItemOption öğesine karşılık gelen eklenti bölümündeki MenuSection öğelerinin @id değerlerinin listesi.

Önemli: Yalnızca menuAddOnId veya MenuSection.parentMenuItemId referanslarından birini kullanmanız gerekir.

Örnek: menuAddOnId

nutrition NutritionInformation

Yemeğin kalori başta olmak üzere besin bilgileri.

Örnek: { "calories": "120-150 Cal" }

allergen List<Allergen>

Bu MenuItem öğesinin alerjenleri.

Örnek: { "allergenType": "PEANUTS", "levelOfContainment": "MAY_CONTAIN" }

additive List<Additive>

Bu MenuItem öğesinin katkı maddeleri.

Örnek: { "additiveName": "Sodium nitrite", "levelOfContainment": "CONTAINS" }

depositInfo DepositInfo

Bu MenuItem öğesinin ambalaj ve geri dönüşüm bilgileri.

Örnek: { "depositCode": "RECYCLABLE", "depositValue": "0.05", "depositValueCurrency": "USD" }

numberOfServings Tamsayı

Belirli bir menü öğesi seçeneğinde sunulan porsiyon sayısı.

Örnek: 2

dateModified ISO Zaman Damgası

MenuItemOption öğesi feed'inin ISO zaman damgası biçiminde ancak dize türüne sahip son değiştirilme tarihi ve saati.

Örnek: 2017-01-02T00:00:00-07:00

Aşağıdaki örnekte bir MenuItemOption öğesi gösterilmektedir:

{
  "@type": "MenuItemOption",
  "@id": "56177944",
  "menuItemId": {
    "@id": "18930213",
    "displayOrder": 1234
  },
  "optionType": "PIZZA_SIDE",
  "value": "PIZZA_SIDE_LEFT"
}
{
  "@type": "MenuItemOption",
  "@id": "56177944",
  "menuItemId": {
    "@id": "18930213",
    "displayOrder": 1234
  },
  "applicableParentOptionValue": "Small Pizza"
}

Uygulanması gereken bir öğe. Bir MenuItem veya MenuItemOption varlığı için teklifi açıklar.

Aşağıdaki tabloda MenuItemOffer türünün özellikleri listelenmektedir:

Mülk Tür Açıklama
@type Const

Zorunlu.

Değer: MenuItemOffer

@id String

Zorunlu.

Menü öğesi teklifinin benzersiz tanımlayıcısıdır.

Örnek: menu_item_offer

sku String

Zorunlu.

Menü öğesi teklifinin tanımlayıcısıdır. SKU değerleri, birden fazla menü öğesi teklifi öğesinde farklı veya aynı olabilir. sku değeri, size API çağrısı yaptığımızda sırayla ayarlanır.

Örnek: Menu_item_offer_sku

price Number

Zorunlu.

Menü öğesi teklifinin fiyatı.

Örnek: 2.5

priceCurrency String

Zorunlu.

3 harfli ISO 4217 para birimi kodu.

Örnek: USD

availabilityId List<String>

Menü öğesi fırsatının ne zaman kullanılabileceğiyle ilgili ayrıntılar sağlayan müsaitlik durumu öğelerinin @id değerleri.

Örnek: [ "menu_availability_1" ]

eligibleQuantityMin Number

MenuItemOffer değerinin geçerli olduğu minimum sipariş miktarı.

Örnek: 1

eligibleQuantityMax Number

MenuItemOffer değerinin geçerli olduğu maksimum sipariş miktarı.

Örnek: 25

inventoryLevel Number

Bu MenuItemOffer'a karşılık gelen öğe veya öğeler için mevcut yaklaşık envanter seviyesi.

Örnek: 10

dateModified ISO Zaman Damgası

MenuItemOffer öğe feed'inin ISO zaman damgası biçiminde ancak dize türüne sahip son değiştirilme tarihi ve saati.

Örnek: 2017-01-02T00:00:00-07:00

applicableServiceType List<ServiceType>

Bu MenuItemOffer'nin geçerli olduğu hizmet. Varsayılan olarak, herkes için geçerli bir MenuItemOffer varsayılır.

offeredById List<String>

Bu MenuItemOffer özelliğinin kullanılabildiği Restaurant öğelerinin @id değerleri. Varsayılan olarak, MenuItemOffer'nin tüm konumlarda kullanılabildiği varsayılır.

Örnek: [ "restaurant_id_5", "restaurant_id_26" ]

Aşağıdaki mülk gruplarından tam olarak biri gereklidir.
menuItemId 1. Grup String

Bu MenuItemOffer varlığıyla ilişkili MenuItem varlığının @id değeri.

Örnek: menu_item_1

menuItemOptionId 2. Grup String

Bu MenuItemOffer varlığıyla ilişkili MenuItemOption varlığının @id değeri.

Örnek: menu_item_option_1

Aşağıdaki örnekte bir MenuItemOffer öğesi gösterilmektedir:

{
  "@type": "MenuItemOffer",
  "@id": "6680262",
  "sku": "offer-mediterranean-bagel",
  "menuItemId": "896532",
  "price": 15.5,
  "priceCurrency": "USD",
  "applicableServiceType": [
    "DELIVERY"
  ],
  "offeredById": [
    "bagel_shop_location_5"
  ]
}

Yaygın

ReverseReference

Aşağıdaki tabloda ReverseReference türünün özellikleri listelenmektedir:

Mülk Tür Açıklama
@id String

Zorunlu.

Üst öğenin @id değeri.

displayOrder Tamsayı

Zorunlu.

Öğenin üst öğe içindeki sırasını gösterir.

NutritionInformation

Aşağıdaki tabloda NutritionInformation türünün özellikleri listelenmektedir:

Mülk Tür Açıklama
description String

Serbest metin biçimindeki besin değeri bilgileri. Örneğin, "Koruyucu madde içerir".

calories String

Aşağıdaki biçimi kullanarak kalori sayısı (kalori, kcal veya kJ): değer Kalori veya min-max Kalori

Örnek: 120.34 Cal

sodiumContent String

Aşağıdaki biçim kullanılarak mg veya g cinsinden sodyum miktarı: değer g veya min-maks g

Örnek: 1200 mg

Aşağıdaki örnekte bir NutritionInformation öğesi gösterilmektedir:

Örnek

{
  "calories": "120-150 Cal",
  "sodiumContent": "100 mg"
}

Alerjen

Aşağıdaki tabloda Allergen türünün özellikleri listelenmektedir:

Mülk Tür Açıklama
allergenType AllergenType

Zorunlu.

Alerjen türü.

levelOfContainment ContainmentLevel

Menü öğesindeki belirli bir alerjenin düzeyi.

Aşağıdaki örnekte bir Allergen öğesi gösterilmektedir:

Örnek

{
  "allergenType": "PEANUTS",
  "levelOfContainment": "MAY_CONTAIN"
}

Katkı maddesi

Aşağıdaki tabloda Additive türünün özellikleri listelenmektedir:

Mülk Tür Açıklama
additiveName String

Zorunlu.

Katkı maddesinin adı.

levelOfContainment ContainmentLevel

Menü öğesindeki belirli bir katkı maddesinin düzeyi.

Aşağıdaki örnekte bir Additive öğesi gösterilmektedir:

Örnek

{
  "additiveName": "Sodium nitrite",
  "levelOfContainment": "CONTAINS"
}

DepositInfo

Aşağıdaki tabloda DepositInfo türünün özellikleri listelenmektedir:

Mülk Tür Açıklama
depositCode DepositCode

Depozito kodu.

depositValue Number

Öğenin peşinatının sayısal değeri (ör. geri dönüştürüldüğünde).

depositValueCurrency String

Teminat değerinin para birimi

Aşağıdaki örnekte bir DepositInfo öğesi gösterilmektedir:

Örnek

{
  "depositCode": "RECYCLABLE",
  "depositValue": 0.05,
  "depositValueCurrency": "USD"
}

ServingConfig

Çeşitli özellikleri kontrol etmek için kullanılan hizmetin yayınlama yapılandırması (ör. promosyon widget'ını devre dışı bırakma vb.).

Aşağıdaki tabloda ServingConfig türünün özellikleri listelenmektedir:

Mülk Tür Açıklama
disableOrderInstructions Boole

Sipariş talimatlarını belirtme özelliğini gizler.

disableMenuItemSpecialInstructions Boole

Bir menü öğesi için özel talimatlar belirtme özelliğini gizler.

disableTipWidget Boole

Sipariş akışının "Sipariş Ver" sayfasında bahşiş widget'ını gizler.

disablePromoWidget Boole

Sipariş akışının "Sipariş Ver" sayfasında promosyon widget'ını gizler.

menuItemSpecialInstructionsMaxLength Number

Bir menü öğesi özel talimatının içerebileceği maksimum karakter sayısını belirtir.

orderInstructionsMaxLength Number

Bir sipariş talimatının içerebileceği maksimum karakter sayısını belirtir.

Aşağıdaki örnekte bir ServingConfig öğesi gösterilmektedir:

1. Örnek

{
  "disableMenuItemSpecialInstructions": true
}

2. Örnek

{
  "disableTipWidget": true,
  "disablePromoWidget": true
}

3. Örnek

{
  "menuItemSpecialInstructionsMaxLength": 250,
  "orderInstructionsMaxLength": 1000
}

Sıralamalar

HaftanınGünü

DayOfWeek türü aşağıdaki olası değerlere sahiptir:

  • MONDAY
  • TUESDAY
  • WEDNESDAY
  • THURSDAY
  • FRIDAY
  • SATURDAY
  • SUNDAY

ServiceType

ServiceType türü aşağıdaki olası değerlere sahiptir:

  • DELIVERY
  • TAKEOUT

OrderType

OrderType türü aşağıdaki olası değerlere sahiptir:

  • ASAP
  • ADVANCE

FeeType

FeeType türü aşağıdaki olası değerlere sahiptir:

  • DELIVERY
  • SERVICE

OptionType

OptionType türü aşağıdaki olası değerlere sahiptir:

  • SIZE
  • OPTION
  • PIZZA_SIDE

PizzaSide

PizzaSide türü aşağıdaki olası değerlere sahiptir:

  • PIZZA_SIDE_LEFT
  • PIZZA_SIDE_RIGHT
  • PIZZA_SIDE_WHOLE

AllergenType

gs1:AllergenTypeCode'ye göre alerjen türü.

AllergenType türü aşağıdaki olası değerlere sahiptir:

  • ALMONDS
  • ALPHA_ISOMETHYL_IONONE
  • ALCOHOL
  • AMYL_CINNAMAL
  • ANISE_ALCOHOL
  • BARLEY
  • BENZYL_ALCOHOL
  • BENZYL_BENZOATE
  • BENZYL_CINNAMATE
  • BENZYL_SALICYLATE
  • BRAZIL_NUTS
  • BUTYLPHENYL_METHYLPROPIONATE
  • CARROTS
  • CASHEW_NUTS
  • CELERY
  • CEREALS_CONTAINING_GLUTEN
  • CINNAMAL
  • CINNAMYL_ALCOHOL
  • CITRAL
  • CITRONELLOL
  • COCOA
  • CORIANDER
  • CORN
  • COUMARIN
  • CRUSTACEANS
  • EGGS
  • EUGENOL
  • EVERNIA_FURFURACEA
  • EVERNIA_PRUNASTRI
  • FARNESOL
  • FISH
  • GERANIOL
  • GLUTEN
  • HAZELNUTS
  • HEXYL_CINNAMAL
  • HYDROXYCITRONELLAL
  • HYDROXYISOHEXYL_3_CYCLOHEXENE_CARBOXALDEHYDE_ISOEUGENOL_LIMONENE_LINAL
  • KAMUT
  • LACTOSE
  • LUPINE
  • MACADAMIA_NUTS
  • METHYL_2_OCTYNOATE
  • MILK
  • MOLLUSCS
  • MUSTARD
  • NO_DECLARED_ALLERGENS
  • OAT
  • PEANUTS
  • PEAS
  • PECAN_NUTS
  • PISTACHIOS
  • POD_FRUITS
  • QUEENSLAND_NUTS
  • RYE
  • SESAME_SEEDS
  • SOYBEANS
  • SPELT
  • SULPHUR_DIOXIDE
  • TREE_NUTS
  • TREE_NUT_TRACES
  • WALNUTS
  • WHEAT

ContainmentLevel

ContainmentLevel türü aşağıdaki olası değerlere sahiptir:

  • CONTAINS
  • FREE_FROM
  • MAY_CONTAIN

DepositCode

DepositCode türü aşağıdaki olası değerlere sahiptir:

  • REUSABLE
  • RECYCLABLE

DealType

İndirimin uygulanacağı fırsat kategorisi. Kategori, alışveriş sepeti toplamının tamamı veya teslimat ücretleri olabilir.

DealType türü aşağıdaki olası değerlere sahiptir:

  • CART_OFF
  • DELIVERY_OFF

RestrictedDiet

schema.org:RestrictedDiet'e göre kısıtlanmış diyet türü.

RestrictedDiet türü aşağıdaki olası değerlere sahiptir:

  • DIABETIC
  • GLUTEN_FREE
  • HALAL
  • HINDU
  • KOSHER
  • LOW_CALORIE
  • LOW_FAT
  • LOW_LACTOSE
  • LOW_SALT
  • VEGAN
  • VEGETARIAN