104 lines
4.9 KiB
JSON
104 lines
4.9 KiB
JSON
{
|
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
"$id": "schema:Review",
|
|
"title": "Review",
|
|
"description": "A review of an item - for example, of a restaurant, movie, or store.",
|
|
"type": "object",
|
|
"allOf": [
|
|
{
|
|
"description": "The most generic kind of creative work, including books, movies, photographs, software programs, etc.",
|
|
"$ref": "schema:CreativeWork"
|
|
}
|
|
],
|
|
"properties": {
|
|
"associatedClaimReview": {
|
|
"description": "An associated [[ClaimReview]], related by specific common content, topic or claim. The expectation is that this property would be most typically used in cases where a single activity is conducting both claim reviews and media reviews, in which case [[relatedMediaReview]] would commonly be used on a [[ClaimReview]], while [[relatedClaimReview]] would be used on [[MediaReview]].",
|
|
"oneOf": [
|
|
{ "$ref": "schema:Review" },
|
|
{ "type": "array", "items": { "$ref": "schema:Review" } }
|
|
]
|
|
},
|
|
"associatedMediaReview": {
|
|
"description": "An associated [[MediaReview]], related by specific common content, topic or claim. The expectation is that this property would be most typically used in cases where a single activity is conducting both claim reviews and media reviews, in which case [[relatedMediaReview]] would commonly be used on a [[ClaimReview]], while [[relatedClaimReview]] would be used on [[MediaReview]].",
|
|
"oneOf": [
|
|
{ "$ref": "schema:Review" },
|
|
{ "type": "array", "items": { "$ref": "schema:Review" } }
|
|
]
|
|
},
|
|
"associatedReview": {
|
|
"description": "An associated [[Review]].",
|
|
"oneOf": [
|
|
{ "$ref": "schema:Review" },
|
|
{ "type": "array", "items": { "$ref": "schema:Review" } }
|
|
]
|
|
},
|
|
"itemReviewed": {
|
|
"description": "The item that is being reviewed/rated.",
|
|
"$ref": "schema:Thing"
|
|
},
|
|
"negativeNotes": {
|
|
"description": "Provides negative considerations regarding something, most typically in pro/con lists for reviews (alongside [[positiveNotes]]). For symmetry \n\nIn the case of a [[Review]], the property describes the [[itemReviewed]] from the perspective of the review; in the case of a [[Product]], the product itself is being described. Since product descriptions \ntend to emphasise positive claims, it may be relatively unusual to find [[negativeNotes]] used in this way. Nevertheless for the sake of symmetry, [[negativeNotes]] can be used on [[Product]].\n\nThe property values can be expressed either as unstructured text (repeated as necessary), or if ordered, as a list (in which case the most negative is at the beginning of the list).",
|
|
"oneOf": [
|
|
{
|
|
"anyOf": [
|
|
{ "type": "string" },
|
|
{ "$ref": "schema:ItemList" },
|
|
{ "$ref": "schema:ListItem" },
|
|
{ "$ref": "schema:WebContent" }
|
|
]
|
|
},
|
|
{
|
|
"type": "array",
|
|
"items": {
|
|
"anyOf": [
|
|
{ "type": "string" },
|
|
{ "$ref": "schema:ItemList" },
|
|
{ "$ref": "schema:ListItem" },
|
|
{ "$ref": "schema:WebContent" }
|
|
]
|
|
}
|
|
}
|
|
]
|
|
},
|
|
"positiveNotes": {
|
|
"description": "Provides positive considerations regarding something, for example product highlights or (alongside [[negativeNotes]]) pro/con lists for reviews.\n\nIn the case of a [[Review]], the property describes the [[itemReviewed]] from the perspective of the review; in the case of a [[Product]], the product itself is being described.\n\nThe property values can be expressed either as unstructured text (repeated as necessary), or if ordered, as a list (in which case the most positive is at the beginning of the list).",
|
|
"oneOf": [
|
|
{
|
|
"anyOf": [
|
|
{ "type": "string" },
|
|
{ "$ref": "schema:ItemList" },
|
|
{ "$ref": "schema:ListItem" },
|
|
{ "$ref": "schema:WebContent" }
|
|
]
|
|
},
|
|
{
|
|
"type": "array",
|
|
"items": {
|
|
"anyOf": [
|
|
{ "type": "string" },
|
|
{ "$ref": "schema:ItemList" },
|
|
{ "$ref": "schema:ListItem" },
|
|
{ "$ref": "schema:WebContent" }
|
|
]
|
|
}
|
|
}
|
|
]
|
|
},
|
|
"reviewAspect": {
|
|
"description": "This Review or Rating is relevant to this part or facet of the itemReviewed.",
|
|
"oneOf": [
|
|
{ "type": "string" },
|
|
{ "type": "array", "items": { "type": "string" } }
|
|
]
|
|
},
|
|
"reviewBody": {
|
|
"description": "The actual body of the review.",
|
|
"type": "string"
|
|
},
|
|
"reviewRating": {
|
|
"description": "The rating given in this review. Note that reviews can themselves be rated. The ```reviewRating``` applies to rating given by the review. The [[aggregateRating]] property applies to the review itself, as a creative work.",
|
|
"$ref": "schema:Rating"
|
|
}
|
|
}
|
|
}
|