İlişkisel envanter şeması

Bu sayfada, Google'a sağladığınız Sipariş Uçtan Uca veri feed'lerinin (Yemek 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

Öğeler, feed'lerdeki her varlık için bir satırda olacak şekilde yapılandırılmalıdır (varlıklar yeni satır karakterleriyle ayrılır). Okunabilirlik açısından bu sayfadaki JSON örnekleri bu yapıyı izlemez. Ancak feed'lerinizi gönderirken bu yapıya uymanız gerekir. Örneğin, bir menü öğesi aşağıdaki gibi yapılandırılmalıdır:

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

Her "Restaurant" varlığında iki Hizmet varlığı (her biri "DELIVERY" ve "TakeOUT" hizmet türleri için birer öğe) olabilir. Her "Hizmet" varlığının yalnızca bir "Menü" varlığı olabilir.

Herhangi bir alt varlık birden fazla restoranda yeniden kullanılabilir.

JSON değeri yönergeleri

Tür zorlaması

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

Tür zorlaması, tekrarlanan özellikler için de işe yarar. Tekrarlanan özellikler, değerleri köşeli parantez [] içine alınmadan giriş olarak kabul edebilir. Örneğin, OperationHours.serviceId özelliği hem "service_id" hem de ["service_id"] özelliğini geçerli giriş olarak kabul eder.

DateTime ve Time Value (Tarih ve Saat Değerleri)

DateTime, schema.org türünü temel alır. Aksi belirtilmedikçe, aksi belirtilmedikçe ISO 8601 biçimine uygun olmalı ve tarih, saat ve saat dilimini içermelidir. DateTime için şu 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 veya hizmet konumunun saat dilimi için yerel saattir, schema.org türünü temel alır ve ISO 8601 biçimine uygun olmalıdır. Time, şu söz dizimini kullanır:

// Time format:
THH:MM:SS

Örneğin:

T08:08:00 // 8:08 AM

DateTime veya Time belirttiğinizde aşağıdakilere dikkat edin:

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

Restoran verileri

Restoran (zorunlu)

Uygulama için gerekli bir varlık. Bir restoranı tanımlar.

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

Özellik Tür Açıklama
@type Sabit

Zorunlu.

Değer: Restaurant

@id String

Zorunlu.

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

Örnek: restaurant_1

name String

Zorunlu.

Restoranın adı.

Örnek: Foo

description String

Restoranla ilgili açıklama.

Örnek: Best seafood in town

url URL

Restoranı temsil eden URL. Restoran alan adı, toplayıcı alan adına göre 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.

Şehir 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. Doğruluk en az 5 ondalık basamak olmalıdır.

Örnek: 35.7392607

longitude Number

Derece cinsinden boylam. Değerler [[-180, 180]] aralığıyla sınırlıdır. Doğruluk en az 5 ondalık basamak olmalıdır.

Örnek: -120.3895522

dealId List<String>

Restoran için geçerli Deal'ler.

imprint String

Restoran dizisi, restoranla ilgili yasal ad, yasal adres ve tescil 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 Operatör bilgileri. Bu bilgi, Tacir Bilgileri bölümünde görüntülenir. 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 türü Dize olan 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:

Özellik Tür Açıklama
@type Sabit

Zorunlu.

Değer: Deal

@id String

Zorunlu.

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

Örnek: FREEDELIVERY

dealCode String

Zorunlu.

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

Örnek: ADETRE23

applicableServiceType Liste<ServiceType>

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

eligibleMaxOrders Integer

Bu anlaşma, yalnızca kullanıcının geçmiş başarılı sipariş sayısı bu sayı veya daha azsa uygun olur.

availabilityId List<String>

Menü bölümünün ne zaman kullanılabilir olduğuyla ilgili ayrıntıları sağlayan Müsaitlik Durumu varlıklarının @id değerleri.

Örnek: [ "availability_1" ]

isDisabled Boole

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

dealType DealType

Zorunlu.

İndirimin uygulanacağı anlaşma kategorisi. Kategori tüm alışveriş sepeti toplamını, hizmet ücretlerini veya teslimat ücretlerini içerebilir.

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 okunabilir hizmet şartları dokümanları.

dateModified ISO Zaman Damgası

Anlaşma varlık feed'inin ISO zaman damgası biçiminde, ancak Dize türünde son değiştirilme tarihi ve saati.

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

Aşağıdaki özellik gruplarından tam olarak biri gereklidir.
discount 1. Grup Number

İndirimin sayı olarak değeri.

discountPercentage 2. Grup Number

Orijinal fiyatın yüzdesi olarak indirimin değeri.

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 için yemek siparişi hizmeti ayrıntılarını açıklar. Service, uygulanması gerekli bir varlık.

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

Özellik Tür Açıklama
@type Sabit

Zorunlu.

Değer: Service

@id String

Zorunlu.

Sipariş karşılama hizmetinin tanımlayıcısı.

Örnek: service_1

serviceType ServiceType

Zorunlu.

Sunulan hizmetin türü. Olası değerler "DELIVERY" veya "TakeOUT" şeklindedir.

Örnek: DELIVERY

restaurantId String

Zorunlu.

Restoran varlığının @id değeri, bu Hizmet varlığıyla ilişkilidir.

Örnek: restaurant_1

menuId String

Zorunlu.

Bu Hizmet varlığıyla ilişkili Menü varlığının @id değeri.

Örnek: menu_1

dateModified ISO Zaman Damgası

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

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

isDisabled Boole

Varlığın devre dışı bırakılıp bırakılmadığını gösterir. Bu türü yalnızca beklenmeyen bir etkinlik nedeniyle varlığı devre dışı bırakmanız gerekiyorsa ve hizmetin ne zaman yeniden kurulacağını bilmiyorsanız (ör. tatiller için kullanmayın) kullanın.

Örnek: true

servingConfig ServingConfig

Çeşitli özellikleri kontrol etmek için kullanılan hizmet için sunum yapılandırması (ör. tanıtım widget'ını devre dışı bırakma vb.)

actionLinkUrl String

Uçtan uca yemek siparişi deneyiminden yönlendirmeye geçiş sırasında kullanılacak bir teslimat/paket servisi hizmetinin 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

Yemeğin teslim edilebileceği coğrafi bölgeyi tanımlar. İlişkilendirilen Service varlığı serviceType "DELIVERY" olarak ayarlanmışsa bu varlığın uygulanması gerekir.

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

Özellik Tür Açıklama
@type Sabit

Zorunlu.

Değer: ServiceArea

@id String

Zorunlu.

Hizmet bölgesinin benzersiz tanımlayıcısı.

Örnek: service_area_1

serviceId List<String>

Zorunlu.

Bu ServiceArea varlığıyla ilişkili Hizmet varlığının @id değeri.

Örnek: [ "service_1" ]

dateModified ISO Zaman Damgası

ServiceArea öğe feed'inin ISO zaman damgası biçiminde, ancak String türünde 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 özellik gruplarından tam olarak biri gereklidir.
polygon 1. Grup List<String>

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

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

geoMidpointLatitude 2. Grup Number

CIRCLE alanının merkezindeki enlem koordinatını gösterir.

Örnek: 37.806000

geoMidpointLongitude 2. Grup Number

CIRCLE alanının merkezindeki boylam koordinatını belirtir.

Örnek: -122.425592

geoRadius 2. Grup Integer

CIRCLE 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 alpha-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ışma Saatleri (zorunlu)

Kullanıcıların akışa erişebileceği ve en kısa sürede sipariş verebileceği sipariş aralığını açıklar. OperationHours uygulanması zorunludur ve varsayılan olarak tüm günlerde, tüm saatlerde işlemi temsil eder.

OperationHours opens ve closes özellikleri, kullanıcıların sipariş vermesine olanak tanıyan online sistem için açılış ve kapanış saatlerini belirtir. Bu online sistem saatlerinde, kullanıcıların siparişlerinin karşılanabileceği açılış ve kapanış saatlerini belirtmek için ServiceHours kullanın.

Hizmetin saatleri, yerel saatte belirtilmelidir. opens değerine saat dilimi eklemeyin. Bir saat dilimi belirtilirse Google bu bilgiyi yok sayar. 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:

Özellik Tür Açıklama
@type Sabit

Zorunlu.

Değer: OperationHours

@id String

Zorunlu.

Kullanıcıların akışa erişebileceği ve en kısa sürede/gelecekteki siparişleri verebileceği sipariş aralığını açıklayan, varlığa ait benzersiz tanımlayıcı.

Örnek: operation_hour_1

serviceId List<String>

Zorunlu.

Hizmet varlığının @id değeri, bu OperationHours varlığıyla ilişkili.

Örnek: [ "service_1" ]

opens ISO Saati (Yerel)

Kullanıcı siparişlerinin verilebileceği belirli bir saati ISO biçiminde belirtir.

Örnek: T00:00

closes ISO Saati (Yerel)

Kullanıcı siparişlerinin verilemeyecek belirli bir saatini ISO biçiminde belirtir.

Örnek: T16:00

dayOfWeek Liste<DayOfWeek>

Bu işlem saatlerinin geçerli olduğu haftanın günlerinin listesi. Kabul edilebilir değerler "PAZARTESİ", "SALI", "ÇARŞAMBA", "PERŞEMBE", "CUMA", "CUMARTESİ" ve "PAZAR"dır.

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

validFrom ISO Zaman Damgası

isSpecialHour = true olduğunda gereklidir.

Kullanıcıların akışa erişebileceği ve en kısa sürede sipariş verebilecekleri sipariş aralığının başlangıç saatini gösteren bir 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şemediği ve en kısa sürede sipariş veremeyeceği sipariş aralığının bitiş zamanını gösteren ISO Zaman Damgası.

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

isSpecialHour Boole

OperationHours'un özel çalışma saatleri için olup olmadığını gösteren boole. Kabul edilebilir değerler "false" ve "true" şeklindedir.

Örnek: False

dateModified ISO Zaman Damgası

ProcessHours öğe feed'inin ISO zaman damgası biçiminde, String türünde 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
}

ServiceHours (zorunlu)

Kullanıcıların karşılama slotlarını (En Kısa Zamanda veya gelecekteki slotlar) seçebileceği sipariş karşılama aralığını açıklar. ServiceHours uygulanması gerekir.

OperationHours opens ve closes özellikleri, kullanıcıların sipariş vermesine olanak tanıyan online sistem için açılış ve kapanış saatlerini belirtir. Bu online sistem saatlerinde, kullanıcıların siparişlerinin karşılanabileceği açılış ve kapanış saatlerini belirtmek için ServiceHours kullanın.

Hizmetin saatleri, yerel saatte belirtilmelidir. opens değerine saat dilimi eklemeyin. Bir saat dilimi belirtilirse Google bu bilgiyi yok sayar. 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:

Özellik Tür Açıklama
@type Sabit

Zorunlu.

Değer: ServiceHours

@id String

Zorunlu.

Kullanıcıların sipariş karşılama aralıklarını (en kısa sürede veya gelecekteki slotlar) seçebileceği sipariş karşılama aralığını açıklayan benzersiz tanımlayıcı.

Örnek: service_hour_1

orderType OrderType

Zorunlu.

Hizmet saatlerinin en kısa zamanda mı yoksa gelişmiş siparişler için mi geçerli olduğunu gösteren bir Dize. Kabul edilebilir değerler "En Kısa Zamanda" ve "Gelişmiş" değerleridir.

Örnek: ASAP

serviceId List<String>

Zorunlu.

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

Örnek: [ "service_1" ]

operationHoursId List<String>

isSpecialHour = false olduğunda gereklidir.

ProcessHours varlığının @id değeri, bu ServiceHours varlığıyla ilişkili.

Örnek: [ "operation_hour_1" ]

opens ISO Saati (Yerel)

Kullanıcıların siparişlerinin karşılanabileceği belirli bir saati ISO biçiminde belirtir.

Örnek: T00:00

closes ISO Saati (Yerel)

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

Örnek: T16:00

dayOfWeek Liste<DayOfWeek>

Bu işlem 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şebileceği ve en kısa sürede sipariş verebilecekleri sipariş aralığının başlangıç saatini gösteren bir 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şemediği ve en kısa sürede sipariş veremeyeceği sipariş aralığının bitiş zamanını gösteren ISO Zaman Damgası.

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

isSpecialHour Boole

OperationHours'un özel çalışma saatleri için olup olmadığını gösteren boole. Kabul edilebilir değerler "false" ve "true" şeklindedir.

Örnek: False

leadTimeMin Integer

Sipariş en kısa süre içinde verildikten sonra, dakika cinsinden minimum tahmini teslimat/teslim alma süresi. Bu özelliği ayarlamanızı önemle tavsiye ederiz.

Örnek: 60

leadTimeMax Integer

Sipariş en kısa süre içinde verildikten sonra, dakika cinsinden maksimum tahmini teslimat/teslim alma süresi. Bu özelliği ayarlamanızı önemle tavsiye ederiz.

Örnek: 70

advanceBookingRequirementMin Integer

orderType = "ADVANCE" olduğunda gereklidir.

Sipariş zamanından itibaren ön siparişin karşılanabileceği minimum dakika sayısı. Örneğin, bir ön siparişin tamamlanması için en az 60 dakika gerekiyorsa PreBookingRequirementMin 60'tır.

Örnek: 15

advanceBookingRequirementMax Integer

orderType = "ADVANCE" olduğunda gereklidir.

Sipariş zamanından itibaren ön siparişin karşılanabileceği maksimum dakika sayısı. Örneğin, bir ön siparişin gerçekleştirilmesi 2 günden uzun bir süre sonra kısıtlanmışsa öncedenBookingRequirementMax değeri 2880 olur.

Örnek: 10080

advanceBookingSlotInterval String

orderType = "ADVANCE" olduğunda gereklidir.

Art arda gelen iki ön rezervasyon aralığı arasındaki aralık. Örneğin, açılış ve kapanış saatleri 08:00 ile 20:00 ve PreBookingSlotInterval 15 dakikaysa kullanıcı, sipariş karşılama saatlerini 08:00, 08:15, 08:30, 08:45 vb. olarak 20:00'a kadar seçebilir. 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 varlık feed'inin ISO zaman damgası biçiminde, ancak Dize türünde 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

Ücreti tanımlar. İlişkilendirilmiş Service varlığı serviceType öğesi "DELIVERY" olarak ayarlanmışsa feeType değeri "DELIVERY" olarak ayarlanmış bir Fee gerekir.

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

Özellik Tür Açıklama
@type Sabit

Zorunlu.

Değer: Fee

@id String

Zorunlu.

Ücreti açıklayan tüzel kişinin benzersiz tanımlayıcısı.

Örnek: service_fee_1

serviceId List<String>

Zorunlu.

Hizmet varlığının @id değeri, bu Ücret varlığıyla ilişkilidir.

Örnek: [ "service_1" ]

feeType FeeType

Zorunlu.

Ücretin teslimat mı yoksa hizmet siparişleri için mi geçerli olduğunu gösteren bir dize. Kabul edilebilir değerler "DELIVERY" ve "SERVICE" değerleridir.

Örnek: DELIVERY

priceCurrency String

Zorunlu.

3 harfli ISO 4217 para birimi kodu.

Örnek: USD

basePrice Number

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

Örnek: 2.0

minPrice Number

percentageOfCart veya pricePerMeter kullanıldığında minimum ücret, ücret değerini sınırlandırır.

Örnek: 2.0

maxPrice Number

percentageOfCart veya pricePerMeter kullanıldığında maksimum ücret, ücret değerini sınırlandırır.

Örnek: 10.0

eligibleRegion List<String>

Ücretin geçerli olduğu jeo-politik bölgeler için ServiceArea'nın @id değeri. Bu tesisi 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 minimum işlem hacmi (para birimi cinsinden).

Örnek: 50

eligibleTransactionVolumeMax Number

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

Örnek: 10

validFrom ISO Zaman Damgası

Ücretin geçerli olduğu başlangıç saatini gösteren ISO Zaman Damgası.

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

validThrough ISO Zaman Damgası

Ücretin geçersiz olacağı bitiş saatini gösteren ISO Zaman Damgası.

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

dateModified ISO Zaman Damgası

Ücret varlık feed'inin ISO zaman damgası biçiminde, ancak Dize türünde son değiştirilme tarihi ve saati.

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

priority Number

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

Örnek: 3

Aşağıdaki özellik gruplarından tam olarak biri gereklidir.
price 1. Grup Number

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

Örnek: 1.5

percentageOfCart 2. Grup Number

Alışveriş sepeti değerinin yüzdesi cinsinden ücret. Kabul edilebilir değerler, 0 ile 100 arasındaki (0 ve 100 dahil) kayan değerlerdir.

Örnek: 9.00

pricePerMeter 3. Grup Number

Kullanıcıdan radyal mesafe için metre başına ücret. Ör. Kullanıcıya mesafe 5 km ise ve ücret 0,001 ABD dolarıysa 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
}

