v1 在庫スキーマ

食品カタログ フィードは schema.org DataFeed に基づいています エンティティです。食品カタログ フィードは、 レストランの住所、メニュー、場所、レストランのサービス情報 配送料、配送地域、その他の指定した商品アイテムなどの詳細情報 ご覧ください

DataFeed には、要素のコレクションが含まれ、それぞれが 1 つのアイテムを表します。 schema.org のボキャブラリで表現されます。DataFeed を使用できます。 すべての構造化データを JSON-LD 形式で公開します。

この仕様を使用してフィードを作成する方法については、 広告枠の統合の概要

日時形式

DateTime は schema.org タイプに基づいています。 特に指定がない限り、ISO 8601 形式に準拠し、 日付、時刻、タイムゾーンが含まれます。DateTime には次の構文を使用します。

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

例:

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 は特定のレストランまたはレストランの現地時間です。 タイムゾーンも schema.org タイプに基づいており、 ISO 8601 形式にしますTime の構文は次のとおりです。

// Time format:
THH:MM:SS

例:

T08:08:00 // 8:08 AM

DateTime または Time を指定するときは、次の点に注意してください。

  • 「T」形式の一部であり、必須です。
  • DATETIME のタイムゾーンを指定する必要があります。TIME の場合は不要です。
  • 時間は、レストランまたはサービスの現地時間で指定する必要があります。
で確認できます。

封筒

食品カタログ フィードの開始コードには、。

「エンベロープ」各フィードの最上位の構造で、 次のプロパティを持つ DataFeed:

プロパティ タイプ 必要性 説明
@context URL 必須 使用中のコンテキスト。通常は "http://schema.googleapis.com" となります。
@type テキスト 必須 これは常に「DataFeed」です。
dateModified DateTime 必須

データフィードの最終更新日 DateTime(ISO 8601) 使用できます。

商品アイテムが掲載された日時(ISO_OFFSET_DATE_TIME 形式) が変更されました。このフィールドがない場合、 更新時刻はプッシュ メッセージが受信された時刻(または Google のサーバーでクロールされません。

2 つの push モードと push セッションの両方を クロールできます。このタイムスタンプはタイムゾーンで指定する必要があります ミリ秒単位の粒度です。例: "2016-12-28T06:30:00:123-07:00".

バッチフィードでは エンティティ バージョニングは、dateModified によって決定されます。 フィールドで確認できます。

dataFeedElement Menu または配列 Restaurant または Service 必須 このフィードに含まれる 1 つ以上の商品アイテム。下記をご覧ください: 表示されます。

次の例は、エンベロープを示しています。

{
  "@context": "http://schema.googleapis.com",
  "dateModified": "2016-12-28T06:30:00:123-07:00",
  "@type": "DataFeed",
  "dataFeedElement": [
    /* All items that are part of this feed go here */
  ]
}

AdditiveDetails

このタイプを使用するには、gs1 コンテキストを追加します。 "@context": ["http://gs1.org/voc/", "http://schema.org"]

次に、適切な MenuItem のタイプに FoodBeverageTobaccoProduct を追加します。 または MenuItemOption

次の表に、AdditiveDetails 型のプロパティを示します。

プロパティ タイプ 必要性 説明
@type テキスト 必須 これは常に「AdditiveDetails」です。
additiveName テキスト 省略可 添加物の名前。
additiveLevelOfContainment テキスト 省略可 封じ込めコード gs1:LevelOfContainmentCode: 例: http://gs1.org/voc/LevelOfContainmentCode-CONTAINS http://gs1.org/voc/LevelOfContainmentCode-FREE_FROM、または http://gs1.org/voc/LevelOfContainmentCode-MAY_CONTAIN

次の例は、AdditiveDetails タイプの使用方法を示しています。

{
  "@type": ["MenuItem", "FoodBeverageTobaccoProduct"],
  "@id": "http://www.example.com/bar/menuitem/8",
  "name": "Energy Drink",
  "description": "A 0.25l can of energy drink.",
  "offers": {
    "@type": "Offer",
    "sku": "offer-energy-drink",
    "price": "3.49",
    "priceCurrency": "USD"
  },
  "additive": [
    {
      "@type": "AdditiveDetails",
      "additiveName": "caffeine",
      "additiveLevelOfContainment":
        "http://gs1.org/voc/LevelOfContainmentCode-CONTAINS"
    },
    {
      "@type": "AdditiveDetails",
      "additiveName": "phosphate",
      "additiveLevelOfContainment":
        "http://gs1.org/voc/LevelOfContainmentCode-CONTAINS"
    }
  ]
},

AddOnMenuItem

MenuItem のアドオン メニュー項目に記載されている食品や飲料。

次の表に、AddOnMenuItem タイプのプロパティを示します。

プロパティ タイプ 必要性 説明
@type テキスト 必須 これは常に「AddOnMenuItem」です。
@id URL 必須 アドオン メニュー項目の一意の識別子。
name テキスト 必須 ユーザーがブラウジング中に AddOnMenuItem を識別するテキスト 選択します。
description テキスト 省略可 アドオンのメニュー項目の説明。
image URL 省略可

次のガイドラインに一致するアドオン メニュー項目の画像:

  • アスペクト比 3:2
  • >
  • 最小解像度 600 x 400 ピクセル、72 dpi
  • >
  • 推奨解像度 1, 400 x 960 ピクセル、72 dpi
offers Offer の配列 必須*

この AddOnMenuItem を提供するための 1 つ以上のオファー。

この AddOnMenuItem がいつ、どのような価格で販売されるかを示します。 一度に有効なオファーは 1 つのみです。広告の 価格または在庫状況が おすすめしますアドオンまたはアイテムが基本属性によって異なる場合 またはアドオン アイテム自体のバリエーション(小、中、大など) fries など)として、hasMenuItemOption を使用する プロパティです。

Offer.eligibleQuantity のデフォルトは最小値です 0、最大 1 です。

次の Offer プロパティは、 AddOnMenuItem:

  • Offer.skuが必要です
  • Offer.priceが必要です
  • Offer.priceCurrencyが必要です
  • Offer.availabilityStarts(省略可)
  • Offer.availabilityEnds(省略可)
  • Offer.availableDay(省略可)
  • Offer.validFrom(省略可)
  • Offer.validThrough(省略可)
  • Offer.eligibleQuantity(省略可)
  • Offer.inventoryLevel(省略可)
hasMenuItemOptions MenuItemOption の配列 必須*

アドオン アイテムのバリエーションを記述する基本属性の配列 (小、中、大のフライドポテトをアドオンとして追加するなど)し、 クリックします。オプションを使用して、利用可能なさまざまなバリエーションを指定する 選択しますこれが可能なシナリオは 2 つあります。 目的:

  • 基本のバリエーションはアドオン アイテム自体にあります(小さい、 中程度のフライドポテト、大きいフライドポテトをアドオンとして提供)
  • このアドオンが関連付けられているメニュー項目の基本バリエーション (大きなピザに付け替える追加チーズなど)
suitableForDiet RestrictedDiet の配列 省略可 料理が所定の食事制限( 「GlutenFreeDiet」「VeganDiet」)を入力します。これは、可能性のあるルールのリストです。 使用できます。
nutrition NutritionInformation 省略可 その料理の栄養情報、特にカロリーです。
menuAddOn AddOnMenuSection の配列 省略可 AddOnMenuItem には、許可されたアイテムで構成されるメニュー セクションを含めることができます アドオンとして追加することもできます

次の例は、AddOnMenuItem を示しています。

例 1

{
  "@type": "AddOnMenuSection",
  "@id": "https://www.example.com/1089/addon/1",
  "name": "AddOnCheese",
  "hasMenuItem": [
    {
      "@type": "AddOnMenuItem",
      "@id": "https://www.example.com/1089/addon/a",
      "name": "Swiss",
      "offers": {
        "@type": "Offer",
        "sku": "offer-swiss",
        "price": "2.99",
        "priceCurrency": "USD"
      }
    },
    {
      "@type": "AddOnMenuItem",
      "@id": "https://www.example.com/1089/addon/b",
      "name": "Mozarella",
      "offers": {
        "@type": "Offer",
        "sku": "offer-mozzarella",
        "price": "1.99",
        "priceCurrency": "USD"
      }
    }
  ]
}

例 2

{
  "@type": "MenuItem",
  "@id": "https://www.example.com/1089/product/170067",
  "name": "Pepperoni Pizza",
  "hasMenuItemOptions": [
    {
      "@type": "MenuItemOption",
      "value": {
        "@type": "PropertyValue",
        "name": "SIZE",
        "value": "Small"
      },
      "offers": {
        "@type": "Offer",
        "sku": "offer-small-pepperoni-pizza",
        "price": "10.00",
        "priceCurrency": "USD"
      }
    },
    {
      "@type": "MenuItemOption",
      "value": {
        "@type": "PropertyValue",
        "name": "SIZE",
        "value": "Large"
      },
      "offers": {
        "@type": "Offer",
        "sku": "offer-large-pepperoni-pizza",
        "price": "20.00",
        "priceCurrency": "USD"
      }
    }
  ],
  "menuAddOn": [
    {
      "@type": "AddOnMenuSection",
      "name": "Choice of toppings",
      "@id": "https://www.example.com/1089/addon/1",
      "hasMenuItem": [
        {
          "@type": "AddOnMenuItem",
          "@id": "https://www.example.com/1089/addon/1/a",
          "name": "Shrimp",
          "hasMenuItemOptions": [
            {
              "@type": "MenuItemOption",
              "value": [
                {
                  "@type": "PropertyValue",
                  "name": "PIZZA_SIDE",
                  "value": "PIZZA_SIDE_LEFT" // Values are predefined for pizza side.
                },
                {
                  "@type": "PropertyValue",
                  "name": "APPLICABLE_ITEM_OPTION",
                  "value": "Small" // Value should be same as mentioned in item's options.
                }
              ],
              "offers": {
                "@type": "Offer",
                "sku": "offer-topping-shrimp-left-small",
                "price": "1.00",
                "priceCurrency": "USD"
              }
            },
            {
              "@type": "MenuItemOption",
              "value": [
                {
                  "@type": "PropertyValue",
                  "name": "PIZZA_SIDE",
                  "value": "PIZZA_SIDE_LEFT" // Values are predefined for pizza side.
                },
                {
                  "@type": "PropertyValue",
                  "name": "APPLICABLE_ITEM_OPTION",
                  "value": "Large" // Value should be same as mentioned in item's options.
                }
              ],

              "offers": {
                "@type": "Offer",
                "sku": "offer-topping-shrimp-left-large",
                "price": "2.00",
                "priceCurrency": "USD"
              }
            },
            {
              "@type": "MenuItemOption",
              "value": [
                {
                  "@type": "PropertyValue",
                  "name": "PIZZA_SIDE",
                  "value": "PIZZA_SIDE_WHOLE" // Values are predefined for pizza side.
                },
                {
                  "@type": "PropertyValue",
                  "name": "APPLICABLE_ITEM_OPTION",
                  "value": "Small" // Value should be same as mentioned in item's options.
                }
              ],

              "offers": {
                "@type": "Offer",
                "sku": "offer-topping-shrimp-whole-small",
                "price": "1.50",
                "priceCurrency": "USD"
              }
            },
            {
              "@type": "MenuItemOption",
              "value": [
                {
                  "@type": "PropertyValue",
                  "name": "PIZZA_SIDE",
                  "value": "PIZZA_SIDE_WHOLE" // Values are predefined for pizza side.
                },
                {
                  "@type": "PropertyValue",
                  "name": "APPLICABLE_ITEM_OPTION",
                  "value": "Large" // Value should be same as mentioned in item's options.
                }
              ],

              "offers": {
                "@type": "Offer",
                "sku": "offer-topping-shrimp-whole-large",
                "price": "2.50",
                "priceCurrency": "USD"
              }
            }
          ]
        }
      ]
    }
  ]
}

AddOnMenuSection

追加のメニュー セクションとしての食品または飲料品のサブグループ 選択します。

次の表に、AddOnMenuSection タイプのプロパティを示します。

プロパティ タイプ 必要性 説明
@type テキスト 必須 これは常に「AddOnMenuSection」です。
@id URL 必須 メニュー セクションの一意の識別子。
name テキスト 必須 ユーザーがブラウジング中に AddOnMenuSection を識別できるテキスト 選択します。
description テキスト 省略可 メニュー セクションの説明。
eligibleQuantity QuantitativeValue 省略可 このメニューのアドオンとして許可されるアイテムの数を示します 。このフィールドを使用して、 ピザのトッピングの最小数と最大数。
image URL 省略可 メニュー セクションの画像。
hasMenuItem AddOnMenuItem の配列 必須* AddOnMenuSection に含まれるアドオン メニュー項目。
offers Offer の配列 省略可

Offer.availabilityStarts と 期間を示す Offer.availabilityEnds この AddOnMenuSection を使用できるようになります。

以下のリストは、どの Offer プロパティが 使用されます。

  • Offer.availabilityStarts(省略可)
  • Offer.availabilityEnds(省略可)
  • Offer.availableDay(省略可)
  • Offer.validFrom(省略可)
  • Offer.validThrough(省略可)
hasMenuSection AddOnMenuSection の配列 必須* アドオン メニューの論理的なサブグループ(ディナー、アペタイザー、アペタイザーなど) 魚料理など)。
defaultOption AddOnMenuItem の配列 省略可

のユーザーに対してデフォルトで事前選択されるアドオン メニュー項目 AddOnMenuSection。ユーザーは最終的な選択を変更できます。条件 defaultOption の指定なし、指定なし AddOnMenuItem はあらかじめ選択されています。

AddOnMenuItem オブジェクトは、 AddOnMenuSectionhasMenuItem

defaultOption の数は最大数以下にしてください AddOnMenuSectioneligibleQuantity

numberOfFreeAddOns 数値 省略可 ユーザーが無料で選択できるアドオンの数を示します。

次の例では、AddOnMenuSection オブジェクトを使用しています。

例 1

{
  "@type": "AddOnMenuSection",
  "@id": "https://www.example.com/1089/addon/1",
  "name": "AddOnCheese",
  "hasMenuItem": [
    {
      "@type": "AddOnMenuItem",
      "@id": "https://www.example.com/1089/addon/a",
      "name": "Swiss",
      "offers": {
        "@type": "Offer",
        "sku": "offer-swiss",
        "price": "2.99",
        "priceCurrency": "USD"
      }
    },
    {
      "@type": "AddOnMenuItem",
      "@id": "https://www.example.com/1089/addon/b",
      "name": "Mozarella",
      "offers": {
        "@type": "Offer",
        "sku": "offer-mozzarella",
        "price": "1.99",
        "priceCurrency": "USD"
      }
    }
  ]
}

例 2

"menuAddOn": {
  "@type": "AddOnMenuSection",
  "name": "Cheese",
  "@id": "https://www.example.com/1089/addon/1", // Points to an AddOnMenuSection
  "eligibleQuantity":
    "@type": "QuantitativeValue",
    "minValue": 0,
    "maxValue": 2 // Maximum of 2 cheeses are allowed
  }
}

例 3

