ส่วนนี้แสดงรายละเอียดของพร็อพเพอร์ตี้มาร์กอัปเนื้อหาสำหรับเอนทิตีประเภท Movie
ตารางข้อกำหนดเฉพาะ
| พร็อพเพอร์ตี้ | ประเภทที่คาดหวัง | คำอธิบาย |
|---|---|---|
@context |
Text | ต้องระบุ - ตั้งค่าเป็น ["http://schema.org", {"@language": "xx"}]
|
@type |
Text | ต้องระบุ - ตั้งค่าเป็น Movie สำหรับภาพยนตร์เสมอ |
@id |
URL | ต้องระบุ - ตัวระบุของเนื้อหาในรูปแบบ URI เช่น https://example.com/1234abc@id ต้องเป็นไปตามข้อกำหนดต่อไปนี้
url ของเอนทิตีเป็นไปตามข้อกำหนดทั้งหมดในฐานะตัวระบุ เราจึงขอแนะนำให้คุณใช้ url ของเอนทิตีเป็น @id ดูรายละเอียดเพิ่มเติมได้ที่ส่วนตัวระบุ |
url |
URL | ต้องระบุ - Canonical URL ของเนื้อหา ซึ่ง Google ใช้เพื่อจับคู่เนื้อหาในฟีดกับเนื้อหาในฐานข้อมูลของ Googleurl ต้องเป็นไปตามข้อกำหนดต่อไปนี้
urlTemplate ของออบเจ็กต์ เป้าหมาย แทน |
name |
Text | ต้องระบุ - ชื่อของภาพยนตร์
|
titleEIDR |
Text | แนะนำอย่างยิ่ง เหตุผล - ตัวระบุ EIDR (Entertainment Identifier Registry) ที่แสดงถึงภาพยนตร์หรือรายการโทรทัศน์ในระดับทั่วไป/นามธรรมมากที่สุด ตัวอย่างเช่น titleEIDR สำหรับภาพยนตร์ที่รู้จักกันในชื่อ "Ghostbusters" คือ "10.5240/7EC7-228A-510A-053E-CBB8-J" |
editEIDR |
Text | แนะนำอย่างยิ่ง เหตุผล - ตัวระบุ EIDR (Entertainment Identifier Registry) ที่แสดงถึงการแก้ไข / ฉบับที่เฉพาะเจาะจงสำหรับภาพยนตร์หรือรายการโทรทัศน์ ตัวอย่างเช่น ภาพยนตร์ที่รู้จักกันในชื่อ "Ghostbusters" ซึ่งมี titleEIDR เป็น "10.5240/7EC7-228A-510A-053E-CBB8-J" มีการแก้ไขหลายรายการ เช่น "10.5240/1F2A-E1C5-680A-14C6-E76B-I" และ "10.5240/8A35-3BEE-6497-5D12-9E4F-3" titleEIDR พร็อพเพอร์ตี้ ต้องระบุ เมื่อมีการระบุ editEIDR |
potentialAction |
WatchAction | ต้องระบุ (หากมี) - ออบเจ็กต์มาร์กอัปการดำเนินการที่แสดงรายละเอียดของการดำเนินการ
|
sameAs |
URL | แนะนำอย่างยิ่ง เหตุผล URL ของหน้าเว็บอ้างอิงที่ระบุภาพยนตร์ได้ เช่น หน้า Wikipedia ของภาพยนตร์ URL นี้ต้องแตกต่างจากพร็อพเพอร์ตี้ url |
inLanguage |
Text | แนะนำอย่างยิ่ง ภาษาต้นฉบับของภาพยนตร์ในรูปแบบ BCP 47 |
genre |
Text | รายการประเภททั้งหมดที่เกี่ยวข้องซึ่งจัดเรียงตามลำดับ เช่น ["Action", "Fashion", "Environment", "Football"] |
keywords |
Text | คีย์เวิร์ดหรือแท็กที่ใช้เพื่ออธิบายเนื้อหานี้ นอกจากนี้ยังอนุญาตให้ใช้อาร์เรย์ของคีย์เวิร์ดได้ด้วย เช่น ["feature, biography"] อาจเป็นอาร์เรย์ของคีย์เวิร์ดที่ใช้อธิบายเนื้อหา |
releasedEvent |
PublicationEvent, FeaturedEvent หรือ ExclusiveEvent |
แนะนำอย่างยิ่ง เหตุผล PublicationEvent ใช้เพื่อระบุการเผยแพร่เนื้อหาครั้งแรก (ทั่วโลกหรือในประเทศ) โดยผู้เผยแพร่เนื้อหา เช่น วันที่เผยแพร่ภาพยนตร์ครั้งแรกในโรงภาพยนตร์นอกจากนี้ ให้ใช้ FeaturedEvent เพื่อระบุว่าบริการของคุณทำการตลาดเนื้อหานี้เป็นเนื้อหาต้นฉบับ เนื้อหาเด่น เนื้อหาพิเศษ และอื่นๆExclusiveEvent ระบุว่าบริการของคุณมีสิทธิในการจัดจำหน่ายแต่เพียงผู้เดียว รวมถึงสถานที่และเวลาดูรายละเอียดและตัวอย่างได้ใน ส่วนตัวอย่าง |
releasedEvent.@type |
Text | ต้องระบุ - โปรดตั้งค่าพร็อพเพอร์ตี้นี้เป็นค่าใดค่าหนึ่งต่อไปนี้เสมอ
|
releasedEvent.location |
Country | ต้องระบุ - ภูมิภาคที่เชื่อมโยงกับเหตุการณ์นี้ สำหรับ PublicationEvent ภูมิภาคนี้คือภูมิภาคที่เผยแพร่เนื้อหาสำหรับ FeaturedEvent และ ExclusiveEvent ภูมิภาคนี้คือภูมิภาคที่เนื้อหาเป็นเนื้อหาเด่นหรือเนื้อหาพิเศษใช้รหัส ISO 3166 สำหรับประเทศ หากต้องการระบุทุกที่ในโลก ให้ตั้งค่าเป็น EARTH |
releasedEvent.startDate |
Date หรือ DateTime | แนะนำ - ต้องระบุสำหรับ ExclusiveEvent - วันที่เริ่มต้นการเผยแพร่ของเอนทิตีสำหรับ PublicationEvent ค่านี้จะระบุวันที่เผยแพร่ครั้งแรกของเอนทิตีนี้ เช่น วันที่เผยแพร่ภาพยนตร์ครั้งแรกในโรงภาพยนตร์สำหรับ ExclusiveEvent และ FeaturedEvent ค่านี้จะแสดงวันที่เริ่มต้นที่เอนทิตีเป็นเนื้อหาพิเศษหรือเนื้อหาเด่น |
releasedEvent.endDate |
Date หรือ DateTime | แนะนำ - ต้องระบุสำหรับ ExclusiveEvent - ค่านี้ใช้ได้กับประเภท ExclusiveEvent และ FeaturedEvent เท่านั้นสำหรับ ExclusiveEvent ค่านี้จะแสดงวันที่สิทธิ์ในเนื้อหาหมดอายุสำหรับ FeaturedEvent ค่านี้จะแสดงวันที่สุดท้ายที่ผู้ให้บริการแสดงเอนทิตีเป็นเนื้อหาเด่นหากเนื้อหาเป็นเนื้อหาพิเศษหรือเนื้อหาเด่นตลอดไป ให้ตั้งค่า endDate เป็น 20 ปีนับจากวันที่ปัจจุบัน |
releasedEvent.publishedBy |
Organization หรือ Person | ไม่บังคับ - องค์กรหรือบุคคลที่เผยแพร่เอนทิตีนี้ |
description |
Text | แนะนำอย่างยิ่ง เหตุผล บทสรุปย่อของภาพยนตร์ เราขอแนะนำให้ใช้บทสรุปย่อของเนื้อเรื่องแทนบทสรุปข้อเท็จจริง จำกัดไว้ที่ 300 อักขระ
|
duration |
Duration | ระยะเวลาการทำงานของภาพยนตร์ในรูปแบบ ISO 8601 โปรดใช้รูปแบบ "PT00H00M" |
director |
Person | แนะนำอย่างยิ่ง เหตุผล ผู้กำกับภาพยนตร์ |
actor |
Person | แนะนำอย่างยิ่ง เหตุผล นักแสดงของภาพยนตร์ |
producer |
Organization หรือ Person | แนะนำอย่างยิ่ง เหตุผล ผู้อำนวยการสร้างภาพยนตร์ |
image |
ImageObject | ต้องระบุสำหรับ Google TV - รูปภาพที่เกี่ยวข้องกับภาพยนตร์ ดูรายละเอียดเพิ่มเติมเกี่ยวกับพร็อพเพอร์ตี้ที่ต้องระบุและไม่บังคับที่จะรวมไว้กับ image ได้ที่ พร็อพเพอร์ตี้รูปภาพ |
trailer.description |
Text | คำอธิบายของตัวอย่าง ดูตัวอย่างตัวอย่าง |
trailer.inLanguage |
Text | แนะนำอย่างยิ่ง ภาษาของตัวอย่างในรูปแบบ BCP 47 |
trailer.url |
URL | URL ของตัวอย่างที่โฮสต์แบบสาธารณะและอัปโหลดโดยสตูดิโอผลิตที่เกี่ยวข้องหรือแหล่งที่มาที่ได้รับอนุญาต |
trailer.regionsAllowed |
Place | ภูมิภาคที่อนุญาตให้ใช้สื่อ หากไม่ได้ระบุไว้ ระบบจะถือว่าอนุญาตทุกภูมิภาค ระบุประเทศในรูปแบบ ISO 3166 |
identifier |
PropertyValue | แนะนำอย่างยิ่ง เหตุผล - รหัสภายนอกหรือรหัสอื่นๆ ที่ระบุเอนทิตีนี้อย่างชัดเจน อนุญาตให้ใช้ตัวระบุได้หลายรายการ ดูรายละเอียดได้ที่ส่วนพร็อพเพอร์ตี้ตัวระบุ |
review |
Review | คะแนนรีวิวสำหรับภาพยนตร์ |
review.reviewRating |
Rating | ต้องระบุหากมีการระบุรีวิว ใช้เพื่อระบุคะแนนที่ให้ในรีวิว |
contentRating |
Text หรือ Rating | ต้องระบุสำหรับเนื้อหาสำหรับผู้ใหญ่ และแนะนำอย่างยิ่งสำหรับเนื้อหาอื่นๆ เหตุผล - การจัดประเภทเนื้อหาโดยรวม หากมีการจัดประเภทเนื้อหาในรูปแบบสตริงข้อความ ระบบจะยอมรับ 2 รูปแบบต่อไปนี้
|
contentRating.author |
Organization | ต้องระบุหาก contentRating ใช้ Rating - ชื่อหน่วยงานการจัดประเภท |
contentRating.ratingValue |
Text | ต้องระบุหาก contentRating ใช้ Rating - ค่าการจัดประเภท |
contentRating.advisoryCode |
Text | รหัสคำแนะนำสำหรับเนื้อหา ค่าที่ยอมรับ ได้แก่ D, FV, L, S และ V โดย D = การสนทนา, FV = ความรุนแรงในจินตนาการ, L = ภาษา, S = เนื้อหาทางเพศ, V = ความรุนแรง |
popularityScore |
PopularityScoreSpecification | แนะนำอย่างยิ่ง เหตุผล คะแนนที่ Google ใช้ร่วมกับสัญญาณอื่นๆ เพื่อกำหนดสื่อที่จะเล่นให้ผู้ใช้ คะแนนนี้แสดงถึงความนิยมของเนื้อหาเมื่อเทียบกับเนื้อหาอื่นๆ ในแคตตาล็อก ดังนั้นมาตราส่วนของคะแนนจึงต้องสอดคล้องกันในฟีดต่างๆ และในเอนทิตีทั้งหมดในแคตตาล็อก โดยค่าเริ่มต้น ระบบจะตั้งค่าคะแนนความนิยมของเอนทิตีเป็น 0 |
popularityScore.@type |
Text | ตั้งค่าเป็น PopularityScoreSpecification เสมอ |
popularityScore.value |
Number | ค่าตัวเลขที่ไม่เป็นลบซึ่งบ่งบอกถึงความนิยมของเอนทิตี โดยคะแนนที่สูงกว่าหมายถึงความนิยมที่สูงกว่า |
popularityScore.eligibleRegion |
Country | ภูมิภาคที่คะแนนความนิยมนี้ใช้ได้ หากคะแนนความนิยมใช้ได้ทั่วโลก ให้ตั้งค่าเป็น EARTH โดยค่าเริ่มต้น พร็อพเพอร์ตี้นี้จะตั้งค่าเป็น EARTH Note: หมายเหตุ: ความนิยมเฉพาะภาษาจะมีลำดับความสำคัญสูงกว่าความนิยมทั่วโลก (EARTH) |
category |
Text | ต้องระบุ (หากมี) - ป้อนข้อมูลในพร็อพเพอร์ตี้นี้หากเอนทิตีเป็นสินค้าย่อยของ Movie ตั้งค่า category เป็นค่าใดค่าหนึ่งต่อไปนี้
|
workExample |
Movie | ระบุสินค้าย่อยของภาพยนตร์ รวมพร็อพเพอร์ตี้นี้ไว้ในเอนทิตี Movie หลัก ไม่ใช่เอนทิตี Movie สำหรับเวอร์ชันสินค้าย่อย |
workExample.@id |
URL | สำหรับสินค้าย่อยของ Movie พร็อพเพอร์ตี้นี้จะระบุ @id ของเอนทิตี Movie ที่สินค้าย่อยนี้เป็นสินค้าย่อยของเอนทิตีดังกล่าว |
workExample.@type |
Text | ต้องระบุ - ตั้งค่าเป็น Movie เสมอ คุณสามารถแสดงพร็อพเพอร์ตี้นี้เป็นอาร์เรย์สำหรับ Movie ที่มีสินค้าย่อยหลายรายการ |
workExample.@id |
URL | ต้องระบุ - @id ของสินค้าย่อยของ Movie |
workExample.name |
Text | ต้องระบุ - ชื่อของสินค้าย่อยของ Movie |
workExample.category |
Text | ต้องระบุ - ประเภทของสินค้าย่อยของภาพยนตร์ในเวอร์ชันหนึ่งๆ ตั้งค่าหมวดหมู่เป็นค่าใดค่าหนึ่งต่อไปนี้
|
ตัวอย่าง
ภาพยนตร์หลัก
ภาพยนตร์ที่มีสินค้าย่อยเวอร์ชัน Extended Cut
{
"@context": ["http://schema.org", {"@language": "en"}],
"@type": "Movie",
"@id": "http://www.example.com/my_favorite_movie",
"url": "http://www.example.com/my_favorite_movie",
"name": "My Favorite Movie",
"potentialAction": {
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
"inLanguage": "en",
"actionPlatform": [
"http://schema.org/DesktopWebPlatform",
"http://schema.org/MobileWebPlatform",
"http://schema.org/AndroidPlatform",
"http://schema.org/AndroidTVPlatform",
"http://schema.org/IOSPlatform",
"http://schema.googleapis.com/GoogleVideoCast"
]
},
"actionAccessibilityRequirement": {
"@type": "ActionAccessSpecification",
"category": "subscription",
"availabilityStarts": "2018-07-21T10:35:29Z",
"availabilityEnds": "2019-10-21T10:35:29Z",
"requiresSubscription": {
"@type": "MediaSubscription",
"name": "Example Package",
"commonTier": true,
"@id": "https://example.com/package/example"
},
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "CA"
}
]
}
},
"sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie",
"contentRating": "RATING NOT KNOWN",
"releasedEvent": {
"@type": "PublicationEvent",
"startDate": "2008-01-20",
"location": {
"@type": "Country",
"name": "US"
}
},
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 78,
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "CA"
}
]
},
"description": "This is my favorite movie.",
"actor": [
{
"@type": "Person",
"name": "John Doe",
"sameAs": "https://en.wikipedia.org/wiki/John_Doe"
},
{
"@type": "Person",
"name": "Jane Doe",
"sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
}
],
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "IMDB_ID",
"value": "tt0123456"
}
],
"workExample": {
"@type": "Movie",
"@id": "http://www.example.com/my_favorite_movie_extended_cut",
"name": "My Favorite Movie Extended Cut"
"category": "Extended Cut"
}
}
สินค้าย่อยเวอร์ชัน Extended Cut
เวอร์ชัน Extended Cut ของภาพยนตร์หลัก
{
"@context": ["http://schema.org", {"@language": "en"}],
"@type": "Movie",
"@id": "http://www.example.com/my_favorite_movie_extended_cut",
"url": "http://www.example.com/my_favorite_movie_extended_cut",
"name": "My Favorite Movie Extended Cut",
"potentialAction": {
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://www.example.com/my_favorite_movie_extended_cut?autoplay=true",
"inLanguage": "en",
"actionPlatform": [
"http://schema.org/DesktopWebPlatform",
"http://schema.org/MobileWebPlatform",
"http://schema.org/AndroidPlatform",
"http://schema.org/AndroidTVPlatform",
"http://schema.org/IOSPlatform",
"http://schema.googleapis.com/GoogleVideoCast"
]
},
"actionAccessibilityRequirement": {
"@type": "ActionAccessSpecification",
"category": "subscription",
"availabilityStarts": "2018-07-21T10:35:29Z",
"availabilityEnds": "2019-10-21T10:35:29Z",
"requiresSubscription": {
"@type": "MediaSubscription",
"name": "Example Package",
"commonTier": true,
"@id": "http://www.example.com/example_package",
"identifier": "example.com:example_package"
},
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "CA"
}
]
}
},
"sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie_extended_cut",
"contentRating": {
"@type": "Rating",
"author": "MPAA",
"ratingValue": "R",
"advisoryCode": "FV"
},
"releasedEvent": {
"@type": "PublicationEvent",
"startDate": "2008-01-20",
"location": {
"@type": "Country",
"name": "US"
}
},
"description": "This is the extended cut of my favorite movie.",
"actor": [
{
"@type": "Person",
"name": "John Doe",
"sameAs": "https://en.wikipedia.org/wiki/John_Doe"
},
{
"@type": "Person",
"name": "Jane Doe",
"sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
}
],
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "IMDB_ID",
"value": "tt0123456"
}
],
"exampleOfWork": {
"@id": "http://www.example.com/my_favorite_movie",
}
"category": "Extended Cut"
}
หน้าที่เกี่ยวข้อง
ดูหน้าต่อไปนี้สำหรับหัวข้อที่เกี่ยวข้องกับพร็อพเพอร์ตี้เหล่านี้