Uygulama için gerekli bir varlık. Bir menüyü açıklar.

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

Özellik Tür Açıklama
@type Sabit

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

Örnek: Foo

disclaimer String

Menü için sorumluluk reddi beyanı. Örneğin, beslenmeyle ilgili bilgilerin ve alerjenlerle ilgili açıklama.

Örnek: Items may contain peanuts.

disclaimerUrl URL

Sorumluluk reddi beyanıyla ilgili daha fazla ayrıntı sağlayan bir sayfaya yönlendiren URL.

dateModified ISO Zaman Damgası

Menü öğesi feed'inin ISO zaman damgası biçiminde, ancak tür Dizeye sahip olan 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 varlık. Menüdeki belirli bir bölümü açıklar.

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

Özellik Tür Açıklama
@type Sabit

Zorunlu.

Değer: MenuSection

@id String

Zorunlu.

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

Örnek: menu_section_1

menuId Liste<ReverseReference>

Menü öğesinin @id değeri, bu MenuSection varlığıyla ilişkili.

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

menuSectionId List<String>

Bu MenuSection varlığına karşılık gelen alt MenuSection varlıklarının @id değerlerinin listesi.

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

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

parentMenuSectionId Liste<ReverseReference>

Üst MenuSection öğesinin @id değeri, bu MenuSection varlığıyla ilişkili.