「チーズ サンドイッチ」メニュー項目に「チーズの選択」が含まれている 「Swiss」を含む AddOnMenuSection「モッツァレラ」選択済み 設定されます。

{
  "@type": "AddOnMenuSection",
  "@id": "https://www.example.com/1089/addon/1",
  "name": "AddOnCheese",
  "defaultOption": [
    {
      "@type": "AddOnMenuItem",
      "@id": "https://www.example.com/1089/addon/a"
    },
    {
      "@type": "AddOnMenuItem",
      "@id": "https://www.example.com/1089/addon/b"
    }
  ],
  "hasMenuItem": [
    {
      "@type": "AddOnMenuItem",
      "@id": "https://www.example.com/1089/addon/a",
      "name": "Swiss",
      "offers": {
        "@type": "Offer",
        "sku": "offer-swiss",
        "price": "2.99",
        "priceCurrency": "USD"
      }
    },
    {
      "@type": "AddOnMenuItem",
      "@id": "https://www.example.com/1089/addon/b",
      "name": "Mozzarella",
      "offers": {
        "@type": "Offer",
        "sku": "offer-mozzarella",
        "price": "1.99",
        "priceCurrency": "USD"
      }
    }
  ]
}

AdvanceServiceDeliveryHoursSpecification

ユーザーが事前注文をスケジュールするフルフィルメント時間を表します。 デリバリーとテイクアウトに対応しました

通常、opens の値は closes の値よりも小さくなります。「 opens プロパティと closes プロパティを使用する場合は、次のガイドラインが適用されます。

  • opens プロパティと closes プロパティは、 AdvanceServiceDeliveryHoursSpecification になりますが、 できます。
  • 時刻はサービスの現地時間で指定する必要があります。コメントに opens または closes 値。指定したタイムゾーンは無視されます。
  • openscloses が明示的に指定されていない場合、 いつでも注文できます。
  • openscloses が同じ場合、事前注文は次のようになります。 できません。
  • openscloses より大きい場合、終了時刻は「当日配達」と解釈されます 翌日配達します。たとえば、開始時間が 1 月 1 日(太平洋時間)に設定されていて、 レストランが午後 5 時で閉店時間が午前 2 時である場合、レストランは閉業と解釈されます 1 月 2 日午前 2 時です。
  • openscloses は将来の時間枠を表します。closes は排他的です。対象 serviceTimeInterval を指定して、opens が午前 10 時、closes が午後 4 時の場合 15 分に設定すると、最初の時間枠は午前 10 時に始まり、 開始時刻は午後 3 時 45 分です。

次の表に、 AdvanceServiceDeliveryHoursSpecification 型:

プロパティ タイプ 必要性 説明
@type テキスト 必須 常に「AdvanceServiceDeliveryHoursSpecification」です。
validFrom DateTime 条件文

開始日は事前注文は 処理されます。例: 2017-05-01T00:00:00-07:00

このプロパティが設定されていない場合は、毎日有効と見なされます。 validFrom プロパティと validThrough プロパティは、 欠席したり、一緒に出席したりします。

このタイプが specialOpeningHoursSpecificationService) この validFrom プロパティは、 AdvanceServiceDeliveryHoursSpecification は必須です。

詳細については、次をご覧ください: <ph type="x-smartling-placeholder"></ph> 日時形式をご覧ください。

validThrough DateTime 省略可

その日より後にユーザーが事前注文は 処理されます。例: 2018-12-01T00:00:00-07:00

このプロパティが設定されていない場合は、毎日有効と見なされます。 validFrom プロパティと validThrough プロパティは、 欠席したり、一緒に出席したりします。

このタイプが specialOpeningHoursSpecificationService) 場合、validThrough プロパティは、 AdvanceServiceDeliveryHoursSpecification は必須です。

validThrough の時刻は指定できません。たとえば 時刻が午後 6 時に設定されている場合、時刻は午後 5 時 59 分 59 秒まで有効です。

詳細については、次をご覧ください: 日時形式

opens Time 省略可

宅配またはテイクアウトのスロットに適用されます。

ユーザーが指定した日時から開始日時を事前注文は 処理されます。たとえば、午前 6 時 30 分は「T06:30:00」となります。

時刻は、サービスの現地時間で指定する必要があります。コメントに opens 値。タイムゾーンを指定すると、 Google はこの情報を無視します。

詳細については、次をご覧ください: 日時形式

closes Time 省略可

宅配またはテイクアウトのスロットに適用されます。

その次の日付以降にユーザーが事前注文は不可 処理されます。たとえば、午後 9 時は「T21:00:00」となります。 closes> は排他的であるため、9:00 PM に設定すると、 serviceTimeInterval が 15 分の場合、 予約可能な時間帯は午後 8 時 45 分から始まります。

時刻は、サービスの現地時間で指定する必要があります。禁止事項 closes 値にタイムゾーンを含める。タイムゾーンが Google では無視されます。

詳細については、次をご覧ください: 日時形式

dayOfWeek DayOfWeek の配列 省略可

事前配送が可能な曜日。有効 次のとおりです。

  • 「月曜日」
  • 「火曜日」
  • 「水曜日」
  • 「木曜日」
  • 「金曜日」
  • 「土曜日」
  • "日曜日"

曜日を指定しない場合、 AdvanceServiceDeliveryHoursSpecification はすべてに適用されます 日

serviceTimeInterval Duration 必須

連続する 2 つの運行時間の間隔。

例: openscloses が午前 8 時で、 午後 8 時、serviceTimeInterval が 15 分の場合、 納品時間は、午前 8 時、午前 8 時 15 分、午前 8 時 30 分、午前 8 時 45 分、 午後 8 時まで繰り返します

Duration は ISO 8601 の期間として指定する必要があります。対象 例: "P15M" は 15 分間隔を意味します。

advanceBookingRequirement QuantitativeValue 必須

注文時刻からの事前注文が可能な分数 処理されます。

QuantitativeValueminmax の値は、分数と unitCode を「MIN」に設定します。

たとえば事前注文で 60 分以上かかる場合は かつ、2 日間を超えては実行できない その後、min 値は 60、max は 2880 になります。

次の例は、BigQuery の AdvanceServiceDeliveryHoursSpecification タイプ:

例 1

{
  "@type": "AdvanceServiceDeliveryHoursSpecification",
  "opens": "T10:00:00",  // Delivery between 10AM and 7:59:59PM
  "closes": "T20:00:00",
  "serviceTimeInterval": "PT15M", // in slots spaced 15 minutes apart (ISO8601)
  "advanceBookingRequirement": {
    "minValue": 60,   // The slot should be at least 60 mins away
    "maxValue": 8640, // but not more than 6 days away
    "unitCode": "MIN"
  }
}

AllergenDetails

このタイプを使用するには、gs1 コンテキストを追加します。 "@context": ["http://gs1.org/voc/", "http://schema.org"]

次に、適切な MenuItem のタイプに FoodBeverageTobaccoProduct を追加します。 または MenuItemOption

次の表に、AllergenDetails 型のプロパティを示します。

