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

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

ตารางข้อกำหนดเฉพาะ

พร็อพเพอร์ตี้ ประเภทที่คาดหวัง คำอธิบาย
@context Text ต้องระบุ - ตั้งค่าเป็น ["http://schema.org", {"@language": "xx"}]
    เสมอ
  • โดย "xx" หมายถึงภาษาของสตริงในฟีด บริบทของเอนทิตีรากแต่ละรายการควรตั้งค่า @language เป็นรหัสภาษาที่เหมาะสมในรูปแบบ BCP 47 ตัวอย่างเช่น หากตั้งค่าภาษาเป็นภาษาสเปน ระบบจะถือว่าชื่อเป็นภาษาสเปน แม้ว่าภาษาคำบรรยาย/ภาษาที่พากย์จะเป็นภาษาอังกฤษก็ตาม
@type Text ต้องระบุ - ตั้งค่าเป็น Movie สำหรับภาพยนตร์เสมอ
@id URL ต้องระบุ - ตัวระบุของเนื้อหาในรูปแบบ URI เช่น https://example.com/1234abc
@id ต้องเป็นไปตามข้อกำหนดต่อไปนี้
  • ไม่ซ้ำกันทั่วโลกในแคตตาล็อกของคุณ
  • คงที่ รหัสควรคงที่และไม่มีการเปลี่ยนแปลงเมื่อเวลาผ่านไป (แม้ว่าพร็อพเพอร์ตี้ URL ของรายการจะเปลี่ยนแปลงไปก็ตาม) โดยจะถือว่าเป็นสตริงที่คลุมเครือและไม่จำเป็นต้องเป็นลิงก์ที่ใช้งานได้
  • อยู่ในรูปแบบ Uniform Resource Identifier (URI)
  • โดเมนที่ใช้สำหรับค่า @id ต้องเป็นขององค์กรคุณ
เนื่องจาก url ของเอนทิตีเป็นไปตามข้อกำหนดทั้งหมดในฐานะตัวระบุ เราจึงขอแนะนำให้คุณใช้ url ของเอนทิตีเป็น @id ดูรายละเอียดเพิ่มเติมได้ที่ส่วนตัวระบุ
url URL ต้องระบุ - Canonical URL ของเนื้อหา ซึ่ง Google ใช้เพื่อจับคู่เนื้อหาในฟีดกับเนื้อหาในฐานข้อมูลของ Google
url ต้องเป็นไปตามข้อกำหนดต่อไปนี้
  • url ต้องไม่ซ้ำกันทั่วโลก
  • url ต้องมี Canonical URL ที่ใช้งานได้ซึ่ง Google รวบรวมข้อมูลได้
สำหรับ Deep Link ของการเล่น โปรดดูพร็อพเพอร์ตี้ urlTemplate ของออบเจ็กต์ เป้าหมาย แทน
name Text ต้องระบุ - ชื่อของภาพยนตร์
  • ใช้อาร์เรย์เพื่อแสดงรายการชื่อในภาษาต่างๆ ดูตัวอย่างหลายภูมิภาคและหลายภาษา
  • โปรดทราบว่าระบบรองรับเพียง 1 ชื่อต่อภาษา (คู่ภาษาและประเทศ)
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 ต้องระบุ (หากมี) - ออบเจ็กต์มาร์กอัปการดำเนินการที่แสดงรายละเอียดของการดำเนินการ
  • หากเนื้อหามีให้บริการในวิดีโอตามความต้องการ (VoD) คุณต้องระบุพร็อพเพอร์ตี้นี้ โดยออบเจ็กต์มาร์กอัปการดำเนินการต้องระบุ Deep Link ของเนื้อหา
  • หากเนื้อหามีให้บริการในช่อง LiveTV คุณไม่จำเป็นต้องระบุพร็อพเพอร์ตี้นี้ โดยเอนทิตี BroadcastService ที่เชื่อมโยงจะระบุ Deep Link ของช่องแทน
  • Movie อาจมีให้บริการทั้งใน VoD และ LiveTV
ใช้อาร์เรย์เพื่อระบุ Deep Link ที่แตกต่างกันในหลายภูมิภาค ดูตัวอย่างหลายภูมิภาคและหลายภาษา
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 ต้องระบุ - โปรดตั้งค่าพร็อพเพอร์ตี้นี้เป็นค่าใดค่าหนึ่งต่อไปนี้เสมอ
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
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 รูปแบบต่อไปนี้
  • หน่วยงานการจัดประเภทที่นำหน้าการจัดประเภทโดยมีช่องว่างคั่น ตัวอย่างเช่น การจัดประเภท "PG-13" จากหน่วยงาน "MPAA" ในสหรัฐอเมริกาควรอธิบายเป็น "MPAA PG-13" ดูรายชื่อหน่วยงาน
  • ค่า "RATING NOT KNOWN" (ไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่) เพื่อระบุว่าคุณไม่ทราบการจัดประเภทของภาพยนตร์
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 เป็นค่าใดค่าหนึ่งต่อไปนี้
  • Home Release: เวอร์ชันที่ขายหรือให้เช่าเพื่อรับชมที่บ้าน
  • Theatrical Release: เวอร์ชันที่เผยแพร่ในโรงภาพยนตร์
  • International Release: เวอร์ชันที่แก้ไขเพื่อเผยแพร่ในต่างประเทศ
  • Remastered: เวอร์ชันที่มีการปรับปรุงรูปภาพ เสียง หรือทั้ง 2 อย่างให้เป็นไปตามมาตรฐานที่ทันสมัยมากขึ้น
  • Unrated: เวอร์ชันที่ MPAA หรือหน่วยงานที่คล้ายกันไม่ได้ตรวจสอบ
  • Director Cut: เวอร์ชันที่แสดงถึงการแก้ไขที่ผู้กำกับอนุมัติเอง
  • Extended Cut: เวอร์ชันที่ยาวกว่าเวอร์ชันที่เผยแพร่ในโรงภาพยนตร์
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 ต้องระบุ - ประเภทของสินค้าย่อยของภาพยนตร์ในเวอร์ชันหนึ่งๆ ตั้งค่าหมวดหมู่เป็นค่าใดค่าหนึ่งต่อไปนี้
  • Home Release: เวอร์ชันที่ขายหรือให้เช่าเพื่อรับชมที่บ้าน
  • Theatrical Release: เวอร์ชันที่เผยแพร่ในโรงภาพยนตร์
  • International Release: เวอร์ชันที่แก้ไขเพื่อเผยแพร่ในต่างประเทศ
  • Remastered: เวอร์ชันที่มีการปรับปรุงรูปภาพ เสียง หรือทั้ง 2 อย่างให้เป็นไปตามมาตรฐานที่ทันสมัยมากขึ้น
  • Unrated: เวอร์ชันที่ MPAA หรือหน่วยงานที่คล้ายกันไม่ได้ตรวจสอบ
  • Director Cut: เวอร์ชันที่แสดงถึงการแก้ไขที่ผู้กำกับอนุมัติเอง
  • Extended 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"
  }
}

สินค้าย่อยเวอร์ชัน 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"
}

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