Önemli: parentMenuSectionId veya menuSectionId(in parent) referanslarından yalnızca 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ü resminin URL'si.

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

menuItemId List<String>

Bu MenuSection varlığına karşılık gelen MenuItem varlıklarının @id değerlerinin listesi.

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

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

parentMenuItemId Liste<ReverseReference>

Bu MenuSection varlığına karşılık gelen üst MenuItem varlıklarının @id değerlerinin listesi.

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

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

parentMenuItemOptionId Liste<ReverseReference>

Bu MenuSection varlığına karşılık gelen üst MenuItemOption varlıklarının @id değerlerinin listesi.

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

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

eligibleQuantityMax Integer

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

Örnek: 5

eligibleQuantityMin Integer

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 olan MenuItem varlıklarına referans veren @id öğelerinin bir listesi. Kullanıcılar son seçimleri değiştirebilir. defaultItemId belirtilmezse önceden MenuItem seçilmez.

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

availabilityId List<String>

Menü bölümünün ne zaman kullanılabilir olduğuyla ilgili ayrıntıları sağlayan Müsaitlik Durumu varlıklarının @id değerleri.

Örnek: [ "menu_availability_1" ]

numberOfFreeAddOns Integer

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

Örnek: 3

dateModified ISO Zaman Damgası

