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

ส่วนนี้จะแสดงรายละเอียดของพร็อพเพอร์ตี้มาร์กอัปเนื้อหาสำหรับประเภทเอนทิตี 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 รวบรวมข้อมูลได้
สำหรับ Deep Link ของการเล่น โปรดดูพร็อพเพอร์ตี้ urlTemplate ของออบเจ็กต์เป้าหมายแทน
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" ซึ่งมี 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 การดำเนินการเพื่อรับชม ต้องระบุ (หากมี) - ออบเจ็กต์มาร์กอัปการดำเนินการที่ให้ข้อมูลรายละเอียดของการดำเนินการ
  • หากเนื้อหาพร้อมใช้งานในวิดีโอออนดีมานด์ (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 ข้อความหรือการจัดประเภท ต้องระบุสำหรับเนื้อหาสำหรับผู้ใหญ่ หากไม่แนะนำอย่างยิ่งให้ใช้ เพราะเหตุใด - การให้คะแนนเนื้อหาโดยรวม หากการจัดประเภทเนื้อหาอยู่ในรูปแบบสตริงข้อความ ระบบจะยอมรับ 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 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"
}

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