พร็อพเพอร์ตี้มาร์กอัปเนื้อหาของภาพยนตร์

ส่วนนี้จะแสดงรายละเอียดของพร็อพเพอร์ตี้มาร์กอัปเนื้อหาสำหรับประเภทเอนทิตี Movie

ตารางข้อมูลจำเพาะ

พร็อพเพอร์ตี้ ประเภทที่คาดหวัง คำอธิบาย
@context Text ต้องระบุ - ตั้งค่าเป็น ["http://schema.org", {"@language": "xx"}]
    เสมอ
  • โดยที่"xx" แสดงถึงภาษาของสตริงในฟีด บริบทเอนทิตีรูทแต่ละรายการควรตั้งค่า @language เป็นรหัสภาษาที่เหมาะสมในรูปแบบ BCP 47 เช่น หากตั้งค่าภาษาเป็นภาษาสเปน ระบบจะถือว่าชื่อเป็นภาษาสเปน แม้ว่าภาษาของคำบรรยาย/เสียงพากย์จะเป็นภาษาอังกฤษก็ตาม
@type Text ต้องระบุ - ตั้งค่าเป็น Movie เสมอสำหรับภาพยนตร์
@id URL ต้องระบุ - ตัวระบุเนื้อหาในรูปแบบ URI เช่น https://example.com/1234abc
@id ต้องเป็นไปตามข้อกำหนดต่อไปนี้
  • ไม่ซ้ำกันทั่วโลกในแคตตาล็อก
  • แบบคงที่ รหัสต้องคงที่และไม่มีการเปลี่ยนแปลงเมื่อเวลาผ่านไป (แม้ว่าพร็อพเพอร์ตี้ URL ของรายการจะเปลี่ยนแปลงก็ตาม) ระบบจะถือว่า URL นั้นเป็นสตริงที่คลุมเครือและไม่จำเป็นต้องเป็นลิงก์ที่ใช้งานได้
  • ในรูปแบบของ Unified Resource Identifier (URI)
  • โดเมนที่ใช้สำหรับค่า @id ต้องเป็นขององค์กรคุณ
เนื่องจาก url ของเอนทิตีโฟมเป็นไปตามข้อกําหนดทั้งหมดในฐานะตัวระบุ เราจึงขอแนะนําให้คุณใช้ url ของเอนทิตีโฟมเป็น @id ดูรายละเอียดเพิ่มเติมได้ที่ส่วนตัวระบุ
url URL ต้องระบุ - Canonical URL ของเนื้อหา ซึ่ง Google จะใช้จับคู่เนื้อหาในฟีดกับเนื้อหาในฐานข้อมูลของ Google
url ต้องเป็นไปตามข้อกำหนดต่อไปนี้
  • url ต้องไม่ซ้ำกันทั่วโลก
  • url ต้องมี Canonical URL ที่ใช้งานได้ซึ่ง Google ทำการ Crawl ได้
สำหรับ Deep Link ของการเล่น ให้ดูพร็อพเพอร์ตี้ urlTemplate ของออบเจ็กต์ target แทน
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" ซึ่งมี EIDR ของชื่อเป็น "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 การดำเนินการเพื่อรับชม ต้องระบุหากมี - ออบเจ็กต์มาร์กอัปการดําเนินการที่ระบุรายละเอียดของการดําเนินการ
  • หากเนื้อหามีให้บริการบนวิดีโอออนดีมานด์ (VoD) คุณต้องใช้พร็อพเพอร์ตี้นี้ โดยออบเจ็กต์มาร์กอัปการดําเนินการต้องระบุDeep Link ของเนื้อหา
  • หากเนื้อหามีอยู่ในช่อง LiveTV คุณจะใช้พร็อพเพอร์ตี้นี้หรือไม่ก็ได้ โดยเอนทิตี BroadcastService ที่เชื่อมโยงจะระบุ Deep Link ของช่องแทน
  • Movie พร้อมให้บริการทั้งใน VOD และ LiveTV
ใช้อาร์เรย์เพื่อระบุ Deep Link ที่แตกต่างกันในหลายภูมิภาค ดูตัวอย่างหลายภูมิภาคและหลายภาษา
sameAs URL แนะนำอย่างยิ่ง เหตุผล URL ของหน้าเว็บอ้างอิงที่ระบุภาพยนตร์ได้ เช่น หน้า Wikipedia ของภาพยนตร์ ซึ่งต้องแตกต่างจากพร็อพเพอร์ตี้ url
inLanguage Text ภาษาต้นฉบับของภาพยนตร์ในรูปแบบ BCP 47
genre Text รายการประเภทที่เกี่ยวข้องทั้งหมดที่จัดเรียงตามลําดับ เช่น ["แอ็กชัน", "แฟชั่น", "สิ่งแวดล้อม", "ฟุตบอล"]
keywords Text คีย์เวิร์ดหรือแท็กที่ใช้อธิบายเนื้อหานี้ นอกจากนี้ คุณยังใช้อาร์เรย์คีย์เวิร์ดได้ด้วย เช่น ["feature, biography"] อาจเป็นอาร์เรย์ของคีย์เวิร์ดเพื่ออธิบายเนื้อหา
releasedEvent PublicationEvent, FeaturedEvent หรือ ExclusiveEvent แนะนำอย่างยิ่ง เหตุผล - PublicationEvent ใช้เพื่อระบุการเผยแพร่เนื้อหาครั้งแรก (ทั่วโลกหรือในประเทศ) โดยผู้เผยแพร่ เช่น วันที่เผยแพร่ภาพยนตร์ครั้งแรกในโรงภาพยนตร์