MenuSection öğe feed'inin ISO zaman damgası biçiminde, Dize türünde son değiştirilme tarihi ve saati.

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

applicableServiceType Liste<ServiceType>

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

offeredById List<String>

Bu MenuSection öğesinin kullanılabildiği Restaurant varlıkların @id değerleri. Varsayılan olarak bir MenuSection öğesinin tüm konumlarda mevcut olduğu 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 varlık. Bir MenuSection varlığının yayınlandığı dönemi açıklar.

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

Özellik Tür Açıklama
@type Sabit

Zorunlu.

Değer: Availability

@id String

Zorunlu.

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

Örnek: menu_section_avail_1

availabilityStarts ISO Saati (Yerel)

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

Örnek: T00:00

availabilityEnds ISO Saati (Yerel)

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

Örnek: T16:00

availableDay Liste<DayOfWeek>

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

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

validFrom ISO Zaman Damgası

Menü bölümü 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ü kullanılabilirliğinin geçersiz olacağı bitiş zamanını gösteren ISO Zaman Damgası.

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

dateModified ISO Zaman Damgası

Müsaitlik durumu öğe feed'inin ISO zaman damgası biçiminde, Dize türünde son değiştirilme tarihi ve saati.

Ö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"
  ]
}

Uygulama için gerekli bir varlık. Menu varlığındaki bir öğeyi açıklar.

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

