AggregateOffer: AggregateOffer

Description Usage Arguments Value

Description

When a single product is associated with multiple offers (for example, the same pair of shoes is offered by different merchants), then AggregateOffer can be used.

Usage

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
AggregateOffer(id = NULL, offers = NULL, offerCount = NULL,
  lowPrice = NULL, highPrice = NULL, warranty = NULL,
  validThrough = NULL, validFrom = NULL, sku = NULL,
  serialNumber = NULL, seller = NULL, reviews = NULL, review = NULL,
  priceValidUntil = NULL, priceSpecification = NULL, priceCurrency = NULL,
  price = NULL, offeredBy = NULL, mpn = NULL, itemOffered = NULL,
  itemCondition = NULL, inventoryLevel = NULL, ineligibleRegion = NULL,
  includesObject = NULL, gtin8 = NULL, gtin14 = NULL, gtin13 = NULL,
  gtin12 = NULL, eligibleTransactionVolume = NULL, eligibleRegion = NULL,
  eligibleQuantity = NULL, eligibleDuration = NULL,
  eligibleCustomerType = NULL, deliveryLeadTime = NULL, category = NULL,
  businessFunction = NULL, availableDeliveryMethod = NULL,
  availableAtOrFrom = NULL, availabilityStarts = NULL,
  availabilityEnds = NULL, availability = NULL, areaServed = NULL,
  aggregateRating = NULL, advanceBookingRequirement = NULL, addOn = NULL,
  acceptedPaymentMethod = NULL, url = NULL, sameAs = NULL,
  potentialAction = NULL, name = NULL, mainEntityOfPage = NULL,
  image = NULL, identifier = NULL, disambiguatingDescription = NULL,
  description = NULL, alternateName = NULL, additionalType = NULL)

Arguments

id

identifier for the object (URI)

offers

(Offer or Offer or Offer or Offer or Offer or Offer or Offer type.) An offer to provide this item—for example, an offer to sell a product, rent the DVD of a movie, perform a service, or give away tickets to an event.

offerCount

(Integer type.) The number of offers for the product.

lowPrice

(Text or Number type.) The lowest price of all offers available.

highPrice

(Text or Number type.) The highest price of all offers available.

warranty

(WarrantyPromise or WarrantyPromise type.) The warranty promise(s) included in the offer.

validThrough

(DateTime or DateTime or DateTime or DateTime or DateTime or DateTime or DateTime type.) The date after when the item is not valid. For example the end of an offer, salary period, or a period of opening hours.

validFrom

(DateTime or DateTime or DateTime or DateTime or DateTime or DateTime or DateTime type.) The date when the item becomes valid.

sku

(Text or Text or Text type.) The Stock Keeping Unit (SKU), i.e. a merchant-specific identifier for a product or service, or the product to which the offer refers.

serialNumber

(Text or Text or Text type.) The serial number or any alphanumeric identifier of a particular product. When attached to an offer, it is a shortcut for the serial number of the product included in the offer.

seller

(Person or Organization or Person or Organization or Person or Organization or Person or Organization or Person or Organization type.) An entity which offers (sells / leases / lends / loans) the services / goods. A seller may also be a provider.

reviews

(Review or Review or Review or Review or Review type.) Review of the item.

review

(Review or Review or Review or Review or Review or Review or Review or Review type.) A review of the item.

priceValidUntil

(Date type.) The date after which the price is no longer available.

priceSpecification

(PriceSpecification or PriceSpecification or PriceSpecification type.) One or more detailed price specifications, indicating the unit price and delivery or payment charges.

priceCurrency