นอกจากนี้ ให้ใช้ FeaturedEvent เพื่อระบุว่าบริการของคุณทําการตลาดเนื้อหานี้ว่าเป็นเนื้อหาต้นฉบับ แนะนํา พิเศษ และอื่นๆ

ExclusiveEvent ระบุว่าบริการของคุณมีสิทธิ์จัดจําหน่ายแต่เพียงผู้เดียว รวมถึงระบุสถานที่และเวลา

ดูรายละเอียดและตัวอย่างได้ที่ส่วนตัวอย่าง
releasedEvent.@type Text ต้องระบุ - โปรดตั้งค่าพร็อพเพอร์ตี้นี้เป็นค่าใดค่าหนึ่งต่อไปนี้เสมอ
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
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 รูปแบบต่อไปนี้
  • โดยหน่วยงานจัดประเภทจะใส่ไว้ข้างหน้าคะแนนโดยมีเว้นวรรคคั่นไว้ เช่น การจัดประเภท "PG-13" จากหน่วยงาน "MPAA" ในสหรัฐอเมริกาควรอธิบายเป็น "MPAA PG-13" ดูรายชื่อเอเจนซี
  • ค่า "RATING NOT KNOWN" (ไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่) เพื่อระบุว่าคุณไม่ทราบการจัดประเภทของภาพยนตร์
contentRating.author องค์กร ต้องระบุหาก 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 ประเทศ ภูมิภาคที่ใช้คะแนนความนิยมนี้ได้ หากคะแนนความนิยมใช้ได้ทั่วโลก ให้ตั้งค่าเป็น EARTH โดยค่าเริ่มต้น ระบบจะตั้งค่าพร็อพเพอร์ตี้นี้เป็น EARTH
Note: ความนิยมเฉพาะภาษาจะมีลำดับความสำคัญเหนือความนิยมทั่วโลก (EARTH)
category Text ต้องระบุหากมี - ป้อนข้อมูลในพร็อพเพอร์ตี้นี้หากเอนทิตีเป็นผลิตภัณฑ์ย่อย Movie ตั้งค่า category เป็นค่าใดค่าหนึ่งต่อไปนี้
  • Home Release: เวอร์ชันที่ขายหรือเช่าเพื่อรับชมที่บ้าน
  • Theatrical Release: เวอร์ชันที่ฉายในโรงภาพยนตร์
  • International Release: เวอร์ชันที่ตัดต่อเพื่อเผยแพร่ในระดับนานาชาติ
  • Remastered: เวอร์ชันที่ปรับปรุงรูปภาพ เสียง หรือทั้ง 2 อย่างให้เป็นไปตามมาตรฐานที่ทันสมัยยิ่งขึ้น
  • Unrated: เวอร์ชันที่ MPAA หรือหน่วยงานที่คล้ายกันไม่ได้ตรวจสอบ
  • Director Cut: เวอร์ชันที่แสดงการแก้ไขที่ผ่านการอนุมัติของผู้กำกับเอง
  • Extended Cut: เวอร์ชันที่ยาวกว่าเวอร์ชันที่ฉายในโรงภาพยนตร์
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 ต้องระบุ - ประเภทของภาพยนตร์ย่อยของเวอร์ชันหนึ่งๆ ตั้งค่าหมวดหมู่เป็นอย่างใดอย่างหนึ่งต่อไปนี้
  • Home Release: เวอร์ชันที่ขายหรือเช่าเพื่อรับชมที่บ้าน
  • Theatrical Release: เวอร์ชันที่ฉายในโรงภาพยนตร์
  • International Release: เวอร์ชันที่ตัดต่อเพื่อเผยแพร่ในระดับนานาชาติ
  • Remastered: เวอร์ชันที่ปรับปรุงรูปภาพ เสียง หรือทั้ง 2 อย่างให้เป็นไปตามมาตรฐานที่ทันสมัยยิ่งขึ้น
  • Unrated: เวอร์ชันที่ MPAA หรือหน่วยงานที่คล้ายกันไม่ได้ตรวจสอบ
  • Director Cut: เวอร์ชันที่แสดงการแก้ไขที่ผ่านการอนุมัติของผู้กำกับเอง
  • 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"
  }
}

ตัวแปรของเวอร์ชันขยาย

ภาพยนตร์หลักเวอร์ชันฉบับขยาย

{
  "@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"
}

ดูหัวข้อที่เกี่ยวข้องกับพร็อพเพอร์ตี้เหล่านี้ได้ในหน้าต่อไปนี้