Özellik Tür Açıklama
@type Sabit

Zorunlu.

Değer: MenuItem

@id String

Zorunlu.

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

Ö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ü öğesi resminin URL'si.

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

parentMenuSectionId Liste<ReverseReference>

Bu MenuItem varlığına karşılık gelen üst MenuSection varlıklarının @id değerlerinin listesi.

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

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

menuAddOnId List<String>

Bu MenuItem varlığına karşılık gelen eklenti bölümündeki MenuSection varlıklarının @id değerlerinin listesi.

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

Örnek: menu_addon_1

nutrition NutritionInformation

Yemekle ilgili besin bilgileri, özellikle de kalori verileri.

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

allergen Liste<Allergen>

Bu Menü Öğesinin alerjenleri.

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

additive Liste<Additive>

Bu Menü Öğesinin katkı maddeleri.

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

suitableDiet Liste<RestrictedDiet>

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

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

depositInfo DepositInfo

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

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

numberOfServings Integer

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

Örnek: 2

dateModified ISO Zaman Damgası

MenuItem öğe feed'inin ISO zaman damgası biçiminde, Dize türünde 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 varlık. Kullanıcının bir yemek/kombo seçerken yapması gereken seçimleri açıklar. Kullanıcı bir seçenek belirlemelidir, aksi takdirde sipariş geçersiz sayılır (ör. kullanıcı pizza için küçük, orta veya büyük seçeneğini belirlemelidir).

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

