ส่วนนี้จะให้รายละเอียดพร็อพเพอร์ตี้มาร์กอัปเนื้อหาของประเภท 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 (รีจิสทรีตัวระบุสื่อบันเทิง) ที่นําเสนอในระดับทั่วไป/นามธรรม ผลงานของภาพยนตร์หรือโทรทัศน์ ตัวอย่างเช่น 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-44-44-4-44"44-4"4-4"4-44"4-4"4-44"4-44"44"4"4"44E>4"4E4E44E444E444E4444E44441444ดังกล่าวไว้ในอีกมากมาย เช่น "10.5240/1F2A-44-44-44"4-4-44"44"4-4"44"44ค่า4-4E{/2}" พร็อพเพอร์ตี้ titleEIDR ต้องต้องระบุเมื่อมีการแก้ไข EditEIDR |
potentialAction |
การดำเนินการเพื่อรับชม | ต้องระบุ (หากมี) - ออบเจ็กต์มาร์กอัปการดําเนินการที่ระบุรายละเอียดของการดําเนินการ
|
sameAs |
URL | แนะนําอย่างยิ่ง เพราะเหตุใด URL ไปยังหน้าเว็บอ้างอิงที่สามารถระบุภาพยนตร์ได้ ตัวอย่างเช่น หน้า Wikipedia ของภาพยนตร์ ต้องแตกต่างจากพร็อพเพอร์ตี้ url |
inLanguage |
Text | ภาษาต้นฉบับของภาพยนตร์ในรูปแบบ BCP 47 |
genre |
Text | รายการตามลําดับของประเภทที่เกี่ยวข้องทั้งหมด เช่น ["แอ็กชัน" "แฟชั่น" "สภาพแวดล้อม" "ฟุตบอล"] |
keywords |
Text | คีย์เวิร์ดหรือแท็กที่ใช้อธิบายเนื้อหานี้ นอกจากนี้ยังมีอาร์เรย์ของคีย์เวิร์ดด้วย ตัวอย่างเช่น ["ฟีเจอร์ ชีวประวัติ"] อาจเป็นอาร์เรย์ของคีย์เวิร์ดเพื่ออธิบายเนื้อหา |
releasedEvent |
PublicationEvent , FeaturedEvent หรือ ExclusiveEvent |
แนะนําอย่างยิ่ง เพราะเหตุใด - ใช้ PublicationEvent เพื่อระบุการเผยแพร่เนื้อหาต้นฉบับ (ทั่วโลกหรือในท้องถิ่น) ของผู้เผยแพร่ เช่น วันที่ฉายภาพยนตร์ต้นฉบับใช้ FeaturedEvent เพื่อระบุว่าบริการของคุณทําการตลาดให้เนื้อหานี้เป็นบริการต้นฉบับ วิดีโอเด่น แบบพิเศษ ฯลฯExclusiveEvent ระบุว่าบริการของคุณมีสิทธิ์ในการแจกจ่ายเฉพาะตัวและในเวลาและสถานที่ดูรายละเอียดได้ที่หัวข้อตัวอย่าง |
releasedEvent.@type |
Text | ต้องระบุ - โปรดตรวจสอบว่าตั้งค่าพร็อพเพอร์ตี้นี้เป็นอย่างใดอย่างหนึ่งต่อไปนี้เสมอ:
|
releasedEvent.location |
ประเทศ | ต้องระบุ - ภูมิภาคที่เชื่อมโยงกับกิจกรรมนี้ สําหรับ 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 |
ระยะเวลา | รันไทม์ของภาพยนตร์ในรูปแบบ 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 |
สถานที่ | ภูมิภาคที่อนุญาตสื่อ หากไม่ระบุ ระบบจะถือว่าเนื้อหาได้รับการอนุญาตในทุกที่ ระบุประเทศในรูปแบบ ISO 3166 |
identifier |
PropertyValue | แนะนําอย่างยิ่ง เพราะเหตุใด - รหัสภายนอกหรือรหัสอื่นๆ ที่ระบุเอนทิตีนี้อย่างชัดเจน อนุญาตให้ใช้ตัวระบุได้หลายรายการ โปรดดูรายละเอียดในส่วนคุณสมบัติตัวระบุ |
review |
รีวิว | ตรวจสอบการให้คะแนนภาพยนตร์ |
review.reviewRating |
คะแนน | ต้องระบุหากมีการตรวจสอบ ซึ่งใช้เพื่อระบุคะแนนที่ให้ไว้ในรีวิว |
contentRating |
Text หรือ Rating | ต้องระบุสําหรับเนื้อหาสําหรับผู้ใหญ่ (ไม่บังคับ) แนะนําเพราะอะไร - คะแนนเนื้อหาโดยรวม หากการจัดประเภทเนื้อหาอยู่ในรูปแบบของสตริงข้อความ จะใช้ 2 รูปแบบต่อไปนี้ได้
|
contentRating.author |
Text หรือ Organization | ต้องระบุหาก contentRating ใช้ Rating - ชื่อของตัวแทนการให้คะแนน |
contentRating.ratingValue |
Text | ต้องระบุหาก contentRating ใช้ Rating - ค่าของคะแนน |
contentRating.advisoryCode |
Text | รหัสคําแนะนําสําหรับเนื้อหา ค่าที่ยอมรับ ได้แก่ D, FV, L, S และ V. D = บทสนทนา, FV = ความรุนแรงในจินตนาการ, L = ภาษา, S = เนื้อหาเกี่ยวกับเรื่องเพศ, V = ความรุนแรง |
popularityScore |
ข้อกําหนดเฉพาะของความนิยม | แนะนําอย่างยิ่ง เพราะเหตุใด คะแนนที่ Google ใช้ รวมถึงสัญญาณอื่นๆ เพื่อกําหนดว่าควรเล่นสื่อใดให้กับผู้ใช้ คะแนนนี้แสดงถึงความนิยมของเนื้อหาเมื่อเทียบกับเนื้อหาอื่นๆ ในแคตตาล็อกของคุณ ดังนั้นคะแนนของคะแนนต้องสอดคล้องกันในฟีด รวมถึงเอนทิตีทั้งหมดในแคตตาล็อก ระบบจะกําหนดคะแนนความนิยมของเอนทิตีเป็น 0 ตามค่าเริ่มต้น |
popularityScore.@type |
Text | ตั้งค่าเป็น PopularityScoreSpecification เสมอ |
popularityScore.value |
Number | ค่าตัวเลขที่ไม่เป็นลบซึ่งแสดงถึงความนิยมของเอนทิตี คะแนนที่สูงขึ้นหมายถึงความนิยมที่สูงขึ้น |
popularityScore.eligibleRegion |
ประเทศ | ภูมิภาคที่ใช้คะแนนความนิยมนี้ หากคะแนนความนิยมมีผลบังคับใช้ทั่วโลก ให้ตั้งค่าเป็น EARTH พร็อพเพอร์ตี้นี้ตั้งไว้เป็น EARTH โดยค่าเริ่มต้น Note: ความนิยมเฉพาะสถานที่มีความสําคัญเหนือกว่าความนิยมทั่วโลก (EARTH) |
category |
Text | ต้องระบุ (หากมี) - ป้อนข้อมูลพร็อพเพอร์ตี้นี้หากเอนทิตีเป็นตัวแปร Movie ตั้งค่า category เป็นอย่างใดอย่างหนึ่งต่อไปนี้
|
workExample |
ภาพยนตร์ | ระบุชนิดของฟิล์ม รวมพร็อพเพอร์ตี้นี้ในเอนทิตี 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 | จําเป็น - ประเภทของภาพยนตร์ในเวอร์ชันที่ระบุ ตั้งค่าหมวดหมู่เป็นอย่างใดอย่างหนึ่งต่อไปนี้
|
ตัวอย่าง
ภาพยนตร์หลัก
ภาพยนตร์ที่มีรายละเอียดปลีกย่อยของการตัดเพิ่มเติม
{
"@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"
}
}
เวอร์ชันขยายเพิ่มเติม
เวอร์ชันหลักที่ถูกตัดออกของภาพยนตร์หลัก
{
"@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"
}
หน้าที่เกี่ยวข้อง
ดูหัวข้อต่อไปนี้ซึ่งเกี่ยวข้องกับพร็อพเพอร์ตี้เหล่านี้