タイプ（basic）

公式で見る

AggregateOffer

集約オファー

単一の製品が複数のオファーに関連付けられている場合（たとえば、同じ靴が異なる販売者によって提供されている場合）、AggregateOfferを使用できます。

注：AggregateOfferは通常、同じ定義済みのbusinessFunction値を共有する複数のオファーを関連付けるか、businessFunctionが明示的に定義されていない場合はhttp://purl.org/goodrelations/v1#Sellをデフォルトとすることが想定されています。

タイプの継承

Thing Intangible Offer AggregateOffer

使用できるプロパティ

  • プロパティ
    値のタイプ
    説明
  • AggregateOfferから継承したプロパティ
  • highPrice
    Number とその子孫
    Text とその子孫
    利用可能なすべてのオファーの最高価格。

    使用ガイドライン:

    • 表面的に類似したUnicode記号ではなく、0123456789（Unicode 'DIGIT ZERO' (U+0030) から 'DIGIT NINE' (U+0039)）の値を使用してください。
    • 小数点を示すには、',' ではなく '.' （Unicode 'FULL STOP' (U+002E)）を使用してください。これらの記号を読みやすさのための区切り文字として使用することは避けてください。
  • lowPrice
    Number とその子孫
    Text とその子孫
    利用可能なすべてのオファーの中で最も低い価格。

    使用ガイドライン：

    • 表面的に類似したUnicode記号ではなく、0123456789（Unicode 'DIGIT ZERO'（U+0030）から'DIGIT NINE'（U+0039））の値を使用します。
    • 小数点を示すには、','ではなく'.'（Unicode 'FULL STOP'（U+002E））を使用します。これらの記号を可読性区切り文字として使用することは避けてください。
  • offerCount
    製品のオファー数。
  • offers
    Demand
    Offer とその子孫
    このアイテムを提供するオファー。たとえば、製品を販売する、映画の DVD をレンタルする、サービスを実行する、またはイベントのチケットをプレゼントするオファー。提供されるトランザクションの種類、つまり販売、リースなどを指定するには、businessFunctionを使用します。このプロパティは、Demandを説明するためにも使用できます。このプロパティは、多くの一般的なタイプで予想されるものとしてリストされていますが、他のタイプでも使用できます。その場合、Product や Product のサブタイプなどの 2 番目のタイプを使用すると、オファーの性質を明確にできます。
  • Offerから継承したプロパティ
  • acceptedPaymentMethod
    LoanOrCredit とその子孫
    PaymentMethod とその子孫
    Text とその子孫
    組織によって、または特定の需要またはオファーに対して一般的に受け入れられる支払い方法。
  • addOn
    Offer とその子孫
    最初の基本オファーと組み合わせてのみ取得できる追加のオファー（例：追加料金で利用できるサプリメントと拡張機能）。
  • additionalProperty
    PropertyValue とその子孫
    エンティティの追加の特性を表すプロパティと値のペア。たとえば、製品の機能や、schema.orgに一致するプロパティがない別の特性などです。

    注：特定のschema.orgプロパティ（https://schema.org/width、https://schema.org/color、https://schema.org/gtin13、...など）を使用するように設計されたアプリケーションは、通常、汎用的なプロパティ/値メカニズムを使用するのではなく、これらのプロパティを使用してデータを提供することを期待することに注意してください。
  • advanceBookingRequirement
    QuantitativeValue とその子孫
    オファーを受け入れてから、リソースまたはサービスの実際の使用までの間に必要な時間。
  • aggregateRating
    AggregateRating とその子孫
    レビューまたは評価のコレクションに基づく、アイテムの全体的な評価。
  • areaServed
    AdministrativeArea とその子孫
    GeoShape とその子孫
    Place とその子孫
    Text とその子孫
    サービスまたは提供されるアイテムが提供される地理的エリア。
  • asin
    Text とその子孫
    URL
    Amazon標準識別番号（ASIN）は、Amazon.comおよびそのパートナーによってAmazon組織内の製品識別用に割り当てられた10文字の英数字一意の識別子です（Wikipediaの記事からの要約）。

    また、これはSchema.orgデータにASINを含める方法の定義であり、一般的なASINの定義ではありません。権威ある詳細については、Amazonのドキュメントを参照してください。 ASINは通常、テキスト文字列としてエンコードされますが、[asin]プロパティはURL/URIも潜在的な値としてサポートしています。
  • availability
    このアイテムの入手可能性—たとえば、在庫あり、在庫切れ、予約注文など。
  • availabilityEnds
    オファーに含まれる製品またはサービスの可用性の終了。
  • availabilityStarts
    オファーに含まれる製品またはサービスの可用性の開始。
  • availableAtOrFrom
    Place とその子孫
    オファーを入手できる場所（店舗の場所など）。
  • availableDeliveryMethod
    このオファーで利用可能な配送方法。
  • businessFunction
    オファーまたはバンドル（TypeAndQuantityNode）のコンポーネントのビジネス機能（販売、リース、修理、廃棄など）。 デフォルトはhttp://purl.org/goodrelations/v1#Sellです。
  • category
    CategoryCode とその子孫
    PhysicalActivityCategory
    Text とその子孫
    Thing とその子孫
    URL
    アイテムのカテゴリ。大なり記号またはスラッシュを使用して、カテゴリ階層を非公式に示すことができます。
  • checkoutPageURLTemplate
    Text とその子孫
    オファーのチェックアウトページのURLテンプレート（RFC 6570）。このアプローチにより、販売者は、ログインしているユーザーID、製品ID、数量、割引コードなどのパラメーターを補間することにより、提供される製品のオンラインチェックアウトのURLを指定できます。パラメーターの名前付けと標準化はここでは指定されていません。
  • deliveryLeadTime
    QuantitativeValue とその子孫
    注文の受領から商品が倉庫から出荷されるか、または配達方法がオンサイトピックアップの場合にピックアップの準備が整うまでの典型的な遅延時間。
  • eligibleCustomerType
    特定のオファーが有効な顧客のタイプ。
  • eligibleDuration
    QuantitativeValue とその子孫
    特定のオファーが有効な期間。
  • eligibleQuantity
    QuantitativeValue とその子孫
    オファーまたは価格仕様が有効な注文数量の間隔と測定単位。これにより、特定の貨物料金が特定の数量に対してのみ有効であることなどを指定できます。
  • eligibleRegion
    GeoShape とその子孫
    Place とその子孫
    Text とその子孫
    オファーまたは配送料の仕様が有効な地理的地域を表すISO 3166-1 (ISO 3166-1 alpha-2) または ISO 3166-2コード、場所、または GeoShape。

    ineligibleRegionも参照してください。
  • eligibleTransactionVolume
    PriceSpecification とその子孫
    オファーまたは価格仕様が有効な金額単位での取引量。例えば、最小購入量を表示したり、特定の注文量を超えると送料無料にしたり、クレジットカードの利用を特定の最小金額の購入に制限したりするために使用します。
  • gtin
    Text とその子孫
    URL
    GTIN（グローバルトレードアイテムナンバー）。GTINは、数値識別コードを使用して、製品やサービスを含む取引アイテムを識別します。

    正しいgtin値は、有効なGTINである必要があります。つまり、8、12、13、または14桁のすべて数値の文字列、またはそのような文字列に基づく「GS1デジタルリンク」URLである必要があります。数値コンポーネントには、有効なGS1チェックデジットも含まれている必要があり、有効なGTINの他のルールを満たしている必要があります。GS1のGTIN概要およびWikipediaも参照してください。gtin値の左側のパディングは必須でも推奨もされていません。gtinプロパティは、以前のgtin8、gtin12、gtin13、およびgtin14プロパティを一般化します。

    GS1 デジタルリンク仕様は、GTINをURL（URI、IRIなど）として表現します。デジタルリンクは、hasGS1DigitalLink属性に入力する必要があります。

    また、これはSchema.orgデータにGTINを含める方法の定義であり、一般的なGTINの定義ではありません。詳細については、GS1ドキュメントを参照してください。
  • gtin12
    Text とその子孫
    製品のGTIN-12コード、またはオファーが参照する製品。GTIN-12は、U.P.C.会社プレフィックス、アイテムリファレンス、および取引アイテムを識別するために使用されるチェックデジットで構成される12桁のGS1識別キーです。詳細については、GS1 GTIN概要を参照してください。
  • gtin13
    Text とその子孫
    製品のGTIN-13コード、またはオファーが参照する製品。これは、13桁のISBNコードおよびEAN UCC-13と同等です。以前の12桁のUPCコードは、先頭にゼロを追加するだけでGTIN-13コードに変換できます。詳細については、GS1 GTIN概要を参照してください。
  • gtin14
    Text とその子孫
    製品のGTIN-14コード、またはオファーが参照する製品。詳細については、GS1 GTIN概要を参照してください。
  • gtin8
    Text とその子孫
    製品のGTIN-8コード、またはオファーが参照する製品。このコードは、EAN / UCC-8または8桁のEANとしても知られています。詳細については、GS1 GTIN概要を参照してください。
  • hasAdultConsideration
    成人による消費または使用を意図または適しているアイテムにタグを付けるために使用されます。
  • hasGS1DigitalLink
    URL
    オブジェクトに関連付けられたGS1デジタルリンク。このURLは、デジタルリンクの特定の要件に準拠している必要があります。リンクには、製品や組織など、注釈が付けられているエンティティに関連するアプリケーション識別子（AI）のみを含める必要があり、正しい粒度で含める必要があります。特に、製品の場合：
    • シリアル番号（AI 21）を含むデジタルリンクは、IndividualProductのインスタンスにのみ存在する必要があります
    • ロット番号（AI 10）を含むデジタルリンクは、そのロットの製品のみが販売されている場合はSomeProductとして、または特定の製品のみが存在する場合はIndividualProductとして注釈を付ける必要があります。
    • グローバルモデル番号（AI 8013）を含むデジタルリンクは、製品またはProductModelにアタッチする必要があります。
    他のアイテムタイプも同様に適合させる必要があります。
  • hasMeasurement
    QuantitativeValue とその子孫
    アイテムの測定値。たとえば、パンツの股下、自転車のホイールサイズ、ネジのゲージ、または当局による認証のために測定されたカーボンフットプリント。通常は正確な測定値ですが、ベルトやスキーバインディングなど、調整可能な製品の測定範囲にすることもできます。
  • hasMerchantReturnPolicy
    適用可能なマーチャント返品ポリシーを指定します。
  • includesObject
    これは、OfferまたはProductCollectionに含まれる製品の正確な数量を示すノードへのリンクです。
  • ineligibleRegion
    GeoShape とその子孫
    Place とその子孫
    Text とその子孫
    ISO 3166-1（ISO 3166-1 alpha-2）またはISO 3166-2コード、場所、またはオファーまたは配送料仕様が無効な地理政治的地域（たとえば、トランザクションが許可されていない地域）のGeoShape。

    eligibleRegionも参照してください。
  • inventoryLevel
    QuantitativeValue とその子孫
    アイテムまたはアイテムの現在の概算在庫レベル。
  • isFamilyFriendly
    Boolean とその子孫
    このコンテンツが家族向けであるかどうかを示します。
  • itemCondition
    製品またはサービスの状態、またはオファーに含まれる製品またはサービスを指定するOfferItemConditionからの定義済みの値。製品の返品ポリシーでも、返品で受け入れられる製品の状態を指定するために使用されます。
  • itemOffered
    AggregateOffer
    CreativeWork とその子孫
    Event とその子孫
    MenuItem
    Product とその子孫
    Service とその子孫
    Trip とその子孫
    提供される（または要求される）アイテム。オファーまたは需要の取引の性質は、businessFunction（例：販売、リースなど）を使用して文書化されます。いくつかの一般的な予想されるタイプがこの定義に明示的にリストされていますが、他のタイプも使用できます。ProductまたはProductのサブタイプなどの2番目のタイプを使用すると、オファーの性質を明確にできます。
  • leaseLength
    Duration
    QuantitativeValue とその子孫
    一部の宿泊施設のリース期間。一部のオファーに固有であるか、場合によってはプロパティに固有です。
  • mobileUrl
    Text とその子孫
    mobileUrlプロパティは、データコンシューマーが提供された複数のURLのいずれかが専用の「モバイルサイト」であるかどうかを判断する必要がある特定の状況で提供されます。

    過度の使用を抑制し、初期のユースケースを反映するために、このプロパティはThingではなく、ProductおよびOfferでのみ想定されています。Webテクノロジーの一般的な傾向は、コンテンツをさまざまな閲覧環境に柔軟に適応させることができるレスポンシブデザインに向かっています。長年確立されているurlプロパティで参照されるページとサイトも、理想的には携帯電話を含むさまざまなデバイスで使用できる必要があります。ほとんどの場合、よりモバイル向けのページに対して、すべてのurlマークアップをmobileUrlを使用するように更新しようとするのは無意味で逆効果です。このプロパティは、アイテム（主にProductおよびOffer）がメインサイトに加えて、追加の「モバイルサイト」でホストされている追加のURLを持っている場合に適しています。この公開スタイルを支持するものとして解釈しないでください。
  • mpn
    Text とその子孫
    製品、またはオファーが参照する製品の製造業者部品番号 (MPN)。
  • offeredBy
    Organization とその子孫
    Person とその子孫
    オファーを行う組織または人へのポインター。
  • price
    Number とその子孫
    Text とその子孫
    製品のオファー価格、またはPriceSpecificationおよびそのサブタイプに添付された価格コンポーネントのオファー価格。

    使用ガイドライン：

    • priceCurrencyプロパティ（標準形式：ISO 4217通貨形式（例："USD"）、ティッカーシンボル（暗号通貨の場合（例："BTC"）、地域交換取引システム（LETS）およびその他の通貨タイプ（例："Ithaca HOUR"）の既知の名前）を、値にあいまいな記号（例：'$'）を含めるのではなく使用してください。
    • 小数点を示すには、','ではなく '.'（Unicode 'FULL STOP'（U+002E））を使用します。これらの記号を可読性セパレーターとして使用しないでください。
    • RDFaとMicrodata構文の両方で、より人間が読みやすいフォーマットと並行して、単純な機械可読値を公開するために「content=」属性を使用できることに注意してください。
    • 表面的に類似したUnicode記号ではなく、0123456789（Unicode 'DIGIT ZERO'（U+0030）から'DIGIT NINE'（U+0039））の値を使用します。
  • priceCurrency
    Text とその子孫
    PriceSpecificationおよびそのサブタイプに添付された場合の価格または価格コンポーネントの通貨。

    標準形式を使用します：ISO 4217通貨形式（例："USD"）、ティッカーシンボル（暗号通貨の場合（例："BTC"）、地域交換取引システム（LETS）およびその他の通貨タイプ（例："Ithaca HOUR"）。
  • priceSpecification
    PriceSpecification とその子孫
    単価および配送または支払い料金を示す、1つ以上の詳細な価格仕様。
  • priceValidUntil
    価格が利用できなくなる日付。
  • review
    Review とその子孫
    アイテムのレビュー。
  • reviews
    Review とその子孫
    アイテムのレビュー。
  • seller
    Organization とその子孫
    Person とその子孫
    サービス/商品を提供する（販売/リース/貸与/ローン）エンティティ。販売者はプロバイダーでもあります。
  • serialNumber
    Text とその子孫
    特定の製品のシリアル番号または任意の英数字識別子。 オファーに添付されている場合、オファーに含まれる製品のシリアル番号のショートカットになります。
  • shippingDetails
    Offerに関連付けられた配送ポリシーとオプションに関する情報を示します。
  • sku
    Text とその子孫
    在庫管理ユニット（SKU）。つまり、製品またはサービス、またはオファーが参照する製品のマーチャント固有の識別子。
  • validForMemberTier
    Offer（またはOfferShippingDetails、PriceSpecification、またはOfferに基づくMerchantReturnPolicy）が有効なメンバーシッププログラムティア。
  • validFrom
    アイテムが有効になる日付。
  • validThrough
    アイテムが有効でなくなる日付。たとえば、オファーの終了、給与期間、または営業時間。
  • warranty
    オファーに含まれる保証。
  • Thingから継承したプロパティ
  • additionalType
    Text とその子孫
    URL
    アイテムの追加のタイプ。通常、マイクロデータ構文で外部語彙からより具体的なタイプを追加するために使用されます。これは、あるものと、そのものが属するクラスとの間の関係です。通常、値はURIで識別されるRDFクラスであり、この場合はRDFでのrdf:typeの使用に対応します。テキスト値は、参照する適切なスキーマがない場合に、有用な情報を追加できる場合にのみ、控えめに使用できます。テキスト値の場合、クラスラベルはschema.org スタイルガイドに従う必要があります。
  • alternateName
    Text とその子孫
    アイテムの別名。
  • description
    Text とその子孫
    TextObject
    アイテムの説明。
  • disambiguatingDescription
    Text とその子孫
    説明のサブプロパティ。他の類似アイテムと区別するために使用されるアイテムの簡単な説明。説明が区別に役立つためには、他のプロパティ（特に名前）からの情報が必要になる場合があります。
  • identifier
    PropertyValue とその子孫
    Text とその子孫
    URL
    identifier プロパティは、ISBN、GTIN コード、UUID など、あらゆる種類のThingのあらゆる種類の識別子を表します。Schema.org は、これらの多くをテキスト文字列または URL (URI) リンクとして表すための専用プロパティを提供しています。背景注記を参照してください。
  • image
    ImageObject とその子孫
    URL
    アイテムの画像。これは、URLまたは完全に記述されたImageObjectにすることができます。
  • mainEntityOfPage
    CreativeWork とその子孫
    URL
    このものが説明されている主要なエンティティであるページ（またはその他のCreativeWork）を示します。背景情報を参照してください。
  • name
    Text とその子孫
    アイテムの名前。
  • potentialAction
    Action とその子孫
    潜在的なアクションを示します。これは、このものが「オブジェクト」の役割を果たす理想化されたアクションを記述します。
  • sameAs
    URL
    アイテムのIDを明確に示す参照WebページのURL。例：アイテムのWikipediaページ、Wikidataエントリ、または公式WebサイトのURL。
  • subjectOf
    CreativeWork とその子孫
    Event とその子孫
    このThingに関するCreativeWorkまたはEvent。
  • url
    URL
    アイテムのURL。

子タイプ

なし

次のプロパティで使用される

itemOffered 提供されるアイテム