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

ส่วนนี้จะแสดงรายละเอียดของพร็อพเพอร์ตี้มาร์กอัปเนื้อหาสำหรับเอนทิตีประเภท 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 เหมือนเป็นสตริงที่คลุมเครือและ URL ไม่จำเป็นต้องเป็นลิงก์ที่ใช้งานได้จริง
  • ในรูปแบบของ Unified Resource Identifier (URI)
  • โดเมนที่ใช้สำหรับค่า @id ต้องเป็นขององค์กรคุณ
เนื่องจาก url ของเอนทิตีเป็นไปตามข้อกำหนดทั้งหมดในฐานะตัวระบุ เราจึงขอแนะนำให้คุณใช้ url ของเอนทิตีเป็น @id ดูรายละเอียดเพิ่มเติมได้ที่ส่วนตัวระบุ
url URL ต้องระบุ - Canonical URL ของเนื้อหา ซึ่ง Google ใช้เพื่อจับคู่เนื้อหาในฟีดกับเนื้อหาในฐานข้อมูลของ Google
url ต้องเป็นไปตามข้อกำหนดต่อไปนี้
  • url ต้องไม่ซ้ำกันทั่วโลก
  • url ต้องมี Canonical URL ที่ใช้งานได้ซึ่ง Google รวบรวมข้อมูลได้
สำหรับ Deep Link ของการเล่น ให้ดูพร็อพเพอร์ตี้ urlTemplate ของออบเจ็กต์ target แทน
name Text ต้องระบุ - ชื่อของภาพยนตร์
  • ใช้อาร์เรย์เพื่อแสดงชื่อในภาษาต่างๆ ดูตัวอย่างหลายภูมิภาคและหลายภาษา
  • โปรดทราบว่าระบบรองรับชื่อเพียงชื่อเดียวต่อภาษา (คู่ภาษาและประเทศ)
titleEIDR Text ขอแนะนำอย่างยิ่ง เหตุผล - ตัวระบุ EIDR (Entertainment Identifier Registry) ที่แสดงผลงานภาพยนตร์หรือโทรทัศน์ในระดับทั่วไป/นามธรรมที่สุด

ตัวอย่างเช่น EIDR ของภาพยนตร์ที่รู้จักกันในชื่อ "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 คีย์เวิร์ดหรือแท็กที่ใช้เพื่ออธิบายเนื้อหานี้ นอกจากนี้ยังอนุญาตให้ใช้กลุ่มคีย์เวิร์ดด้วย เช่น ["ฟีเจอร์ ชีวประวัติ"] อาจเป็นอาร์เรย์ของคีย์เวิร์ดที่ใช้อธิบายเนื้อหา
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"
}

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