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

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

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

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

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