プロパティ タイプ 必要性 説明
@type テキスト 必須 常に「AllergenDetails」です。
allergenType テキスト 省略可 アレルゲンの種類 gs1:AllergenTypeCode 。(例: http://gs1.org/voc/AllergenTypeCode-PEANUTS)。
allergenLevelOfContainmentCode テキスト 省略可 封じ込めコード gs1:LevelOfContainmentCode: 例: http://gs1.org/voc/LevelOfContainmentCode-CONTAINS http://gs1.org/voc/LevelOfContainmentCode-FREE_FROM または http://gs1.org/voc/LevelOfContainmentCode-MAY_CONTAIN

次の例は、AllergenDetails タイプの使用方法を示しています。

{
  "@type": ["MenuItem", "FoodBeverageTobaccoProduct"],
  "@id": "http://www.example.com/bar/menuitem/6",
  "name": "Strawberry joghurt drink",
  "description": "A 0.5l bottle of strawberry joghurt drink.",
  "offers": {
    "@type": "Offer",
    "sku": "offer-joghurt-drink",
    "price": "2.49",
    "priceCurrency": "USD"
  },
  "hasAllergen": [
    {
      "@type": "AllergenDetails",
      "allergenType": "http://gs1.org/voc/AllergenTypeCode-GLUTEN",
      "allergenLevelOfContainmentCode":
        "http://gs1.org/voc/LevelOfContainmentCode-FREE_FROM"
    },
    {
      "@type": "AllergenDetails",
      "allergenType": "http://gs1.org/voc/AllergenTypeCode-LACTOSE",
      "allergenLevelOfContainmentCode":
        "http://gs1.org/voc/LevelOfContainmentCode-CONTAINS"
    }
  ]
},

DeliveryChargeSpecification

次の表に、 DeliveryChargeSpecification 型:

プロパティ タイプ 必要性 説明
@type テキスト 必須 常に「DeliveryChargeSpecification」です。
@id URL 省略可 配送料の仕様の ID。
price 数値 必須 送料の合計を数値のみで指定します。こちらの 通貨の種類を示す priceCurrency プロパティ 使用します。例: 通貨なしの「6.00」 記号で示されます。
priceCurrency テキスト 必須 3 文字の ISO 4217 通貨コード。例: 「USD」
eligibleTransactionVolume PriceSpecification 省略可 この配送が行われた取引量(金額単位) 料金の仕様が無効です。たとえば、最低購入金額を示すには、 送料が発生しないことを伝える 特定の注文数を超える場合
eligibleQuantity QuantitativeValue 省略可 注文数の測定間隔と単位は、 配送料が有効である。たとえば、 特定の貨物手数料は、特定の数量に対してのみ有効です。
eligibleRegion GeoShape または配列 Place または GeoCircle 省略可 場所、または地政学的な地域の GeoShape/GeoCircle 。使用する 地域によって配送料が異なる場合にのみ、料金は発生しません。
validFrom DateTime 省略可 配送料が請求される日時(タイムゾーンを含む) 有効になります。例: 2017-05-01T06:30:00-07:00対象 詳細については、以下をご覧ください。 日時形式
validThrough DateTime 省略可 配信期間の終了日時(タイムゾーンを含む) 指定した料金が無効です。例: 2017-05-01T06:30:00-07:00 validThrough の時間は含まれません。たとえば、 時刻が午後 6 時に設定されている場合、時刻は午後 5 時 59 分 59 秒まで有効です。 詳細については、次をご覧ください: 日時形式

次の例は、DeliveryChargeSpecification 要素を示しています。

例 1

"offers": {
  "@type":"Offer",
  "priceSpecification":[
    {
      "@type": "DeliveryChargeSpecification",
      "price": "5.0",
      "priceCurrency": "USD"
    }
  ]
}

例 2

"priceSpecification": [
  {
    "@type": "DeliveryChargeSpecification",
    "@id": "http://www.provider.com/defaultdeliveryfee/foo",
    "price": "10.0",
    "priceCurrency": "USD",
    "eligibleQuantity": {
      "@type": "QuantitativeValue",
      "minValue": 3  // Minimum of 3 items required for delivery
    }
  },
  {
    "@type": "DeliveryChargeSpecification",
    "@id": "http://www.provider.com/deliveryfee/foo/1",
    "price": "20.0",
    "priceCurrency": "USD",
    "validFrom":"T18:00:00", // Valid from 6:00PM
    "validThrough":"T22:00:00", // Valid to 9:59:59PM
    "eligibleQuantity": {
      "@type": "QuantitativeValue",
      "minValue": 3  // Minimum of 3 items required for delivery
    }
  }
]

例 3

"priceSpecification": [{
    "@type": "DeliveryChargeSpecification",
    "@id": "http://www.provider.com/threebrotherstacos/deliveryfee/1",
    "price": "8.00", // Charges $8 for area5
    "priceCurrency": "USD",
    "eligibleTransactionVolume": {
      "@type": "PriceSpecification",
      "minPrice": "20.00",
      "priceCurrency": "USD"
    },
    "eligibleRegion": [ // area5
      {
        "@type": "GeoCircle",
        "geoMidpoint": {
          "@type": "GeoCoordinates",
          "latitude": "37.7392607",
          "longitude": "-122.3895522"
        },
        "geoRadius": "4505"
      }
    ]
  },
  {
    "@type": "DeliveryChargeSpecification",
    "@id": "http://www.provider.com/threebrotherstacos/defaultdeliveryfee",
    "price": "6.00", // Charges $6 when delivered from Foo restaurant to area1, area2, area3 and area4 (Default charge)
    "priceCurrency": "USD",
    "eligibleTransactionVolume": {
      "@type": "PriceSpecification",
      "minPrice": "20.00", // Minimum order price for delivery is $20
      "priceCurrency": "USD"
    }
  }
]

このオブジェクトは、"@type": ["DeliveryChargeSpecification"] だけでなく、 UnitPriceSpecification:

"@type": ["DeliveryChargeSpecification", "UnitPriceSpecification"]

この拡張機能では、配送料に必要なプロパティが 2 つ追加されています。 パーセンテージで計算されます。

プロパティ タイプ 必要性 説明
referenceQuantity QuantitativeValue 必須 特定の料金が適用される参照数量。たとえば 値 10 の referenceQuantityunitCode 「P1」注文額の 10% となります「P1」は unitCode のみ 現時点ではまだサポートされていません
basePrice 数値 省略可 referenceQuantity に上乗せされる基本料金。対象 例: unitCodereferenceQuantity / 10 「P1」$5 の basePrice は、$5 + 10% の金額になります 設定します。デフォルト値は 0 です。

配送料の例

Google では、ユーザーに対しさまざまな料金を事前に指定することができます。 Service エンティティの Offer.PriceSpecification

なお、エンドツーエンドの注文で現在サポートされているのは 1 つのみ DeliveryChargeSpecification。すべてのタイプの料金を 1 つにまとめる DeliveryChargeSpecification

配送の指定方法については、サービス フィードの例をご覧ください。 面積、距離、注文額に基づいた料金。

料金がない場合、Offer.PriceSpecification は省略されます。

  • 例 1: 配送料がカートの小計の 5% の場合
  • 例 2: 配送料が 5 ドルの場合
  • 例 3: 配送料: 5 ドル + カート小計の 10%
  • 例 4: 配送料が 5 ドル、手荷物料金が 0.1 ドルの場合
  • 例 5: 配送料が 5% で、手数料がカート小計の 2% の場合
  • 例 6: 配送料は 5 ドルで、追加 1 km の距離ごとに 1 ドル

例 1

priceSpecification [
  {
    "@type": ["DeliveryChargeSpecification", "UnitPriceSpecification"],
    "referenceQuantity": {
      "@type": "QuantitativeValue",
      "value": "5.00", // 5%
      "unitCode": "P1" // P1 == %
    },
    "priceCurrency": "USD"
  }
]

例 2

priceSpecification [
  {
    "@type": ["DeliveryChargeSpecification"],
    "priceCurrency": "USD",
    "price": "5.00"
  }
]

例 3

priceSpecification [
  {
    "@type": ["DeliveryChargeSpecification", "UnitPriceSpecification"],
    "referenceQuantity": {
      "@type": "QuantitativeValue",
      "value": "10.00", // 10%
      "unitCode": "P1", // P1 == %
    },
    "priceCurrency": "USD",
    "basePrice": "5.00" // User always pays $5 in addition to 10%
  }
]

例 4

priceSpecification [
  {
    "@type": ["DeliveryChargeSpecification"],
    "priceCurrency": "USD",
    "price": "5.10" //$5 + $0.1
  }

例 5

priceSpecification [
  {
    "@type": ["DeliveryChargeSpecification", "UnitPriceSpecification"],
    "referenceQuantity": {
      "@type": "QuantitativeValue",
      "value": "7.00", // 5% + 2%
      "unitCode": "P1" // P1 == %
    },
    "priceCurrency": "USD"
  },
]

例 6

priceSpecification [
  {
    "@type": ["DeliveryChargeSpecification", "UnitPriceSpecification"],
    "basePrice": 5.00, // User always pays $5
    "price": 1.00, // An additional $1.00 is added per 1km
    "priceCurrency": "USD",
    "referenceQuantity": {
      "@type": "QuantitativeValue",
      "unitCode": "MTR", // MTR == meter
      "value": "1000.0" // 1km
    }
  }
]

GeoCircle

次の表に、GeoCircle 型のプロパティを示します。

プロパティ タイプ 必要性 説明
@type テキスト 必須 常に「GeoCircle」です。
geoMidpoint GeoCoordinates 必須 画面中央の GeoCoordinates を示します。 GeoCircle
geoRadius 数値 必須 対象物のおおよその半径(メートル単位)を GeoCircle

次の例は、GeoCircle 要素を示しています。

{
  "@type": "GeoCircle",
  "geoMidpoint": {
    "@type": "GeoCoordinates",
    "latitude": "37.7392607",
    "longitude": "-122.3895522"
  },
  "geoRadius": "4505"
}

GeoCoordinates

次の表に、GeoCoordinates 型のプロパティを示します。

プロパティ タイプ 必要性 説明
@type テキスト 必須 これは常に「Geo 座標」です。
latitude 数値 必須

緯度。値は -90 ~ 90 の範囲に制限されます。 含まれます。指定された値が -90 未満の場合は、-90 に設定されます。 値が 90 より大きい場合は 90 に設定されます

精度は小数点 5 桁以上にする必要があります。

longitude 数値 必須

経度。-180 ~ 180 の範囲外の値は、 範囲内になるようにラップします。たとえば、値が -190 の場合、 170 に変換されます値 190 は -170 に変換されます。この 経度は地球を包むという事実を反映しています。

精度は小数点 5 桁以上にする必要があります。

次の例は、GeoCoordinates 要素を示しています。

"geo": {
  "@type": "GeoCoordinates",
  "latitude": "35.7392607",
  "longitude": "-120.3895522"
}

GeoShape

次の表に、GeoShape 型のプロパティを示します。

プロパティ タイプ 必要性 説明
@type テキスト 必須 これは常に「GeoShape」です。
polygon テキストの配列 必須

3 つ以上のスペースの連続として表現されるポリゴンまたはマルチポリゴン あります。最初と最後のポイントは、 同じですが、必須ではありません。

ポリゴンまたはマルチポリゴンの各ポイントは緯度ポイントによって定義されます。 その後に経度が続きますまた、 時計回りに回転します

ほとんどの場合、ポリゴンは 1 つです。より複雑な使い方を 詳しくは、 サービス提供地域に関するドキュメントをご覧ください。

次の例は、GeoShape 要素を示しています。

例 1

{
  "@type": "GeoShape", // area4
  // Specify latitude first (i.e., lat long lat long ...)
  "polygon": "37.806000 -122.425592 37.775849 -122.419043 37.795547 -122.394046 37.808747 -122.412619"
},

例 2

{
  "@type": "GeoShape", // A service area with a hole.
  // Specify latitude first (i.e., lat long lat long ...)
  "polygon": [ “37.771535 -122.506881 37.764289 -122.506669 37.766497 -122.453058”,
               “37.791707 -122.447987 37.746676 -122.449433 37.736150 -122.505944 37.780924 -122.509729”]
},

例 3

{
  "@type": "Service",
  "@id": "http://www.provider.com/service/1",
  "areaServed": [
    {
      "@type": "GeoShape",  // Richmond District delivery area.
      // Specify latitude first (i.e., lat long lat long ...)
      "polygon": "37.785847 -122.484851 37.772757 -122.483983 37.774442 -122.458563 37.786876 -122.459474"
    },
    {
      "@type": "GeoShape",  // Haight-Ashbury delivery area.
      // Specify latitude first (i.e., lat long lat long ...)
      "polygon": "37.774804 -122.454774 37.766224 -122.452881 37.769087 -122.436043 37.773087 -122.437417"
    }  ],
...
},

次の表に、Menu タイプのプロパティを示します。

プロパティ タイプ 必要性 説明
@type テキスト 必須 これは常に「メニュー」です。
@id URL 必須 メニューの一意の識別子。
name テキスト 省略可 ユーザーがブラウジング中に Menu を識別できるテキスト 選択します。
description テキスト 省略可 メニューの説明。
disclaimer MenuDisclaimer 省略可 メニューの免責事項。例: 栄養情報の開示 アレルゲンの開示
hasMenuSection MenuSection の単一のオブジェクトまたは配列 省略可 メニューの論理的なサブグループ(ディナー、前菜、魚料理など) あります。
hasMenuItem MenuItem の単一のオブジェクトまたは配列 省略可 Menu に含まれる MenuItem オブジェクト 通常は、MenuMenuSections
inLanguage テキスト 省略可 メニュー コンテンツの言語。 IETF BCP 47 規格。 例: 「en-US」

次の例は、Menu タイプの使用方法を示しています。

例 1

{
  "@type": "Menu",
  "@id": "http://www.provider.com/somerestaurant/menu/1",
  "hasMenuSection": {
    "@type": "MenuSection",
    "@id": "http://www.provider.com/somerestaurant/menusection/1",
    "name": "Tacos",
    "description": "Tacos inspired by India cuisine.",
    "offers": {
      "@type": "Offer",
      "availabilityStarts": "T08:00:00", // Starts at 8:00AM
      "availabilityEnds": "T22:00:00" // Ends at 10:00PM. Available 8AM-9:59:59PM
    },
    "hasMenuItem": {
      "@type": "MenuItem",
      "@id": "http://www.provider.com/somerestaurant/menuitem/1",
      "name": "Aloo Gobi Taco",
      "description": "Mexico City-style street corn tortilla taco filled with a flavorful mixture of mildly south Indian spiced cauliflower, potato, tomato, onions and bell peppers.",
      "offers": {
        "@type": "Offer",
        "sku": "offer-aloo-gobi-taco",
        "price": "3.50",
        "priceCurrency": "USD"
      },
      "nutrition": {
        "@type": "NutritionInformation",
        "calories": "170 Cal",
        "fatContent": "3 g",
        "fiberContent": "2 g",
        "proteinContent": "4 g"
      },
      "suitableForDiet": "http://schema.org/GlutenFreeDiet"
    }
  },
  "inLanguage": "English"
}

例 2

この例では、hasMenuItem を配列として示しています。

{
  "@type": "Menu",
  "@id": "http://www.provider.com/somerestaurant/menu/1",
  "name": "Dine-In Menu",
  "description": "Menu for in-restaurant dining only.",
  "hasMenuSection": [
    {
      "@type": "MenuSection",
      "@id": "http://www.provider.com/somerestaurant/menusection/1",
      "name": "Main",
      "description": "Main course",
      "image": "http://www.provider.com/somerestaurant/main_dishes.jpg",
      "hasMenuItem": [
        {
          "@type": "MenuItem",
          "@id": "http://www.provider.com/somerestaurant/menuitem/1",
          "name": "Pizza",
          "description": "Pizza",
          "offers": {
            "@type": "Offer",
            "sku": "offer-pizza",
            "price": "7.49",
            "priceCurrency": "USD",
            "availabilityStarts": "T08:00:00", // Starts at 8:00AM
            "availabilityEnds": "T18:00:00" // Ends at 6:00PM, last order at 5:59:59PM
          }
        },
        {
          "@type": "MenuItem",
          "@id": "http://www.provider.com/somerestaurant/menuitem/2",
          "name": "Pasta",
          "description": "Pasta",
          "offers": [
            {
              "@type": "Offer",
              "sku": "offer-pasta-lunch",
              "price": "7.49",
              "priceCurrency": "USD",
              "availabilityStarts": "T08:00:00", // Starts at 8:00AM
              "availabilityEnds": "T18:00:00" // Ends at 6:00PM, last order at 5:59:59PM
            },
            {
              "@type": "Offer",
              "sku": "offer-pasta-dinner",
              "price": "10.49",
              "priceCurrency": "USD",
              "availabilityStarts": "T18:00:00", // Starts at 6:00PM
              "availabilityEnds": "T21:00:00" // Ends at 9:00PM, last order at 8:59:59PM
            }
          ]
        }
      ]
    },
    {
      "@type": "MenuSection",
      "@id": "http://www.provider.com/somerestaurant/menusection/2",
      "name": "Soups & Salads",
      "description": "Salads and a few choices of soup",
      "image": "https://www.provider.com/somerestaurant/soup_and_salad_dishes.jpg",
      "hasMenuItem": {
        "@type": "MenuItem",
        "@id": "http://www.provider.com/somerestaurant/menuitem/3",
        "name": "Pea Soup",
        "description": "Creamy pea soup topped with melted cheese and sourdough croutons.",
        "offers": {
          "@type": "Offer",
          "sku": "offer-pea-soup",
          "price": "3.49",
          "priceCurrency": "USD"
        },
        "suitableForDiet": "http://schema.org/GlutenFreeDiet"
      }
    }
  ]
}

例 3

この例では、hasMenuSection を配列として示しています。

{
  "@type": "Menu",
  "@id": "http://www.provider.com/somerestaurant/menu/1",
  "name": "Dine-In Menu",
  "description": "Menu for in-restaurant dining only.",
  "hasMenuSection": [
    {
      "@type": "MenuSection",
      "@id": "http://www.provider.com/somerestaurant/menusection/1",
      "name": "Dinner",
      "description": "Dinner dishes",
      "hasMenuSection": [
        {
          "@type": "MenuSection",
          "@id": "http://www.provider.com/somerestaurant/menusection/2",
          "name": "Starters",
          "description": "Appetizers and such",
          "image": "https://www.provider.com/somerestaurant/starter_dishes.jpg",
          "hasMenuItem": {
            "@type": "MenuItem",
            "@id": "http://www.provider.com/somerestaurant/menuitem/1",
            "name": "Potato Skins",
            "description": "Small serving of stuffed potato skins.",
            "offers": {
              "@type": "Offer",
              "sku": "offer-potato-skins",
              "price": "7.49",
              "priceCurrency": "USD"
            },
            "suitableForDiet": "http://schema.org/GlutenFreeDiet"
          }
        },
        {
          "@type": "MenuSection",
          "@id": "http://www.provider.com/somerestaurant/menusection/3",
          "name": "Soups & Salads",
          "description": "Salads and a few choices of soup",
          "image": "https://thisisarestaurant.com/soup_and_salad_dishes.jpg",
          "hasMenuItem": {
            "@type": "MenuItem",
            "@id": "http://www.provider.com/somerestaurant/menuitem/2",
            "name": "Pea Soup",
            "description": "Creamy pea soup topped with melted cheese and sourdough croutons.",
            "offers": {
              "@type": "Offer",
              "sku": "offer-pea-soup",
              "price": "3.49",
              "priceCurrency": "USD"
            },
            "suitableForDiet": "http://schema.org/GlutenFreeDiet"
          }
        },
        {
          "@type": "MenuSection",
          "@id": "http://www.provider.com/somerestaurant/menusection/4",
          "name": "Steak",
          "description": "Steak Dishes",
          "image": "https://steak.com/steak_dishes.jpg",
          "hasMenuItem": {
            "@type": "MenuItem",
            "@id": "http://www.provider.com/somerestaurant/menuitem/3",
            "name": "Sirloin",
            "description": "Sirloin steak dish.",
            "offers": {
              "@type": "Offer",
              "sku": "offer-sirloin-steak",
              "price": "15.49",
              "priceCurrency": "USD"
            },
            "suitableForDiet": "http://schema.org/GlutenFreeDiet"
          }
        }
      ]
    },
    {
      "@type": "MenuSection",
      "@id": "http://www.provider.com/somerestaurant/menusection/5",
      "name": "Desserts",
      "description": "Dessert dishes.",
      "image": "http://www.provider.com/somerestaurant/dessert_dishes.jpg",
      "hasMenuItem": {
        "@type": "MenuItem",
        "@id": "http://www.provider.com/somerestaurant/menuitem/4",
        "name": "Chocolate Pie",
        "description": "A slice of chocolate pie.",
        "offers": {
          "@type": "Offer",
          "sku": "offer-chocolate-pie",
          "price": "3.49",
          "priceCurrency": "USD"
        }
      }
    }
  ]
}

Menu エンティティのその他の例については、以下をご覧ください。 レストランおよびメニュー フィードの例

次の表に、MenuDisclaimer タイプのプロパティを示します。

プロパティ タイプ 必要性 説明
@type テキスト 必須 これは常に「MenuDisclaimer」です。
@id URL 必須 メニューの免責条項の一意の識別子。
text テキスト 必須 免責条項のテキスト。例: 「成人の 1 日の平均エネルギー 8700 kJ」と記載されています。
url URL 省略可 免責条項の詳細を説明するページの URL。

次の例は、MenuDisclaimer タイプの使用方法を示しています。

{
    "@type": "Menu",
    "@id": "menu_1",
    "disclaimer": {
        "@type": "MenuDisclaimer",
        "@id": "menu_1_disclaimer_1",
        "text": "The average adult daily energy intake is 8700 kJ",
        "url": "https://partner.domain.com/menu/provider/disclaimer/more-info.html"
    }
}

メニューの項目を表すメニュー項目。次の表に、 MenuItem 型のプロパティを次のように作成します。

プロパティ タイプ 必要性 説明
@type テキスト 必須 これは常に「MenuItem」です。
@id URL 必須 メニュー項目の一意の識別子。
name テキスト 必須 ユーザーがブラウジングしているときに MenuItem を識別できるテキスト アクセスできます。
description テキスト 省略可 メニュー項目の説明。
image URL 省略可

メニュー項目の画像。画像に関する次のガイドラインを使用してください。

  • アスペクト比 3:2
  • 最小解像度 600 x 400 ピクセル、72 dpi
  • 推奨解像度 1400 x 960 ピクセル 72 dpi
menuAddOn AddOnMenuSection の配列 省略可 アドオンとして追加できるメニュー セクションの項目。 選択します。
offers Offer の配列 必須*

この MenuItem を提供する 1 つ以上のオファー。いつ、どのように説明するか このMenuItemの販売価格を手に入れることができます特典は 1 つのみにしてください 有効にする必要があります。複数のオファーを提供できます 時間帯によって料金/空室状況に変動がある。もし 基本属性(たとえばサイズ: ピザなど)、menuItemOption を使用します。デフォルトの Offer.eligibleQuantity は 0 以上で、上限はありません できます。

以下のリストは、どの Offer プロパティが MenuItem で使用。

  • Offer.skuが必要です
  • Offer.priceが必要です
  • Offer.priceCurrencyが必要です
  • Offer.availabilityStarts(省略可)
  • Offer.availabilityEnds(省略可)
  • Offer.availableDay(省略可)
  • Offer.validFrom(省略可)
  • Offer.validThrough(省略可)
  • Offer.eligibleQuantity(省略可)
  • Offer.inventoryLevel(省略可)
hasMenuItemOptions MenuItemOption の配列 必須 このメニュー項目の基本オプション/バリエーションのリスト。オプションは 商品に利用できるさまざまな基本バリエーションを指定します。 小、中、大の 3 つのタイプがあります。
suitableForDiet RestrictedDiet の配列 省略可 料理が所定の食事制限( &quot;http://schema.org/GlutenFreeDiet&quot;"http://schema.org/VeganDiet"この 有効な値の列挙リストです。
nutrition NutritionInformation 省略可 その料理の栄養情報、特にカロリーの情報。
hasAllergen AllergenDetails 省略可 gs1:AllergenDetails ごとの料理のアレルゲン。 このプロパティを使用するには、gs1 コンテキストを追加します: "@context": ["http://gs1.org/voc/", "http://schema.org"]。 そして、変数の型に FoodBeverageTobaccoProduct を追加します。 MenuItem
additive AdditiveDetails の配列 省略可 gs1:AdditiveDetails ごとの料理の添加物。 有効な値の列挙リストです。gs1 コンテキストを追加して使用する このプロパティ: "@context": ["http://gs1.org/voc/", "http://schema.org"] そして、変数の型に FoodBeverageTobaccoProduct を追加します。 MenuItem
packaging PackagingDetails 省略可 この MenuItem の梱包とリサイクルに関する情報は、 gs1:PackagingDetails。 このプロパティを使用するには、gs1 コンテキストを追加します: "@context": ["http://gs1.org/voc/", "http://schema.org"]。 そして、変数の型に FoodBeverageTobaccoProduct を追加します。 MenuItem

次の例は、MenuItem 要素を示しています。

例 1

"hasMenuItem": {
  "@type": "MenuItem",
  "@id": "http://www.provider.com/bar/menuitem/1",
  "name": "Potato Skins",
  "description": "Small serving of stuffed potato skins.",
  "offers": {
    "@type": "Offer",
    "sku": "offer-potato-skins",
    "price": "7.49",
    "priceCurrency": "USD"
  },
  "suitableForDiet": "http://schema.org/GlutenFreeDiet"
}

例 2

"hasMenuItem": [
  {
    "@type": "MenuItem",
    "@id": "https://www.example.com/1089/product/170067",
    "name": "Veg Grill Burrito",
    "offers": {
      "@type": "Offer",
      "sku": "offer-veg-grill-burrito",
      "price": "12.99",
      "priceCurrency": "USD"
    },
    "menuAddOn": {
      "@type": "AddOnMenuSection",
      "name": "Cheese",
      "@id": "https://www.example.com/1089/addon/1", // Points to an AddOnMenuSection
      "eligibleQuantity":
        "@type": "QuantitativeValue",
        "minValue": 0,
        "maxValue": 2 // Maximum of 2 cheeses are allowed
      }
    }
  },
  {
    "@type": "MenuItem",
    "@id": "https://www.example.com/1089/product/170018",
    "name": "Chicken Taco",
    "offers": {
      "@type": "Offer",
      "sku": "offer-chicken-taco",
      "price": "6.99",
      "priceCurrency": "USD"
    }
  }
]

例 3

{
  "@type": "MenuItem",
  "@id": "https://www.example.com/1089/product/170067",
  "name": "Meat Combo",
  "hasMenuItemOptions": [
    {
      "@type": "MenuItemOption",
      "value": {
        "@type": "PropertyValue",
        "name": "OPTION",
        "value": "Plate",
        "offers": {
          "@type": "Offer",
          "sku": "offer-meat-combo-plate",
          "price": "12.00",
          "priceCurrency": "USD"
        },
        "menuAddOn": [
          {
            "@type": "AddOnMenuSection",
            "name": "Toppings for Plate",
            "@id": "https://www.example.com/1089/addon/1",
            "eligibleQuantity": {
              "@type": "QuantitativeValue",
              "minValue": 0,
              "maxValue": 3
            },
            "hasMenuItem": [
              {
                "@type": "AddOnMenuItem",
                "@id": "https://www.example.com/1089/addon/1/a",
                "name": "Hummus",
                "offers": {
                  "@type": "Offer",
                  "sku": "offer-meat-combo-topping-hummus",
                  "price": "1.00",
                  "priceCurrency": "USD"
                }
              }
              // -- Other Items --
            ]
          }
        ]
      }
    },
    {
      "@type": "MenuItemOption",
      "value": {
        "@type": "PropertyValue",
        "name": "OPTION",
        "value": "Sandwich"
      },
      "offers": {
        "@type": "Offer",
        "sku": "offer-meat-combo-sandwich",
        "price": "10.00",
        "priceCurrency": "USD"
      },
      "menuAddOn": [
        {
          "@type": "AddOnMenuSection",
          "name": "Toppings for Sandwich",
          "@id": "https://www.example.com/1089/addon/1",
          "eligibleQuantity": {
            "@type": "QuantitativeValue",
            "minValue": 0,
            "maxValue": 2
          },
          "hasMenuItem": [
            {
              "@type": "AddOnMenuItem",
              "@id": "https://www.example.com/1089/addon/1/a",
              "name": "Hummus",
              "offers": {
                "@type": "Offer",
                "sku": "offer-meat-combo-topping-hummus",
                "price": "1.00",
                "priceCurrency": "USD"
              }
            }
            // -- Other Items --
          ]
        }
      ]
    }
  ]
}

例 4

{
  "@type": "MenuItem",
  "@id": "https://www.example.com/1089/product/170067",
  "name": "Pepperoni Pizza",
  "hasMenuItemOptions": [
    {
      "@type": "MenuItemOption",
      "value": {
        "@type": "PropertyValue",
        "name": "SIZE",
        "value": "Small"
      },
      "offers": {
        "@type": "Offer",
        "sku": "offer-small",
        "price": "10.00",
        "priceCurrency": "USD"
      }
    },
    {
      "@type": "MenuItemOption",
      "value": {
        "@type": "PropertyValue",
        "name": "SIZE",
        "value": "Medium"
      },
      "offers": {
        "@type": "Offer",
        "sku": "offer-medium",
        "price": "15.00",
        "priceCurrency": "USD"
      }
    },
    {
      "@type": "MenuItemOption",
      "value": {
        "@type": "PropertyValue",
        "name": "SIZE",
        "value": "Large"
      },
      "offers": {
        "@type": "Offer",
        "sku": "offer-large",
        "price": "20.00",
        "priceCurrency": "USD"
      }
    }
  ]
}

例 5

{
  "@type": ["MenuItem", "FoodBeverageTobaccoProduct"],
  "@id": "http://www.example.com/bar/menuitem/9",
  "name": "Ice Coffee",
  "offers": {
    "@type": "Offer",
    "sku": "offer-ice-coffee",
    "price": "3.99",
    "priceCurrency": "USD"
  },
  "nutrition": {
    "@type": "NutritionInformation",
    "description": "Contains preservatives and artificial flavor"
  },
  "hasAllergen": [
    {
      "@type": "AllergenDetails",
      "allergenType": "http://gs1.org/voc/AllergenTypeCode-LACTOSE",
      "allergenLevelOfContainmentCode":
        "http://gs1.org/voc/LevelOfContainmentCode-CONTAINS"
    },
    {
      "@type": "AllergenDetails",
      "allergenType": "http://gs1.org/voc/AllergenTypeCode-PEANUTS",
      "allergenLevelOfContainmentCode":
        "http://gs1.org/voc/LevelOfContainmentCode-MAY_CONTAIN"
    }
  ],
  "additive": [
    {
      "@type": "AdditiveDetails",
      "additiveName": "caffeine",
      "additiveLevelOfContainment":
        "http://gs1.org/voc/LevelOfContainmentCode-CONTAINS"
    }
  ],
  "packaging": {
    "@type": "PackagingDetails",
    "packagingRecyclingProcessType" :
      "http://gs1.org/voc/PackagingRecyclingProcessTypeCode-REUSABLE",
    "hasReturnablePackageDeposit": {
      "@type": "ReturnablePackageDepositDetails",
      "returnablePackageDepositAmount": {
        "@type": "http://gs1.org/voc/PriceSpecification",
        "http://gs1.org/voc/price": "0.10",
        "http://gs1.org/voc/priceCurrency": "USD"
      }
    }
  }
}

MenuItem エンティティのその他の例については、レストランおよびメニュー フィードの例をご覧ください。

次の場合にユーザーが行う必要がある選択を表すオプション 選択します。ユーザーはオプションを選択する必要があります。選択しない場合、注文は 無効と見なされます。たとえば、ケースで小、中、大を選択します。 作成しました。

MenuItemOption のサンプル ユースケースについては、 MenuItemOption を使用したカスタマイズ

次の表に、MenuItemOption タイプのプロパティを示します。

プロパティ タイプ 必要性 説明
@type テキスト 必須 これは常に「MenuItemOption」です。
value PropertyValue 必須 値を表す名前と値のペアを含む PropertyValue 選択します。
offers Offer の配列 必須

この MenuItemOption を提供する 1 つ以上のオファー。 このメニュー項目オプションが利用できるタイミングと価格を表します。 一度に有効なオファーは 1 つのみです。多数の 価格や空室状況が時間帯によって変わる可能性がある場合は、有効なオファーを提示します。 Offer.eligibleQuantity は使用しないでください。 MenuItemOption は相互に排他的であるため、 指定した場合、Offer.eligibleQuantity は無視されます。

以下のリストは、どの Offer プロパティが MenuItemOption で使用。

  • Offer.skuが必要です
  • Offer.priceが必要です
  • Offer.priceCurrencyが必要です
  • Offer.availabilityStarts(省略可)
  • Offer.availabilityEnds(省略可)
  • Offer.availableDay(省略可)
  • Offer.validFrom(省略可)
  • Offer.validThrough(省略可)
  • Offer.eligibleQuantity(省略可)
  • Offer.inventoryLevel(省略可)
menuAddOn Array of AddOnMenuSection 省略可 アドオンとして追加できる、許可されているアイテムのメニュー セクション。次の場合にのみ使用: アドオンが特定のメニュー項目オプションに固有の場合。それ以外の場合 MenuItem.menuAddOn プロパティを使用してアドオンを指定します。
suitableForDiet RestrictedDiet の配列 省略可 この料理が準拠している食事を示す列挙リスト 記載されている食事制限(例: &quot;http://schema.org/GlutenFreeDiet&quot;または「http://schema.org/VeganDiet」)。
nutrition NutritionInformation 省略可 その料理の栄養情報、特にカロリーの情報。
hasAllergen AllergenDetails 省略可 gs1:AllergenDetails ごとの料理のアレルゲン。 このプロパティを使用するには、gs1 コンテキストを追加します: "@context": ["http://gs1.org/voc/", "http://schema.org"]。 そして、変数の型に FoodBeverageTobaccoProduct を追加します。 MenuItemOption
additive AdditiveDetails の配列 省略可 gs1:AdditiveDetails ごとの料理の添加物。 有効な値の列挙リストです。gs1 コンテキストを追加して使用する このプロパティ: "@context": ["http://gs1.org/voc/", "http://schema.org"] そして、変数の型に FoodBeverageTobaccoProduct を追加します。 MenuItemOption
packaging PackagingDetails 省略可 このメニュー項目の梱包とリサイクルに関する情報 gs1:PackagingDetails このプロパティを使用するには、gs1 コンテキスト("@context": ["http://gs1.org/voc/", "http://schema.org"])を追加します。 そして、変数の型に FoodBeverageTobaccoProduct を追加します。 MenuItemOption

次の例は、MenuItemOption 要素を示しています。

例 1

{
  "@type": "MenuItem",
  "@id": "https://www.example.com/1089/product/170067",
  "name": "Pepperoni Pizza",
  "hasMenuItemOptions": [
    {
      "@type": "MenuItemOption",
      "value": {
        "@type": "PropertyValue",
        "name": "SIZE",
        "value": "Small"
      },
      "offers": {
        "@type": "Offer",
        "sku": "offer-small",
        "price": "10.00",
        "priceCurrency": "USD"
      }
    },
    {
      "@type": "MenuItemOption",
      "value": {
        "@type": "PropertyValue",
        "name": "SIZE",
        "value": "Medium"
      },
      "offers": {
        "@type": "Offer",
        "sku": "offer-medium",
        "price": "15.00",
        "priceCurrency": "USD"
      }
    },
    {
      "@type": "MenuItemOption",
      "value": {
        "@type": "PropertyValue",
        "name": "SIZE",
        "value": "Large"
      },
      "offers": {
        "@type": "Offer",
        "sku": "offer-large",
        "price": "20.00",
        "priceCurrency": "USD"
      }
    }
  ]
}

例 2

{
  "@type": "MenuItem",
  "@id": "https://www.example.com/1089/product/170067",
  "name": "Meat Combo",
  "hasMenuItemOptions": [
    {
      "@type": "MenuItemOption",
      "value": {
        "@type": "PropertyValue",
        "name": "OPTION",
        "value": "Plate",
        "offers": {
          "@type": "Offer",
          "sku": "offer-meat-combo-plate",
          "price": "12.00",
          "priceCurrency": "USD"
        },
        "menuAddOn": [
          {
            "@type": "AddOnMenuSection",
            "name": "Toppings for Plate",
            "@id": "https://www.example.com/1089/addon/1",
            "eligibleQuantity": {
              "@type": "QuantitativeValue",
              "minValue": 0,
              "maxValue": 3
            },
            "hasMenuItem": [
              {
                "@type": "AddOnMenuItem",
                "@id": "https://www.example.com/1089/addon/1/a",
                "name": "Hummus",
                "offers": {
                  "@type": "Offer",
                  "sku": "offer-meat-combo-topping-hummus",
                  "price": "1.00",
                  "priceCurrency": "USD"
                }
              }
              // -- Other Items --
            ]
          }
        ]
      }
    },
    {
      "@type": "MenuItemOption",
      "value": {
        "@type": "PropertyValue",
        "name": "OPTION",
        "value": "Sandwich"
      },
      "offers": {
        "@type": "Offer",
        "sku": "offer-meat-combo-sandwich",
        "price": "10.00",
        "priceCurrency": "USD"
      },
      "menuAddOn": [
        {
          "@type": "AddOnMenuSection",
          "name": "Toppings for Sandwich",
          "@id": "https://www.example.com/1089/addon/1",
          "eligibleQuantity": {
            "@type": "QuantitativeValue",
            "minValue": 0,
            "maxValue": 2
          },
          "hasMenuItem": [
            {
              "@type": "AddOnMenuItem",
              "@id": "https://www.example.com/1089/addon/1/a",
              "name": "Hummus",
              "offers": {
                "@type": "Offer",
                "sku": "offer-meat-combo-topping-hummus",
                "price": "1.00",
                "priceCurrency": "USD"
              }
            }
            // -- Other Items --
          ]
        }
      ]
    }
  ]
}

メニューの特定のセクションを表すメニュー セクション。次の表に MenuSection 型のプロパティを一覧表示します。

プロパティ タイプ 必要性 説明
@type テキスト 必須 これは常に「MenuSection」です。
@id URL 必須 メニュー セクションの一意の識別子。
name テキスト 必須 ユーザーのブラウジング時に MenuSection を識別できるテキスト アクセスできます。
description テキスト 省略可 メニュー セクションの説明。
hasMenuSection MenuSection の配列 省略可 MenuSection の論理サブグループ化。たとえば、 ディナーのメニュー セクションには、 料理」または「ベジタリアン」を検索してください。
hasMenuItem MenuItem の配列 省略可 MenuSection に含まれるメニュー項目。
offers Offer の配列 省略可

Offer.availabilityStartsOffer.availabilityEnds は、 このMenuSectionが配信されます使用不可 Offer.eligibleQuantity

次のリストは、どの Offer プロパティが MenuSection で使用:

  • Offer.availabilityStarts(省略可)
  • Offer.availabilityEnds(省略可)
  • Offer.availableDay(省略可)
  • Offer.validFrom(省略可)
  • Offer.validThrough(省略可)
image URL 省略可 メニュー セクションの画像。

次の例は、MenuSection エンティティを示しています。

例 1

{
  "@type": "MenuSection",
  "@id": "http://www.provider.com/bar/menusection/4",
  "name": "Steak",
  "description": "Steak Dishes",
  "image": "https://steak.com/steak_dishes.jpg",
  "hasMenuItem": {
    "@type": "MenuItem",
    "@id": "http://www.provider.com/bar/menuitem/3",
    "name": "Sirloin",
    "description": "Sirloin steak dish.",
    "offers": {
      "@type": "Offer",
      "sku": "offer-sirloin-steak",
      "price": "15.49",
      "priceCurrency": "USD"
    },
    "suitableForDiet": "http://schema.org/GlutenFreeDiet"
  }
}

例 2

"hasMenuSection": [
  {
    "@type": "MenuSection",
    "@id": "https://www.example.com/1089/categorization/25114480",
    "name": "Main Items",
    "hasMenuItem": [
      {
        "@type": "MenuItem",
        "@id": "https://www.example.com/1089/product/170067",
        "name": "Veg Grill Burrito",
        "offers": {
          "@type": "Offer",
          "sku": "offer-veg-grill-burrito",
          "price": "12.99",
          "priceCurrency": "USD"
        },
        "menuAddOn": {
          "@type": "AddOnMenuSection",
          "name": "Cheese",
          "@id": "https://www.example.com/1089/addon/1", // Points to an AddOnMenuSection
          "eligibleQuantity":
            "@type": "QuantitativeValue",
            "minValue": 0,
            "maxValue": 2 // Maximum of 2 cheeses are allowed
          }
        }
      },
      {
        "@type": "MenuItem",
        "@id": "https://www.example.com/1089/product/170018",
        "name": "Chicken Taco",
        "offers": {
          "@type": "Offer",
          "sku": "offer-chicken-taco",
          "price": "6.99",
          "priceCurrency": "USD"
        }
      }
    ]
  },
  {
    "@type": "AddOnMenuSection",
    "@id": "https://www.example.com/1089/addon/1",
    "name": "AddOnCheese",
    "hasMenuItem": [
      {
        "@type": "AddOnMenuItem",
        "@id": "https://www.example.com/1089/addon/a",
        "name": "Swiss",
        "offers": {
          "@type": "Offer",
          "sku": "offer-swiss",
          "price": "2.99",
          "priceCurrency": "USD"
        }
      },
      {
        "@type": "AddOnMenuItem",
        "@id": "https://www.example.com/1089/addon/b",
        "name": "Mozarella",
        "offers": {
          "@type": "Offer",
          "sku": "offer-mozzarella",
          "price": "1.99",
          "priceCurrency": "USD"
        }
      }
    ]
  }
]

MenuSection エンティティのその他の例については、以下をご覧ください。 レストランおよびメニュー フィードの例

情報" id="nutritioninformation" tabindex="-1">NutritionInformation

次の表に、NutritionInformation のプロパティを示します。 あります。測定単位では大文字と小文字が区別されます。例: 「kcal」承認された場合、 「cal」ありません。

プロパティ タイプ 必要性 説明
@type テキスト 必須 常に「NutritionInformation」です。
description テキスト 省略可 自由形式の栄養情報。例: 「次を含む」: 保存料などです。
calories テキスト 省略可

カロリー、kcal、kJ 単位のカロリー数 形式:

number Cal_kcal_OR_kJ

例: 「240 kcal」。

carbohydrateContent テキスト 省略可

炭水化物の量(通常は g) 形式:

number g_OR_mg

例: 「7 g」。

cholesterolContent テキスト 省略可

次の形式にします。

number g_OR_mg

例: 「12 mg」

fatContent テキスト 省略可

脂肪の量(通常は g 単位)。形式は以下のようになります。

number g_OR_mg

例: 「42 g」。

fiberContent テキスト 省略可

食物繊維の g または mg 数。以下の形式で指定します。

number g_OR_mg
proteinContent テキスト 省略可

タンパク質の g または mg 数。以下の形式で指定します。

number g_OR_mg
saturatedFatContent テキスト 省略可

飽和脂肪の g または mg 数。以下の形式で表します。

number g_OR_mg
servingSize テキスト 省略可 1 食あたりの量(mL、L、g、kg 単位)。体積または量で表します。 質量
sodiumContent テキスト 省略可

ナトリウムの mg または g 数。以下の形式で表します。

number g_OR_mg
sugarContent テキスト 省略可

砂糖の g または mg 数。次の形式で指定します。

number g_OR_mg
transFatContent テキスト 省略可

トランス脂肪の g または mg 数。以下の形式で表します。

number g_OR_mg
unsaturatedFatContent テキスト 省略可

不飽和脂肪の量(通常は g) 形式:

number g_OR_mg

次の例は、NutritionInformation 要素を示しています。

例 1

"nutrition": {
  "@type": "NutritionInformation",
  "calories": "170 Cal",
  "fatContent": "3 g",
  "fiberContent": "2 g",
  "proteinContent": "4 g"
},

例 2

{
  "@type": ["MenuItem", "FoodBeverageTobaccoProduct"],
  "@id": "http://www.example.com/bar/menuitem/7",
  "name": "Peach Ice Tea",
  "description": "A 0.5l bottle of peach ice tea.",
  "offers": {
    "@type": "Offer",
    "sku": "offer-peach-ice-tea",
    "price": "2.49",
    "priceCurrency": "USD"
  },
  "nutrition": {
              "@type": "NutritionInformation",
              "description": "Contains preservatives and artificial flavor"
  }
},

特典

メニュー アイテムの提供。次の表に、 Offer 型:

プロパティ タイプ 必要性 説明
@type テキスト 必須 これは常に「オファー」です。
sku テキスト 条件文

オファーの一意の識別子。一意の任意のテキスト値を指定できます Offer 内。sku 値の参照先 として購入手続きと送信を行う offerIdlineitem

このプロパティは、次のタイプのクーポンでのみ使用されます。

  • AddOnMenuItem.Offer
  • MenuItem.Offer
  • MenuOption.Offer
price テキスト 条件文

提供されている商品アイテムの価格。例: 「6.00」(通貨なし) 記号で示されます。

このプロパティは、次のタイプの場合のみ必須です。

  • AddOnMenuItem.Offer
  • MenuItem.Offer
  • MenuOption.Offer

次のオファータイプでは使用できません。

  • AddOnMenuSection.Offer
  • MenuSection.Offer
  • Service.Offer
priceCurrency テキスト 条件文

価格または価格の通貨(3 文字の ISO 4217 形式) PriceSpecification とそのサブタイプに添付されている場合。

このプロパティは、次のタイプの場合のみ必須です。

  • AddOnMenuItem.Offer
  • MenuItem.Offer
  • MenuOption.Offer

次のオファータイプでは使用できません。

  • AddOnMenuSection.Offer
  • MenuSection.Offer
  • Service.Offer
availabilityStarts DateTime または Time 省略可 クーポンが利用可能になる日時、または単に時刻。 たとえば、パンケーキが午前 7 時に提供される場合、 例: 「2017-05-01T07:00:00-07:00」 詳細については、次をご覧ください: 日時形式
availabilityEnds DateTime または Time 省略可 クーポンを利用できない日時、または単に時刻。この 指定されません。たとえば、パンケーキの在庫状況が 午前 10 時の場合、最後のパンケーキは午前 9:59:59 に提供されます。価値: このフィールドは、「2017-05-01T10:00:00-07:00」のようになります。 詳細については、次をご覧ください: 日時形式
availableDay DayOfWeek の配列 省略可

このアイテムが利用できる曜日。指定できる値は次のとおりです。

  • 「月曜日」
  • 「火曜日」
  • 「水曜日」
  • 「木曜日」
  • 「金曜日」
  • 「土曜日」
  • "日曜日"

曜日によって空き時間が異なる場合は 以下の例のように、複数の Offer オブジェクトを使用します。 以下の例をご覧ください。

validFrom DateTime 省略可

指定した日時(タイムゾーンを含む)が 価格が有効であること。たとえば、パスタは昼食は 8 ドル、昼食は 10 ドルです。 夕食時。詳細については、次をご覧ください: 日時形式

このプロパティは、次のタイプのクーポンで使用できます。

  • AddOnMenuItem.Offer
  • MenuItem.Offer
  • MenuOption.Offer
  • AddOnMenuSection.Offer
  • MenuSection.Offer

このプロパティは、次のタイプのクーポンでは使用されません。

  • Service.Offer
validThrough DateTime 省略可

指定した日時より後の日時(タイムゾーンを含む) 価格が無効になりました。例: パスタは昼食時に 800 円 夕食は 10 ドルです。validThrough の時刻は指定されません。 たとえば、時刻を午後 6 時に設定した場合、時刻は 午後 5:59:59。詳細については、次をご覧ください: 日時形式

このプロパティは、次のタイプのクーポンで使用できます。

  • AddOnMenuItem.Offer
  • MenuItem.Offer
  • MenuOption.Offer
  • AddOnMenuSection.Offer
  • MenuSection.Offer

このプロパティは、次のタイプのクーポンでは使用されません。

  • Service.Offer
eligibleQuantity QuantitativeValue 省略可

この商品アイテムが許可される注文数量。たとえば あるレストランでは 1 日に 10 枚以上のピザを注文することを 提供します。

この値は省略可能です。デフォルトでは上限はありませんが いずれかを指定できます。最小制限は そのアイテムを選択します。

このプロパティは、次のタイプのクーポンで使用できます。

  • AddOnMenuItem.Offer
  • MenuItem.Offer
  • MenuOption.Offer

このプロパティは、次のタイプのクーポンでは使用されません。

  • AddOnMenuSection.Offer
  • MenuSection.Offer
  • Service.Offer
aggregateRating AggregateRating 省略可

レビューや評価の集合に基づく、総合的な評価 表示されます。

このプロパティは、次のタイプのクーポンで使用できます。

  • AddOnMenuItem.Offer
  • MenuItem.Offer

このプロパティは、次のタイプでは使用されません。

  • AddOnMenuSection.Offer
  • MenuItemOption.Offer
  • MenuSection.Offer
  • Service.Offer
inventoryLevel QuantitativeValue 省略可

1 つまたは複数の商品アイテムの現在のおおよその在庫レベル。

このプロパティは、次のタイプのクーポンで使用できます。

  • AddOnMenuItem.Offer
  • MenuItem.Offer
  • MenuItemOption.Offer

このプロパティは、次のタイプのクーポンでは使用されません。

  • AddOnMenuSection.Offer
  • MenuSection.Offer
  • Service.Offer
priceSpecification DeliveryChargeSpecification の配列 または PaymentChargeSpecification の配列 省略可

Service.Offer で使用する場合、 送料。DeliveryChargeSpecification が複数ある場合 最も狭い範囲が適用されます。相互に使用 排他的な DeliveryChargeSpecification オブジェクトを使用して、 あいまいさが生じます

このプロパティは、次のタイプのクーポンで使用できます。

  • Service.Offer

このプロパティは、次のタイプのクーポンでは使用されません。

  • AddOnMenuItem.Offer
  • AddOnMenuSection.Offer
  • MenuItem.Offer
  • MenuOption.Offer
  • MenuSection.Offer
offeredBy Restaurant ID の配列 省略可

この Offer が関連付けられているレストランを表します。 表示されます。

指定しない場合、このOfferが提供されます 提供します

このプロパティは、次のタイプのクーポンで使用できます。

  • AddOnMenuItem.Offer
  • AddOnMenuSection.Offer
  • MenuItem.Offer
  • MenuItemOption.Offer
  • MenuSection.Offer

このプロパティは、次のタイプのクーポンでは使用されません。

  • Service.Offer
applicableFulfillmentMethod テキストの配列 省略可

この Offer のサービスタイプを表します。 条件を指定します有効な値は「DELIVERY」です。「TAKEOUT」などです。

指定しない場合、この Offer が処理されます。 デリバリーとテイクアウトの両方で対応します

このプロパティは、次のタイプのクーポンで使用できます。

  • AddOnMenuItem.Offer
  • AddOnMenuSection.Offer
  • MenuItem.Offer
  • MenuItemOption.Offer
  • MenuSection.Offer

このプロパティは、次のタイプのクーポンでは使用されません。

  • Service.Offer
@id URL 非推奨 オファーの一意の識別子。2019 年 4 月 25 日に非推奨となりました。次のように置き換えます。 sku: 上記のとおり。

次の例は、Offer 要素を示しています。

例 1

次の例は、単純なオファーを示しています。

{
  "@type": "Offer",
  "@id": "https://www.provider.com/menu/74962/139/offer",
  "price": "10",
  "priceCurrency": "USD"
}

例 2

次のオファーの例は、午前 8 時から 10 時までの在庫状況を示しています。 週末:

{
  "@type": "Offer",
  "@id": "https://www.provider.com/menu/74962/140/offer",
  "price": "10",
  "priceCurrency": "USD",
  "availabilityStarts": "T08:00:00-07:00",  // Only available from 8-9:59:59 AM
  "availabilityEnds": "T10:00:00-07:00",
  "availableDay": ["Saturday", "Sunday"]  // Only on weekends.
}

例 3

次の例は、月曜日の 9 ~ 10:59:59 AM の空き情報を示しています。 水曜日と金曜日。火曜日と木曜日の午前 8 ~ 11:59:59:

{
  "@type": "Offer",
  "@id": "https://www.provider.com/menu/74962/140/offer",
  "price": "10",
  "priceCurrency": "USD",
  "availabilityStarts": "T09:00:00-07:00",
  "availabilityEnds": "T11:00:00-07:00",
  "availableDay": ["Monday", "Wednesday", "Friday"]
}, {
  "@type": "Offer",
  "@id": "https://www.provider.com/menu/74962/141/offer",
  "price": "10",
  "priceCurrency": "USD",
  "availabilityStarts": "T08:00:00-07:00",
  "availabilityEnds": "T12:00:00-07:00",
  "availableDay": ["Tuesday", "Thursday"]
}

例 4

次の例は、アドオンのメニュー項目が ユーザーが最大 2 回分を注文できる数量 表示されます。

{
  "@type": "AddOnMenuItem",
  "@id": "https://www.example.com/1089/addon/a",
  "name": "Ranch",
  "offers": {
    "@type": "Offer",
    "@id": "https://www.example.com/1089/addon/a/offer",
    "price": "2.99",
    "priceCurrency": "USD"
    "eligibleQuantity": {
         "@type": "QuantitativeValue",
         "maxValue": 2
     }
  }
}

例 5

次の例は、特定の場所での宅配サービスを示しています。

{
  "@type": "Offer",
  "@id": "https://www.provider.com/menu/74962/139/offer",
  "price": "10",
  "priceCurrency": "USD",
  "applicableFulfillmentMethods": ["DELIVERY"],
  "offeredBy": [
    {
      "@type": "Restaurant",
      "@id": "https://www.provider.com/location/1",
    }
  ]
}

OpeningHoursSpecification

注文サービスをいつ利用できるかを定義します。通常、opens の値は の値が closes の値を下回っていることを示します。次のガイドラインは、 opens プロパティと closes プロパティ:

  • opens プロパティと closes プロパティは省略可能ですが、使用することを強くおすすめします。 注文がいつ利用可能なかを示します。利用可能なリソースを定義するためのベスト プラクティスは、 「hour」は、「h」という値を含む deliveryHours 配列を opens プロパティと closes プロパティを持つ ServiceDeliveryHoursSpecification。マイページ 次に、AdvanceServiceDeliveryHoursSpecification オブジェクトを 独自の opens プロパティと closes プロパティを持つ deliveryHours(必要な場合) 事前注文にはより限られた期間が設けられています。
  • openscloses が明示的に指定されていない場合、 サービスは、24 時間いつでも利用できます。
  • 時刻はサービスの現地時間で指定する必要があります。コメントに opens または closes 値。タイムゾーンを指定すると、Google は この情報は無視されます。
  • openscloses が同じ場合、レストランは 0 分間開けます。
  • openscloses より大きい場合、終了時刻は「当日配達」と解釈されます 翌日配達します。たとえば、営業時間を 1 月 1 日(太平洋時間)に設定されていて、 午後 5 時、閉店時間が午前 2 時の場合、レストランは次のように解釈されます。 1 月 2 日午前 2 時閉店です
  • closes の時刻は指定できません。そのため、営業開始時間と終了時間が それぞれ午前 10 時と午後 4 時に設定されていて、 午後 3 時 59 分 59 秒です

次の表に、OpeningHoursSpecification のプロパティを示します。 type:

プロパティ タイプ 必要性 説明
@type テキスト 必須 常に「OpeningHoursSpecification」です。
@id URL 省略可 OpeningHoursSpecification の識別子。
dayOfWeek DayOfWeek の配列 省略可

これらの営業時間が有効な曜日。許可される 値は "Monday"、"Tuesday"、"Thursday"、"Thursday"、"Friday" です。 「土曜日」、「日曜日」です。例:

"dayOfWeek": [
"Monday",
"Tuesday",
"Wednesday",
"Thursday",
"Friday"
]

曜日を指定しない場合、 OpeningHoursSpecification はすべての曜日に適用されます。

opens Time 省略可

Restaurant 仕様で使用する場合、このプロパティは 特定の曜日のレストランの営業時間。対象 たとえば、午前 6 時 30 分は「T06:30:00」となります。

Service 仕様で使用する場合、 ユーザーが指定した日時が始まって注文できます。これは、 オンライン システムが稼働している時間の営業時間を指定し、 ユーザーが注文できますそのオンライン システムの営業時間内には、 deliveryHours を使用して営業時間を指定できます。 ユーザーが特殊なタイプの配達を注文できる場合。

時刻はサービスの現地時間で指定する必要があります。禁止事項 opens 値にタイムゾーンを含める。タイムゾーンが Google では無視されます。

詳細については、次をご覧ください: 日時形式

closes Time 省略可

Service 仕様で使用する場合、このプロパティは ユーザーが指定した日時以降は注文を確定できませんこれは、 オンライン システムが稼働している終了時刻を指定し、 ユーザーが注文できますそのオンライン システムの営業時間内には、 deliveryHours を使用して営業時間を指定できます。 ユーザーが特殊なタイプの配達を注文できる場合。

時刻はサービスの現地時間で指定する必要があります。禁止事項 closes 値にタイムゾーンを含める。タイムゾーンが Google では無視されます。

詳細については、次をご覧ください: 日時形式

validFrom DateTime 省略可

Restaurant 仕様で使用する場合、このプロパティは opens で指定された営業時間内の日付と、 レストランの closes は有効です。

たとえば、指定された時間が 2017 年全体で適用される場合、 validFrom を「2017-01-01T00:00:00-07:00」に設定します。および validThrough を「2017-12-31T23:59:59-07:00」に変更します。

Service 仕様で使用する場合、validFrom は、ユーザーのアクセスを開始する日付を注文は あります。

フィードでこのプロパティが指定されていない場合、 レストランやサービスは毎日利用できます。

日付だけでなく、時刻とタイムゾーンの部分も 値は必須です。

タイムゾーンには、レストランまたはサービスのタイムゾーンを使用します。

詳細については、次をご覧ください: 日時形式

validThrough DateTime 省略可

Restaurant で使用する場合は、営業時間が過ぎた後の日付 (openscloses で指定されたものは 有効です。

たとえば、指定された時間が 2017 年全体で適用される場合、 validFrom を「2017-01-01T00:00:00-07:00」に設定します。および validThrough を「2017-12-31T23:59:59-07:00」に変更します。

Service 仕様で使用する場合、validThrough その日を過ぎるとユーザーが注文は あります。

フィードでこのプロパティが指定されていない場合、 レストランやサービスは毎日利用できます。

日付だけでなく、時刻とタイムゾーンの部分も 日時は必須です。

タイムゾーンには、レストランまたはサービスのタイムゾーンを使用します。

validThrough の時刻は指定できません。たとえば 時刻を午後 6 時に設定した場合、時刻は午後 5 時 59 分 59 秒まで有効です。

詳細については、次をご覧ください: 日時形式

deliveryHours ServiceDeliveryHoursSpecification の配列または次の配列 AdvanceServiceDeliveryHoursSpecification 条件文

宅配またはテイクアウトの時間の指定。

このパラメータは、レストランが閉業している場合( openscloses が設定され、等しいことを確認します。 相互に通信します。

  • ServiceDeliveryHoursSpecification: 営業時間に加え、「営業中」と「閉店」を設定できます。「クローズ」します。時間を ユーザーはできるだけ早く注文できます。
  • AdvanceServiceDeliveryHoursSpecification: 営業時間に加え、「営業中」と「閉店」を設定できます。「クローズ」します。時間を 事前注文ができます。

次の例は、OpeningHoursSpecification 要素を示しています。

例 1

// Ordering times for Monday through Friday
{
  "@type": "OpeningHoursSpecification",
  "deliveryHours": [
    {
      "@type": "AdvanceServiceDeliveryHoursSpecification",
      "deliveryLeadTime": {
        "@type": "QuantitativeValue",
        "value": "60",
        "unitCode": "MIN"
      },
      "dayOfWeek": [
        "Monday",
        "Tuesday",
        "Wednesday",
        "Thursday",
        "Friday"
      ],
      "opens": "T12:00:00", // Advance ordering begins at noon
      "closes": "T23:59:59", // Advance ordering ends at midnight
      "validFrom": "2017-01-01T00:00:00-07:00",
      "validThrough": "2018-12-31T23:59:59-07:00"
    },
    {
      "@type": "ServiceDeliveryHoursSpecification",
      "deliveryLeadTime": {
        "@type": "QuantitativeValue",
        "value": "60",
        "unitCode": "MIN"
      },
      "dayOfWeek": [
        "Monday",
        "Tuesday",
        "Wednesday",
        "Thursday",
        "Friday"
      ],
      "opens": "T10:00:00", // ASAP ordering begins at 10AM
      "closes": "T14:00:00", // ASAP ordering ends at 2PM
      "validFrom": "2017-01-01T00:00:00-07:00",
      "validThrough": "2018-12-31T23:59:59-07:00"
    }
  ]
},

例 2

// Ordering times for Saturday and Sunday
{
  "@type": "OpeningHoursSpecification",
  "deliveryHours": [
    {
      // In this case advance orders are unavailable on Saturday and Sunday
      "@type": "ServiceDeliveryHoursSpecification",
      "deliveryLeadTime": {
        "@type": "QuantitativeValue",
        "value": "60",
        "unitCode": "MIN"
      },
      "dayOfWeek": [
        "Saturday",
        "Sunday"
      ],
      "opens": "T12:00:00", // ASAP orders start at noon
      "closes": "T23:59:59", // ASAP orders end at midnight
      "validFrom": "2017-01-01T00:00:00-07:00",
      "validThrough": "2018-12-31T23:59:59-07:00"
    }
  ]
}

例 3

"hoursAvailable": {
  "@type": "OpeningHoursSpecification",
  "validFrom": "2016-02-01T00:00:00-07:00",
  "validThrough": "2016-03-01T00:00:00-07:00",
  "opens": "T08:00:00",  // Ordering begins at 8:00AM and ends at 6:00PM.
                         // ASAP and and advance orders are restricted to this
                         // time frame since the user won't be able to place
                         // orders outside of this window.
  "closes": "T18:00:00",
  "deliveryHours": {
    "@type": "ServiceDeliveryHoursSpecification",
    "deliveryLeadTime": {
      "@type": "QuantitativeValue",
      "value": "60",
      "unitCode": "MIN"
    }
  }
},

例 4

// List hours available for 2017 and 2018
"hoursAvailable": [
  {
    "@type": "OpeningHoursSpecification",
    // Array containing advance order hours for each day
    "deliveryHours": [
      {
        // Open 10:00AM to 9:29:59PM on Mondays
        "@type": "AdvanceServiceDeliveryHoursSpecification",
        "deliveryLeadTime": {
          "@type": "QuantitativeValue",
          "value": "60",
          "unitCode": "MIN"
        },
        "dayOfWeek": [
          "Monday"
        ],
        "opens": "T10:00:00",
        "closes": "T21:30:00",
        "validFrom": "2017-01-01T00:00:00-07:00",
        "validThrough": "2018-12-31T23:59:59-07:00"
      },
      {
        // Open 10:00AM to 9:29:59PM on Tuesdays
        "@type": "AdvanceServiceDeliveryHoursSpecification",
        "deliveryLeadTime": {
          "@type": "QuantitativeValue",
          "value": "60",
          "unitCode": "MIN"
        },
        "dayOfWeek": [
          "Tuesday"
        ],
        "opens": "T10:00:00",
        "closes": "T21:30:00",
        "validThrough": "2018-12-31T23:59:59-07:00"
      },
      {
        // Open 10:00AM to 9:29:59PM on Wednesdays
        "@type": "AdvanceServiceDeliveryHoursSpecification",
        "deliveryLeadTime": {
          "@type": "QuantitativeValue",
          "value": "60",
          "unitCode": "MIN"
        },
        "dayOfWeek": [
          "Wednesday"
        ],
        "opens": "T10:00:00",
        "closes": "T21:30:00",
        "validFrom": "2017-01-01T00:00:00-07:00",
        "validThrough": "2018-12-31T23:59:59-07:00"
      },
      {
        // Open 10:00AM to 9:29:59PM on Thursdays
        "@type": "AdvanceServiceDeliveryHoursSpecification",
        "dayOfWeek": [
          "Thursday"
        ],
        "opens": "T10:00:00",
        "closes": "T21:30:00",
        "validFrom": "2017-01-01T00:00:00-07:00",
        "validThrough": "2018-12-31T23:59:59-07:00"
      },
      {
        // Open 10:00AM to 11:29:59PM on Fridays
        "@type": "AdvanceServiceDeliveryHoursSpecification",
        "deliveryLeadTime": {
          "@type": "QuantitativeValue",
          "value": "60",
          "unitCode": "MIN"
        },
        "dayOfWeek": [
          "Friday"
        ],
        "opens": "T10:00:00",
        "closes": "T23:30:00",
        "validFrom": "2017-01-01T00:00:00-07:00",
        "validThrough": "2018-12-31T23:59:59-07:00"
      },
      {
        // Open 10:00AM to 11:29:59PM on Saturdays
        "@type": "AdvanceServiceDeliveryHoursSpecification",
        "deliveryLeadTime": {
          "@type": "QuantitativeValue",
          "value": "60",
          "unitCode": "MIN"
        },
        "dayOfWeek": [
          "Saturday"
        ],
        "opens": "T10:00:00",
        "closes": "T23:30:00",
        "validFrom": "2017-01-01T00:00:00-07:00",
        "validThrough": "2018-12-31T23:59:59-07:00"
      },
      {
        // Open 11:00AM to 6:59:59PM on Sundays
        "@type": "AdvanceServiceDeliveryHoursSpecification",
        "deliveryLeadTime": {
          "@type": "QuantitativeValue",
          "value": "60",
          "unitCode": "MIN"
        },
        "dayOfWeek": [
          "Sunday"
        ],
        "opens": "T11:00:00",
        "closes": "T19:00:00",
        "validFrom": "2017-01-01T00:00:00-07:00",
        "validThrough": "2018-12-31T23:59:59-07:00"
      }
    ]
  }
],

PackagingDetails

このタイプを使用するには、gs1 コンテキストを追加します: "@context": ["http://gs1.org/voc/", "http://schema.org"]MenuItem または MenuItemOption の型に FoodBeverageTobaccoProduct を追加します。

次の表に、PackagingDetails 型のプロパティを示します。

プロパティ タイプ 必要性 説明
@type テキスト 必須 これは常に「PackagingDetails」です。
packagingRecyclingProcessType テキスト 省略可 梱包材のリサイクル処理の種類 <ph type="x-smartling-placeholder"></ph> gs1:PackagingRecyclingProcessTypeCode を追加します。たとえば http://gs1.org/voc/PackagingRecyclingProcessTypeCode-RECYCLABLE または http://gs1.org/voc/PackagingRecyclingProcessTypeCode-REUSABLE
hasReturnablePackageDeposit ReturnablePackageDepositDetails 省略可 返品可能なパッケージ デポジットの詳細 gs1:ReturnablePackageDepositDetails: たとえば、ボトルや缶には返品可能な小包が付いており、

次の例は、PackagingDetails タイプの使用方法を示しています。

{
  "@type": ["MenuItem", "FoodBeverageTobaccoProduct"],
  "@id": "http://www.example.com/bar/menuitem/5",
  "name": "Sparkling Water",
  "description": "A 0.5l bottle of sparking water.",
  "offers": {
    "@type": "Offer",
    "sku": "offer-sparkling-water",
    "price": "1.49",
    "priceCurrency": "USD"
  },
  "packaging": {
    "@type": "PackagingDetails",
    "packagingRecyclingProcessType" :
      "http://gs1.org/voc/PackagingRecyclingProcessTypeCode-REUSABLE",
    "hasReturnablePackageDeposit": {
      "@type": "ReturnablePackageDepositDetails",
      "returnablePackageDepositAmount": {
        "@type": "http://gs1.org/voc/PriceSpecification",
        "http://gs1.org/voc/price": "0.05",
        "http://gs1.org/voc/priceCurrency": "USD"
      }
    }
  }
},

PaymentChargeSpecification

次の表に、PaymentChargeSpecification のプロパティを示します。 type:

プロパティ タイプ 必要性 説明
@type テキスト 必須 常に「PaymentChargeSpecification」です。
@id URL 省略可 PaymentChargeSpecification の識別子。
price 数値 必須 請求の合計金額。例: 通貨なしの「6.00」 記号で示されます。
priceCurrency テキスト 必須 価格の 3 文字の ISO 4217 通貨コード。たとえば 「USD」
eligibleTransactionVolume PriceSpecification 省略可 この支払いに請求される取引量(単位)。 最小購入金額(最小購入金額)を示すなど、 できます。
eligibleQuantity QuantitativeValue 省略可 支払い請求が有効な注文数量。対象 たとえば、このプロパティを使用して、最小数のアイテムと 必要があります
validFrom DateTime 省略可 お支払いの請求が行われる日時(タイムゾーンを含む) 有効になります。例: 2017-05-01T07:00:00-07:00対象 詳細については、以下をご覧ください。 日時形式
validThrough DateTime 省略可 お支払いが行われた日時(タイムゾーンを含む) 指定した料金が無効です。例: 2017-05-01T07:30:00-07:00 validThrough の時間は排他的です。たとえば、 時刻が午後 6 時に設定されている場合、時刻は午後 5 時 59 分 59 秒まで有効です。 詳細については、次をご覧ください: 日時形式

次の例は、PaymentChargeSpecification 要素を示しています。

"priceSpecification": [{
  "@type": "PaymentChargeSpecification",
  "@id": "http://www.provider.com/paymentCharge/bar",
  "priceCurrency": "USD",
  "price": "6.00", // Charges $6 for processing fee
  "eligibleQuantity": {
    "@type": "QuantitativeValue",
    "minValue": 2 // Minimum of two items required
  }
}]

"@type": ["PaymentChargeSpecification"] に加えて、オブジェクトには以下を指定できます。 UnitPriceSpecification で拡張 ("@type": ["PaymentChargeSpecification", "UnitPriceSpecification"])。 この拡張機能では、サービス手数料に必要なプロパティが 2 つ追加されています。 パーセンテージで計算されます。

プロパティ タイプ 必要性 説明
referenceQuantity QuantitativeValue 必須 特定の料金が適用される参照数量。たとえば 値 10 の referenceQuantityunitCode 「P1」注文額の 10% となります「P1」は unitCode のみ 使用できます。
basePrice 数値 省略可 referenceQuantity に上乗せされる基本料金。対象 例: unitCodereferenceQuantity / 10 「P1」basePrice の 5 個目は、$5 + 10% の金額になります 指定します。デフォルト値は 0 です。

データ エクスポートの料金の例

Google では、ユーザーに対しさまざまな料金を事前に指定することができます。 Service エンティティの Offer.PriceSpecification

現在サポートされている PaymentChargeSpecification は 1 つのみです。結合 あらゆる種類の料金を 1 つの PaymentChargeSpecification に統合

料金がない場合、Offer.PriceSpecification は省略されます。

  • 例 1: サービス手数料がカートの小計の 5% である
  • 例 2: サービス手数料が 5 ドルの場合
  • 例 3: 手荷物料金が $0.1、サービス手数料がカート小計の 5% の場合
  • 例 4: 手荷物料金は 0.1 ドル、サービス手数料は 1 ドル
  • 例 5: サービス手数料が 5% で、必要なチップがカート小計の 10% の場合

例 1

priceSpecification [
  {
    "@type": ["PaymentChargeSpecification", "UnitPriceSpecification"],
    "referenceQuantity": {
      "@type": "QuantitativeValue",
      "value": "5.00", // 5%
      "unitCode": "P1" // P1 == %
    },
    "priceCurrency": "USD"
  }
]

例 2

priceSpecification [
  {
    "@type": ["PaymentChargeSpecification"],
    "priceCurrency": "USD",
    "price": "5.00"
  }
]

例 3

priceSpecification [
  {
    "@type": ["PaymentChargeSpecification", "UnitPriceSpecification"],
    "referenceQuantity": {
      "@type": "QuantitativeValue",
      "value": "5.00", // 5%
      "unitCode": "P1", // P1 == %
    },
    "priceCurrency": "USD",
    "basePrice": "0.10" // Bag fee $0.1
  }
]

例 4

priceSpecification [
  {
    "@type": ["PaymentChargeSpecification"],
    "priceCurrency": "USD",
    "price": "1.10" //$1 + $0.1
  }
]

例 5

priceSpecification [
  {
    "@type": ["PaymentChargeSpecification", "UnitPriceSpecification"],
    "referenceQuantity": {
      "@type": "QuantitativeValue",
      "value": "15.00", // 5% + 10%
      "unitCode": "P1" // P1 == %
    },
    "priceCurrency": "USD"
  }
]

場所

次の表に、Place 型のプロパティを示します。

プロパティ タイプ 必要性 説明
@type テキスト 必須 これは常に「場所」です。
address PostalAddress 必須 場所の住所。

次の例は、場所要素を示しています。

{
  "@type": "Place", // area2
  "address": {
    "@type": "PostalAddress",
    "postalCode": "94041",
    "addressCountry": "US"
  }
},

PostalAddress

次の表に、PostalAddress 型のプロパティを示します。

プロパティ タイプ 必要性 説明
@type テキスト 必須 これは常に「PostalAddress」です。
addressLocality テキスト 必須* 地域区分または都市。(例: 「サンフランシスコ」)。
addressRegion テキスト 必須* 地域または州。例: 「CA」。
postalCode テキスト 必須* 郵便番号。例: 「94102」
streetAddress テキスト 省略可 番地。(例: 「1600 Amphitheatre Pkwy」)。
addressCountry テキスト 必須 2 文字の ISO 3166-1 alpha-2 国コード。例: US。

配信プロバイダは、これらのプロパティを一覧表示して、Service.areaServed を指定できます。 提供します。

Restaurant.address で使用する場合、 PostalAddress は必須です。

次の例は、PostalAddress 要素を示しています。

"address": {
  "@type": "PostalAddress",
  "streetAddress": "12345 Bar Avenue",
  "addressLocality": "San Francisco",
  "addressRegion": "CA",
  "postalCode": "94124",
  "addressCountry": "US"
},

PriceSpecification

次の表に、PriceSpecification のプロパティを示します。 type:

プロパティ タイプ 必要性 説明
@type テキスト 必須 常に「PriceSpecification」です。
@id URL 省略可 PriceSpecification の識別子。
minPrice 数値 省略可 価格帯の場合の最低価格。
maxPrice 数値 省略可 価格帯の場合、最高価格。
priceCurrency テキスト 必須 価格の 3 文字の ISO 4217 通貨コード。たとえば 「USD」
eligibleQuantity QuantitativeValue 省略可 価格仕様が有効な注文数量。 たとえば、価格が 1 ポンドあたり 2 ドル、1 ドルあたり 2 アイテムなどです。

次の例は、PriceSpecification 要素を示しています。

例 1

"eligibleTransactionVolume": {
  "@type": "PriceSpecification",
  "minPrice": "20.00", // Minimum order price for delivery is $20
  "priceCurrency": "USD"
}

PropertyValue

MenuItemOption でオプションを記述するために使用されるプロパティ値ペア。

次の表に、PropertyValue タイプのプロパティを示します。

プロパティ タイプ 必要性 説明
@type テキスト 必須 これは常に「PropertyValue」です。
name テキスト 必須

オプションの名前またはタイプ。

MenuItem で使用する場合の有効な名前は次のとおりです。

  • "SIZE": MenuItem のサイズ。たとえば、小、中、 あります。
  • 「OPTION」: サイズ以外のバリエーション( サラダでもサンドイッチでもかまいません。2 つのモデルを区別できない場合は、 「SIZE」「OPTION」の後に「OPTION」を使用します。

AddOnMenuItem で使用する場合の有効な名前:

  • "APPLICABLE_ITEM_OPTION": アドオンの MenuItem と一緒に使用すると、それぞれ対応する 「サイズ/オプション」。
  • "PIZZA_SIDE": ピザに固有の。このアドオンは ピザ(左側にマッシュルームのトッピングが乗っているなど) ピザ全体など)が表示されます。
  • "SIZE": アドオンのサイズを指定するオプション (ミールセットのアドオンとしての大きなフライドポテトなど)。
  • "OPTION": サイズ以外のバリエーション。動画がない場合、 「SIZE」と「OPTION」の後に「OPTION」を使用します。
value テキスト 必須

オプションの値。値には任意の文字列を指定でき、 あります有効な値は次のとおりです。

  • "PIZZA_SIDE": 対応する値は "PIZZA_SIDE_LEFT"、 「PIZZA_SIDE_RIGHT」、「PIZZA_SIDE_WHOLE」答えを出します。
  • "APPLICABLE_ITEM_OPTION": この値は 対応する「OPTION/SIZE」親 MenuItem の MenuItemOptions。

QuantitativeValue

次の表に、QuantitativeValue 型のプロパティを示します。

プロパティ タイプ 必要性 説明
@type テキスト 必須 これは常に「QuantitativeValue」です。
value 数値 省略可 定量値またはプロパティ値ノードの値。
unitCode テキストまたは URL 省略可

単位は、 UN/CEFACT 共通コード できます。

UN/CEFACT 共通コード以外のコードは、接頭辞とともに使用できます。 その後にコロンが続きます。

maxValue 数値 省略可 なんらかの特性またはプロパティの上限値。
minValue 数値 省略可 なんらかの特性またはプロパティの低い値。

次の例は、QuantitativeValue タイプの使用方法を示しています。

例 1

"deliveryLeadTime": {
  "@type": "QuantitativeValue",
  "value": "60",
  "unitCode": "MIN"
}

例 2

"menuAddOn": {
  "@type": "AddOnMenuSection",
  "name": "Cheese",
  "@id": "https://www.example.com/1089/addon/1", // Points to an AddOnMenuSection
  "eligibleQuantity":
    "@type": "QuantitativeValue",
    "minValue": 0,
    "maxValue": 2 // Maximum of 2 cheeses are allowed
  }
}

例 3

"priceSpecification": [
  {
    "@type": "DeliveryChargeSpecification",
    "@id": "http://www.provider.com/defaultdeliveryfee/foo",
    "price": "10.0",
    "priceCurrency": "USD",
    "eligibleQuantity": {
      "@type": "QuantitativeValue",
      "minValue": 3  // Minimum of 3 items required for delivery
    }
  },
  {
    "@type": "DeliveryChargeSpecification",
    "@id": "http://www.provider.com/deliveryfee/foo/1",
    "price": "20.0",
    "priceCurrency": "USD",
    "validFrom":"T18:00:00", // Valid from 6:00PM
    "validThrough":"T22:00:00", // Valid to 9:59:59PM
    "eligibleQuantity": {
      "@type": "QuantitativeValue",
      "minValue": 3  // Minimum of 3 items required for delivery
    }
  }
]

レストラン

次の表に、Restaurant タイプのプロパティを示します。

プロパティ タイプ 必要性 説明
@type テキスト 必須 これは常に「レストラン」です。
@id URL 必須 レストランまたはデリバリー プロバイダの一意の識別子。たとえば 「http://www.provider.com/326」(「326」)一意の ID である 説明します。
name テキスト 必須 並べ替え時に Restaurant を識別できるテキスト プロセスです
url URL 必須 レストランを表すドメインの URL。たとえば &quot;http://www.provider.com/somerestaurant&quot;.
sameAs URL 省略可 レストランの公式ウェブサイト。たとえば 「http://www.somerestaurant.com」。
email テキスト 省略可 レストランの連絡先メールアドレス。
description テキスト 省略可 レストランの説明。
telephone テキスト 必須

次の形式の電話番号:

"[+][country_code][phone_#_with_area_code]"

例: 「+16501234567」

priceRange テキスト 省略可 幅広い料金体系。例: 「$$" ($-Inexpensive, $$-Moderate $$$-Expensive, $$$$-Very Expensive).
logo URL Optional Logo of the restaurant in PNG, JPG, or GIF format. For example, "http://www.somerestaurant.com/logo.png".
image URL Optional Image of the restaurant.
servesCuisine Array of Text Optional Food types that are served at the restaurant. For example, ["sushi","Asian fusion"].
address PostalAddress Required* Address of the restaurant.
geo GeoCoordinates Optional* Geographic coordinates of the restaurant.
suitableForDiet Array of RestrictedDiet Optional Dietary restrictions this restaurant accommodates (like kosher, vegan, or gluten-free diets). It is an enumerated list.
aggregateRating AggregateRating Optional Overall rating, based on a collection of reviews or ratings of the restaurant.
additionalProperty Array of name value string pairs Optional

A restaurant imprint is a section of additional information about the restaurant, such as legal name, legal address, and registration number. This information can be formatted using "\n".

For example "additionalProperty": [{"name": "imprint", "value": "first row\nsecondrow\n"},]

The following examples show the usage of the Restaurant type:

Example 1

{
  "@type": "Restaurant",
  "@id": "http://www.provider.com/somerestaurant",
  "url": "www.provider.com/somerestaurant",
  "name": "Some Restaurant",
  "sameAs": "http://www.somerestaurant.com",
  "image": "http://www.somerestaurant.com/image-of-some-restaurant.jpg",
  "description": "This is the Some Restaurant located on 345 Spear St. San Francisco, 94105 CA. It serves Indian-Mexican fusion cuisine",
  "address": {
    "@type": "PostalAddress",
    "addressLocality": "San Francisco",
    "addressRegion": "CA",
    "postalCode": "94105",
    "streetAddress": "345 Spear St",
    "addressCountry": "US"
  },
  "geo": {
    "@type": "GeoCoordinates",
    "latitude": "37.391115",
    "longitude": "-122.081099"
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.4",
    "reviewCount": "89"
  },
  "priceRange": "$$",
  "telephone": "+16501234567", // 国コード(+1)が必要
  "servesCuisine": [
    "Indian-Mexican Fusion"
  ]
},
  
  <ph type="x-smartling-placeholder">
</ph>

例 2

{
  "@type": "Restaurant",
  "@id": "http://www.example.com/threebrotherstacos",
  "name": "Three Brothers Tacos",
  "address": {
        "@type": "PostalAddress",
        "addressLocality": "Mountain View",
        "addressRegion": "CA",
        "postalCode": "94041",
        "streetAddress": "123 Foo St",
        "addressCountry": "US"
  },
  "additionalProperty": [
    {"name": "imprint", "value": "Three Brothers Tacos\n123 FooSt\nMountain View\nCA 94041, United States\nemail: contact@threebrotherstacos.com\n\nCommercial Register: 123456789"}
  ]
}

Restaurant エンティティのその他の例については、以下をご覧ください。 レストランおよびメニュー フィードの例

ReturnablePackageDepositDetails

このタイプを使用するには、gs1 コンテキスト「@context」を追加します。

["http://gs1.org/voc/", "http://schema.org"]

次に、適切な MenuItem のタイプに FoodBeverageTobaccoProduct を追加します。 または MenuItemOption

次の表に、 ReturnablePackageDepositDetails 型:

プロパティ タイプ 必要性 説明
@type テキスト 必須 これは常に「ReturnablePackageDepositDetails」です。
returnablePackageDepositAmount gs1:PriceSpecification 省略可 このアイテムのデポジット額 <ph type="x-smartling-placeholder"></ph> gs1:PriceSpecification をご覧ください。例: 1 缶につき 0.25 ドルの保証金。

次の例は、ReturnablePackageDepositDetails の使用例を示しています。 type:

{
  "@type": ["MenuItem", "FoodBeverageTobaccoProduct"],
  "@id": "http://www.example.com/bar/menuitem/5",
  "name": "Sparkling Water",
  "description": "A 0.5l bottle of sparking water.",
  "offers": {
    "@type": "Offer",
    "sku": "offer-sparkling-water",
    "price": "1.49",
    "priceCurrency": "USD"
  },
  "packaging": {
    "@type": "PackagingDetails",
    "packagingRecyclingProcessType" :
      "http://gs1.org/voc/PackagingRecyclingProcessTypeCode-REUSABLE",
    "hasReturnablePackageDeposit": {
      "@type": "ReturnablePackageDepositDetails",
      "returnablePackageDepositAmount": {
        "@type": "http://gs1.org/voc/PriceSpecification",
        "http://gs1.org/voc/price": "0.05",
        "http://gs1.org/voc/priceCurrency": "USD"
      }
    }
  }
},

サービス

注文処理のエンドツーエンド アクションをレストランから 地理的な場所を基準にします。

次の表に、Service 型のプロパティを示します。

プロパティ タイプ 必要性 説明
@type テキスト 必須

フィードタイプ。

  • Service: すべての有効なサービス フィードにこのタイプを使用します。
  • DisabledService: 無効にする必要がある場合にのみ、このタイプを使用します。 想定外のイベントによって Service エンティティにアタッチされ、 サービスが再確立されます。
@id URL 必須 フルフィルメント サービスの識別子。たとえば &quot;http://www.provider.com/service/1&quot;.
description テキスト 省略可 項目の説明。
serviceType テキスト 必須 提供するサービスの種類です。有効な値は「DELIVERY」です。または 「TAKEOUT」。
provider Restaurant 必須 レストランの一意の識別子への参照。たとえば &quot;http://www.provider.com/somerestaurant&quot;.
areaServed GeoShape の配列、 Place、または GeoCircle 条件文 サービスを提供する地域。このフィールドは デフォルトですが、serviceType が「DELIVERY」の場合は必須です。
hoursAvailable OpeningHoursSpecification の配列 必須 このサービスが利用可能な時間帯です。
specialOpeningHoursSpecification OpeningHoursSpecification の配列、 ServiceDeliveryHoursSpecification、または AdvanceServiceDeliveryHoursSpecification 省略可

より一般的な OpeningHoursSpecification をオーバーライドする時刻、または フルフィルメントの所要時間通常、このフィールドは休日を定義するために使用します その他の種類の臨時休業や営業時間の変更などです。

validFrom を使用して特別な期間を定義します。 validThrough プロパティ。時刻とタイムゾーンは これらのプロパティを指定するときに必須です。

offers Offer の配列 条件文

指定したレストランのデリバリーに関する詳細情報。この フィールドはデフォルトでは省略可ですが、serviceType の場合は必須です。 「DELIVERY」です。

Offer.priceSpecification プロパティは、 。ここでは、他の Offer プロパティは使用されません。

hasOfferCatalog [Menu、OfferCatalog] 必須

このサービスのメニューを指定します。必要に応じて別のメニューを 各サービス(テイクアウト、宅配、ケータリングなど)

MenuOfferCatalog の両方を指定する必要があります。 指定します。例:

"hasOfferCatalog": {
"@type": ["Menu", "OfferCatalog"],
"@id": "https://www.provider.com/restaurant/menu/1"
}
additionalProperty {name, value} の配列 省略可

オプションのサービス構成情報。期待される商品アイテム数 オプションに対応するキー name を持つオブジェクト。 フィールド名です。キー value はコンテキストに関連する値です。 指定します。

ServingConfig をご覧ください。 を参照してください。

"additionalProperty": [{
  "name": "disableOrderInstructions",
  "value": false
}, {
  "name": "disableMenuItemSpecialInstructions",
  "value": false
}, {
  "name": "disableTipWidget",
  "value": false
}, {
  "name": "disablePromoWidget",
  "value": false
}, {
  "name": "menuItemSpecialInstructionsMaxLength",
  "value": 256
}, {
  "name": "orderInstructionsMaxLength",
  "value": 256
}]
potentialAction URL 省略可

エンドツーエンドの料理注文エクスペリエンスからリダイレクトに移行する際に使用される、デリバリー/テイクアウト サービスの URL が含まれています。例: "PotentialAction": { "url": "https://fopatestagent.com/ordering/restaurant-1/delivery"}

次の例は、Service タイプの使用方法を示しています。

{
  "@type": "Service",
  "@id": "http://www.provider.com/service/1",
  "serviceType": "DELIVERY",
  "provider": {
    "@type": "Restaurant",
    "@id": "http://www.provider.com/threebrotherstacos"
  },
  "potentialAction": {
    "url": "https://foprovider.com/ordering/restaurant-1/delivery"
  },
  "hoursAvailable": [
    // Ordering times for Monday through Friday
    {
      "@type": "OpeningHoursSpecification",
      "deliveryHours": [
        {
          "@type": "AdvanceServiceDeliveryHoursSpecification",
          "deliveryLeadTime": {
            "@type": "QuantitativeValue",
            "value": "60",
            "unitCode": "MIN"
          },
          "dayOfWeek": [
            "Monday",
            "Tuesday",
            "Wednesday",
            "Thursday",
            "Friday"
          ],
          "opens": "T12:00:00", // Advance ordering begins at noon
          "closes": "T23:59:59", // Advance ordering ends at midnight
          "validFrom": "2017-01-01T00:00:00-07:00",
          "validThrough": "2018-12-31T23:59:59-07:00"
        },
        {
          "@type": "ServiceDeliveryHoursSpecification",
          "deliveryLeadTime": {
            "@type": "QuantitativeValue",
            "value": "60",
            "unitCode": "MIN"
          },
          "dayOfWeek": [
            "Monday",
            "Tuesday",
            "Wednesday",
            "Thursday",
            "Friday"
          ],
          "opens": "T10:00:00", // ASAP ordering begins at 10AM
          "closes": "T14:00:00", // ASAP ordering ends at 2PM
          "validFrom": "2017-01-01T00:00:00-07:00",
          "validThrough": "2018-12-31T23:59:59-07:00"
        }
      ]
    },
    // Ordering times for Saturday and Sunday
    {
      "@type": "OpeningHoursSpecification",
      "deliveryHours": [
        {
          // In this case advance orders are unavailable on Saturday and Sunday
          "@type": "ServiceDeliveryHoursSpecification",
          "deliveryLeadTime": {
            "@type": "QuantitativeValue",
            "value": "60",
            "unitCode": "MIN"
          },
          "dayOfWeek": [
            "Saturday",
            "Sunday"
          ],
          "opens": "T12:00:00", // ASAP orders start at noon
          "closes": "T23:59:59", // ASAP orders end at midnight
          "validFrom": "2017-01-01T00:00:00-07:00",
          "validThrough": "2018-12-31T23:59:59-07:00"
        }
      ]
    }
  ],
  "hasOfferCatalog": {
    "@type": ["Menu", "OfferCatalog"],
    "@id": "https://www.provider.com/menu/1"
  },
  "areaServed": [{
      "@type": "GeoCircle", // area1
      "geoMidpoint": {
        "@type": "GeoCoordinates",
        "latitude": "42.362757",
        "longitude": "-71.087109"
      },
      "geoRadius": "10000"
    },
    {
      "@type": "Place", // area2
      "address": {
        "@type": "PostalAddress",
        "postalCode": "94041",
        "addressCountry": "US"
      }
    },
    {
      "@type": "GeoShape", // area3
      // Specify latitude first (i.e., lat long lat long ...)
      "polygon": "37.418128 -122.098167 37.382755 -122.118968 37.368551 -122.047978 37.400949 -122.048106 37.418128 -122.098167"
    },
    {
      "@type": "GeoShape", // area4
      // Specify latitude first (i.e., lat long lat long ...)
      "polygon": "37.806000 -122.425592 37.775849 -122.419043 37.795547 -122.394046 37.808747 -122.412619"
    },
    {
      "@type": "GeoCircle", // area5
      "geoMidpoint": {
        "@type": "GeoCoordinates",
        "latitude": "37.7392607",
        "longitude": "-122.3895522"
      },
      "geoRadius": "4505"
    }
  ],
  "offers": {
    "@type": "Offer",
    "priceSpecification": [{
        "@type": "DeliveryChargeSpecification",
        "@id": "http://www.provider.com/threebrotherstacos/deliveryfee/1",
        "price": "8.00", // Charges $8 for area5
        "priceCurrency": "USD",
        "eligibleTransactionVolume": {
          "@type": "PriceSpecification",
          "minPrice": "20.00",
          "priceCurrency": "USD"
        },
        "eligibleRegion": [ // area5
          {
            "@type": "GeoCircle",
            "geoMidpoint": {
              "@type": "GeoCoordinates",
              "latitude": "37.7392607",
              "longitude": "-122.3895522"
            },
            "geoRadius": "4505"
          }
        ]
      },
      {
        "@type": "DeliveryChargeSpecification",
        "@id": "http://www.provider.com/threebrotherstacos/defaultdeliveryfee",
        "price": "6.00", // Charges $6 when delivered from Foo restaurant to area1, area2, area3 and area4 (Default charge)
        "priceCurrency": "USD",
        "eligibleTransactionVolume": {
          "@type": "PriceSpecification",
          "minPrice": "20.00", // Minimum order price for delivery is $20
          "priceCurrency": "USD"
        }
      }
    ]
  }
},

Service エンティティのその他の例については、サービス フィードの例をご覧ください。

ServiceDeliveryHoursSpecification

ユーザーができるだけ早く注文の配送をスケジュール設定する際の納品時間を表します データ エクスポートを利用できます。

通常、opens の値は closes の値よりも小さくなります。「 opens プロパティと closes プロパティを使用する場合は、次のガイドラインが適用されます。

  • opens プロパティと closes プロパティは、 ServiceDeliveryHoursSpecification になりますが、 できます。
  • 時刻はサービスの現地時間で指定する必要があります。コメントに opens または closes 値。タイムゾーンを指定すると、Google は タイムゾーン情報は無視されます。
  • openscloses が明示的に指定されていない場合は、できるだけ早く いつでも利用できます
  • openscloses が同じ場合、「できるだけ早く」の順序とみなされます。 できません。
  • openscloses より大きい場合、終了時刻は「当日配達」と解釈されます 翌日配達します。たとえば、営業時間を 1 月 1 日(太平洋時間)に設定されていて、 午後 5 時、閉店時間が午前 2 時の場合、レストランは次のように解釈されます。 1 月 2 日午前 2 時閉店です

次の表に、 ServiceDeliveryHoursSpecification 型:

プロパティ タイプ 必要性 説明
@type テキスト 必須 常に「ServiceDeliveryHoursSpecification」です。
validFrom DateTime 省略可

ユーザーが操作を行った日時(タイムゾーンを含む)[ASAP]の注文は 処理されます。例: 2017-05-01T07:00:00-07:00このプロパティが 未設定の場合、毎日有効と見なされます。

詳細については、次をご覧ください: 日時形式

validThrough DateTime 省略可

タイムゾーンを含むできるだけ早く注文 達成できません例: 2017-05-01T07:00:00-07:00条件 このプロパティが設定されていない場合は、毎日有効と見なされます。

validThrough の時刻は指定できません。たとえば 時刻が午後 6 時に設定されている場合、時刻は午後 5 時 59 分 59 秒まで有効です。

詳細については、次をご覧ください: 日時形式

opens Time 省略可

ユーザーの配送サービスが注文はできるだけ早く 処理されます。例: 「T10:30:00」

時刻はサービスの現地時間で指定する必要があります。禁止事項 opens 値にタイムゾーンを含める。タイムゾーンが Google では無視されます。

詳細については、次をご覧ください: 日時形式

closes Time 省略可

ユーザーの配送サービスが「ASAP」の注文はサポートされなくなりました できます。例: 「T23:59:59」

closes の時刻は指定できません。そのため、 このServiceDeliveryHoursSpecificationの開閉時間 午後 10 時と午後 4 時に 最後の注文は午後 3 時 59 分 59 秒です

時刻はサービスの現地時間で指定する必要があります。禁止事項 closes 値にタイムゾーンを含める。タイムゾーンが Google では無視されます。

詳細については、次をご覧ください: 日時形式

dayOfWeek DayOfWeek の配列 省略可

ユーザーがこのサービスを使用できる曜日注文はできるだけ早く 有効な値は次のとおりです。

  • 「月曜日」
  • 「火曜日」
  • 「水曜日」
  • 「木曜日」
  • 「金曜日」
  • 「土曜日」
  • "日曜日"

曜日を指定しない場合、 ServiceDeliveryHoursSpecification はすべての曜日に適用されます。

deliveryLeadTime QuantitativeValue 省略可 配送予定日(分単位、注文処理後) あります。このプロパティを設定することを強くおすすめします。 QuantitativeValuevalue フィールドを数値に追加する unitCode を「MIN」に設定します。

次の例は、ServiceDeliveryHoursSpecification 要素を示しています。

例 1

{
  "@type": "ServiceDeliveryHoursSpecification",
  "opens": "T08:00:00",
  "closes": "T17:00:00",
  "deliveryLeadTime": {
    "@type": "QuantitativeValue",
    "value": "60", // If no exact deliveryLeadTime, put a maximum time
    "unitCode": "MIN"
  }
},

例 2

{
  "@type": "ServiceDeliveryHoursSpecification",
  "opens": "T08:00:00",
  "closes": "T17:00:00",
  "deliveryLeadTime": {
    "@type": "QuantitativeValue",
    "minValue": "30",
    "maxValue": "50",
    "unitCode": "MIN"
  }
}
    

列挙型

RestrictedDiet

RestrictedDiet 型には次の値を使用できます。

  • http://schema.org/DiabeticDiet
  • http://schema.org/GlutenFreeDiet
  • http://schema.org/HalalDiet
  • http://schema.org/HinduDiet
  • http://schema.org/KosherDiet
  • http://schema.org/LowCalorieDiet
  • http://schema.org/LowFatDiet
  • http://schema.org/LowLactoseDiet
  • http://schema.org/LowSaltDiet
  • http://schema.org/VeganDiet
  • http://schema.org/VegetarianDiet