(Text or Text or Text or Text type.) The currency of the price, or a price component when attached to [[PriceSpecification]] and its subtypes.Use standard formats: [ISO 4217 currency format](http://en.wikipedia.org/wiki/ISO_4217) e.g. "USD"; [Ticker symbol](https://en.wikipedia.org/wiki/List_of_cryptocurrencies) for cryptocurrencies e.g. "BTC"; well known names for [Local Exchange Tradings Systems](https://en.wikipedia.org/wiki/Local_exchange_trading_system) (LETS) and other currency types e.g. "Ithaca HOUR".

price

(Text or Number or Text or Number or Text or Number type.) The offer price of a product, or of a price component when attached to PriceSpecification and its subtypes.Usage guidelines:* Use the [[priceCurrency]] property (with standard formats: [ISO 4217 currency format](http://en.wikipedia.org/wiki/ISO_4217) e.g. "USD"; [Ticker symbol](https://en.wikipedia.org/wiki/List_of_cryptocurrencies) for cryptocurrencies e.g. "BTC"; well known names for [Local Exchange Tradings Systems](https://en.wikipedia.org/wiki/Local_exchange_trading_system) (LETS) and other currency types e.g. "Ithaca HOUR") instead of including [ambiguous symbols](http://en.wikipedia.org/wiki/Dollar_sign#Currencies_that_use_the_dollar_or_peso_sign) such as '$' in the value.* Use '.' (Unicode 'FULL STOP' (U+002E)) rather than ',' to indicate a decimal point. Avoid using these symbols as a readability separator.* Note that both [RDFa](http://www.w3.org/TR/xhtml-rdfa-primer/#using-the-content-attribute) and Microdata syntax allow the use of a "content=" attribute for publishing simple machine-readable values alongside more human-friendly formatting.* Use values from 0123456789 (Unicode 'DIGIT ZERO' (U+0030) to 'DIGIT NINE' (U+0039)) rather than superficially similiar Unicode symbols.

offeredBy

(Person or Organization type.) A pointer to the organization or person making the offer.

mpn

(Text or Text or Text type.) The Manufacturer Part Number (MPN) of the product, or the product to which the offer refers.

itemOffered

(Service or Product or Service or Product type.) The item being offered.

itemCondition

(OfferItemCondition or OfferItemCondition or OfferItemCondition type.) A predefined value from OfferItemCondition or a textual description of the condition of the product or service, or the products or services included in the offer.

inventoryLevel

(QuantitativeValue or QuantitativeValue or QuantitativeValue type.) The current approximate inventory level for the item or items.

ineligibleRegion

(Text or Place or GeoShape or Text or Place or GeoShape or Text or Place or GeoShape type.) The ISO 3166-1 (ISO 3166-1 alpha-2) or ISO 3166-2 code, the place, or the GeoShape for the geo-political region(s) for which the offer or delivery charge specification is not valid, e.g. a region where the transaction is not allowed.See also [[eligibleRegion]].

includesObject

(TypeAndQuantityNode or TypeAndQuantityNode type.) This links to a node or nodes indicating the exact quantity of the products included in the offer.

gtin8

(Text or Text or Text type.) The [GTIN-8](http://apps.gs1.org/GDD/glossary/Pages/GTIN-8.aspx) code of the product, or the product to which the offer refers. This code is also known as EAN/UCC-8 or 8-digit EAN. See [GS1 GTIN Summary](http://www.gs1.org/barcodes/technical/idkeys/gtin) for more details.

gtin14

(Text or Text or Text type.) The [GTIN-14](http://apps.gs1.org/GDD/glossary/Pages/GTIN-14.aspx) code of the product, or the product to which the offer refers. See [GS1 GTIN Summary](http://www.gs1.org/barcodes/technical/idkeys/gtin) for more details.

gtin13

(Text or Text or Text type.) The [GTIN-13](http://apps.gs1.org/GDD/glossary/Pages/GTIN-13.aspx) code of the product, or the product to which the offer refers. This is equivalent to 13-digit ISBN codes and EAN UCC-13. Former 12-digit UPC codes can be converted into a GTIN-13 code by simply adding a preceeding zero. See [GS1 GTIN Summary](http://www.gs1.org/barcodes/technical/idkeys/gtin) for more details.

gtin12

(Text or Text or Text type.) The [GTIN-12](http://apps.gs1.org/GDD/glossary/Pages/GTIN-12.aspx) code of the product, or the product to which the offer refers. The GTIN-12 is the 12-digit GS1 Identification Key composed of a U.P.C. Company Prefix, Item Reference, and Check Digit used to identify trade items. See [GS1 GTIN Summary](http://www.gs1.org/barcodes/technical/idkeys/gtin) for more details.

eligibleTransactionVolume

(PriceSpecification or PriceSpecification or PriceSpecification type.) The transaction volume, in a monetary unit, for which the offer or price specification is valid, e.g. for indicating a minimal purchasing volume, to express free shipping above a certain order volume, or to limit the acceptance of credit cards to purchases to a certain minimal amount.

eligibleRegion

(Text or Place or GeoShape or Text or Place or GeoShape or Text or Place or GeoShape type.) The ISO 3166-1 (ISO 3166-1 alpha-2) or ISO 3166-2 code, the place, or the GeoShape for the geo-political region(s) for which the offer or delivery charge specification is valid.See also [[ineligibleRegion]].

eligibleQuantity

(QuantitativeValue or QuantitativeValue or QuantitativeValue type.) The interval and unit of measurement of ordering quantities for which the offer or price specification is valid. This allows e.g. specifying that a certain freight charge is valid only for a certain quantity.

eligibleDuration

(QuantitativeValue or QuantitativeValue type.) The duration for which the given offer is valid.

eligibleCustomerType

(BusinessEntityType or BusinessEntityType type.) The type(s) of customers for which the given offer is valid.

deliveryLeadTime

(QuantitativeValue or QuantitativeValue type.) The typical delay between the receipt of the order and the goods either leaving the warehouse or being prepared for pickup, in case the delivery method is on site pickup.

category

(Thing or Text or Thing or Text or Thing or Text or Thing or Text type.) A category for the item. Greater signs or slashes can be used to informally indicate a category hierarchy.

businessFunction

(BusinessFunction or BusinessFunction or BusinessFunction type.) The business function (e.g. sell, lease, repair, dispose) of the offer or component of a bundle (TypeAndQuantityNode). The default is http://purl.org/goodrelations/v1#Sell.

availableDeliveryMethod

(DeliveryMethod or DeliveryMethod type.) The delivery method(s) available for this offer.

availableAtOrFrom

(Place or Place type.) The place(s) from which the offer can be obtained (e.g. store locations).

availabilityStarts

(DateTime or DateTime type.) The beginning of the availability of the product or service included in the offer.

availabilityEnds

(DateTime or DateTime type.) The end of the availability of the product or service included in the offer.

availability

(ItemAvailability or ItemAvailability type.) The availability of this item—for example In stock, Out of stock, Pre-order, etc.

areaServed

(Text or Place or GeoShape or AdministrativeArea or Text or Place or GeoShape or AdministrativeArea or Text or Place or GeoShape or AdministrativeArea or Text or Place or GeoShape or AdministrativeArea or Text or Place or GeoShape or AdministrativeArea or Text or Place or GeoShape or AdministrativeArea type.) The geographic area where a service or offered item is provided.

aggregateRating

(AggregateRating or AggregateRating or AggregateRating or AggregateRating or AggregateRating or AggregateRating or AggregateRating or AggregateRating type.) The overall rating, based on a collection of reviews or ratings, of the item.

advanceBookingRequirement

(QuantitativeValue or QuantitativeValue type.) The amount of time that is required between accepting the offer and the actual usage of the resource or service.

addOn

(Offer type.) An additional offer that can only be obtained in combination with the first base offer (e.g. supplements and extensions that are available for a surcharge).

acceptedPaymentMethod

(PaymentMethod or LoanOrCredit or PaymentMethod or LoanOrCredit type.) The payment method(s) accepted by seller for this offer.

url

(URL type.) URL of the item.

sameAs

(URL type.) URL of a reference Web page that unambiguously indicates the item's identity. E.g. the URL of the item's Wikipedia page, Wikidata entry, or official website.

potentialAction

(Action type.) Indicates a potential Action, which describes an idealized action in which this thing would play an 'object' role.

name

(Text type.) The name of the item.

mainEntityOfPage

(URL or CreativeWork type.) Indicates a page (or other CreativeWork) for which this thing is the main entity being described. See [background notes](/docs/datamodel.html#mainEntityBackground) for details.

image

(URL or ImageObject type.) An image of the item. This can be a [[URL]] or a fully described [[ImageObject]].

identifier

(URL or Text or PropertyValue type.) The identifier property represents any kind of identifier for any kind of [[Thing]], such as ISBNs, GTIN codes, UUIDs etc. Schema.org provides dedicated properties for representing many of these, either as textual strings or as URL (URI) links. See [background notes](/docs/datamodel.html#identifierBg) for more details.

disambiguatingDescription

(Text type.) A sub property of description. A short description of the item used to disambiguate from other, similar items. Information from other properties (in particular, name) may be necessary for the description to be useful for disambiguation.

description

(Text type.) A description of the item.

alternateName

(Text type.) An alias for the item.

additionalType

(URL type.) An additional type for the item, typically used for adding more specific types from external vocabularies in microdata syntax. This is a relationship between something and a class that the thing is in. In RDFa syntax, it is better to use the native RDFa syntax - the 'typeof' attribute - for multiple types. Schema.org tools may have only weaker understanding of extra types, in particular those defined externally.

Value

a list object corresponding to a schema:AggregateOffer


cboettig/schemar documentation built on May 20, 2019, 4:27 p.m.