Özellik Tür Açıklama
@type Sabit

Değer: MenuItemOption

@id String

Zorunlu.

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

Örnek: menu_item_1_option

menuItemId ReverseReference

Zorunlu.

MenuItem varlığının @id değeri, bu MenuItemOption varlığıyla ilişkilendirildi.

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

optionType OptionType

Menü öğesi seçeneğinin boyut, seçenek veya pizza tarafı şeklinde kategorilere ayrıldığını gösteren bir Dize. Kabul edilebilir değerler "SIZE", "OPTION" ve "PIZZA_SIDE" şeklindedir. "SIZE": Menü Öğesi Seçeneğinin boyutu. Örneğin, küçük, orta veya büyük. "OPTION": Beden dışındaki herhangi bir varyasyon (ör. salata veya sandviç olarak gelen bir yemek). "SIZE" ile "OPTION" arasında ayrım yapamıyorsanız "OPTION" öğesini kullanın. "PIZZA_SIDE": Pizzalara özel: Örneğin, bu MenuItemOption değerinin sadece bir kısmı/tam pizza için geçerlidir (ör. sol tarafta, sağ tarafta veya bütün pizzada mantarlı malzeme).

Örnek: SIZE

value Dize veya PizzaSide

optionType is defined olduğunda gereklidir.

Bir dize değeri veya numaralandırma değeri. Sıralama değerleri PIZZA_SIDE seçenek türüne özgüdür.

applicableParentOptionValue String

Bu seçeneğin kullanılabileceği üst öğenin seçenek değerinin değerini içeren bir Dize.

Örnek: Small

menuAddOnId List<String>

Bu MenuItemOption varlığına karşılık gelen eklenti bölümündeki MenuSection varlıklarının @id değerlerinin listesi.

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

Örnek: menuAddOnId

nutrition NutritionInformation

Yemekle ilgili besin bilgileri, özellikle de kalori verileri.

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

allergen Liste<Allergen>

Bu Menü Öğesinin alerjenleri.

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

additive Liste<Additive>

Bu Menü Öğesinin katkı maddeleri.

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

depositInfo DepositInfo

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

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

numberOfServings Integer

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

Örnek: 2

dateModified ISO Zaman Damgası

MenuItemOption öğe feed'inin son değiştirilme tarihi ve saati. ISO zaman damgası biçiminde, String türünde.

Ö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"
}

Uygulama için gerekli bir varlık. Bir MenuItem veya MenuItemOption varlığı için teklifi açıklar.

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

Özellik Tür Açıklama
@type Sabit

Zorunlu.

Değer: MenuItemOffer

@id String

Zorunlu.

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

Örnek: menu_item_offer

sku String

Zorunlu.

Menü öğesi teklifinin tanımlayıcısı. SKU değerleri, birden fazla menü öğesi teklif varlığında farklı veya aynı olabilir. SKU değeri, size bir 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 teklifinin ne zaman kullanıma sunulacağıyla ilgili ayrıntılar sağlayan Müsaitlik Durumu varlıklarının @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 geçerli yaklaşık envanter düzeyi.

Örnek: 10

dateModified ISO Zaman Damgası

MenuItemOffer öğe feed'inin ISO zaman damgası biçiminde, Dize türünde son değiştirilme tarihi ve saati.

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

applicableServiceType Liste<ServiceType>

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

offeredById List<String>

Bu MenuItemOffer öğesinin kullanılabildiği Restaurant varlıkların @id değerleri. Varsayılan olarak bir MenuItemOffer öğesinin tüm konumlarda mevcut olduğu varsayılır.

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

Aşağıdaki özellik gruplarından tam olarak biri gereklidir.
menuItemId 1. Grup String

MenuItem varlığının @id değeri, bu MenuItemOffer varlığıyla ilişkilendirildi.

Örnek: menu_item_1

menuItemOptionId 2. Grup String

MenuItemOption varlığının @id değeri, bu MenuItemOffer varlığıyla ilişkilendirildi.

Ö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:

Özellik Tür Açıklama
@id String

Zorunlu.

ana varlığın @kimliği.

displayOrder Integer

Zorunlu.

Öğenin sırasını üst öğe içinde görüntüleyin.

NutritionInformation

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

Özellik Tür Açıklama
description String

Besin değeri bilgileri serbest metin halindedir. Örneğin, "Koruyucu madde içerir".

calories String

Şu biçim kullanılarak Cal, kcal veya kJ cinsinden kalori sayısı: Cal veya min-max Cal

Örnek: 120.34 Cal

sodiumContent String

Şu biçim kullanılarak mg veya g sodyum sayısı: 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:

Özellik Tür Açıklama
allergenType AllergenType

Zorunlu.

Alerjen türü.

levelOfContainment ContainmentLevel

Menü öğesindeki belirli bir alerjen seviyesi.

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:

Özellik Tür Açıklama
additiveName String

Zorunlu.

Katkı maddesinin adı.

levelOfContainment ContainmentLevel

Menü öğesindeki belirli bir katkı maddesinin seviyesi.

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:

Özellik Tür Açıklama
depositCode DepositCode

Depozito Kodu.

depositValue Number

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

depositValueCurrency String

Depozito 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 hizmet için sunum yapılandırması (ör. tanıtım widget'ını devre dışı bırakma vb.)

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

Özellik Tür Açıklama
disableOrderInstructions Boole

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

disableMenuItemSpecialInstructions Boole

Bir menü öğesinde özel talimatlar belirtme özelliğini gizler.

disableTipWidget Boole

Sipariş akışının "Sipariş Ver" sayfasındaki ipucu widget'ını gizler.

disablePromoWidget Boole

Sipariş akışının "Sipariş Ver" sayfasındaki tanıtım widget'ını gizler.

menuItemSpecialInstructionsMaxLength Number

Özel bir menü öğesinin 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

DayOfWeek

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 başına 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ğı anlaşma 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 adresine 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