Metadata

ข้อมูลเมตาของเนื้อหา ฟิลด์ข้อมูลเมตาบางรายการใช้ได้กับเนื้อหาบางประเภทเท่านั้น

การแสดง JSON 
{
  "customId": string,
  "title": string,
  "notes": string,
  "description": string,
  "genre": [
    string
  ],
  "isrc": string,
  "grid": string,
  "artist": [
    string
  ],
  "label": string,
  "upc": string,
  "album": string,
  "infoUrl": string,
  "iswc": string,
  "category": string,
  "copyrightDate": {
    object (Date)
  },
  "startYear": integer,
  "endYear": integer,
  "episodesAreUntitled": boolean,
  "keyword": [
    string
  ],
  "tmsId": string,
  "showCustomId": string,
  "showTitle": string,
  "seasonNumber": string,
  "episodeNumber": string,
  "writer": [
    string
  ],
  "actor": [
    string
  ],
  "director": [
    string
  ],
  "producer": [
    string
  ],
  "releaseDate": {
    object (Date)
  },
  "spokenLanguage": string,
  "subtitledLanguage": [
    string
  ],
  "isan": string,
  "eidr": string,
  "hfa": string,
  "ratings": [
    {
      object (Rating)
    }
  ],
  "broadcaster": [
    string
  ],
  "totalEpisodesExpected": integer,
  "contentType": string,
  "originalReleaseMedium": string
}
ช่อง
customId

string

ค่าที่ไม่ซ้ำกันซึ่งคุณในฐานะผู้ให้บริการข้อมูลเมตาใช้เพื่อระบุเนื้อหา ค่าอาจเป็นรหัสที่ไม่ซ้ำกันที่คุณสร้างขึ้นสำหรับเนื้อหา หรือตัวระบุมาตรฐาน เช่น ISRC ค่ามีความยาวสูงสุด 64 ไบต์ และอาจมีอักขระที่เป็นตัวอักษรและตัวเลขคละกัน, ขีดกลาง (-), ขีดล่าง (_), จุด (.), สัญลักษณ์ "at" (@) หรือเครื่องหมายทับ (/)
title

string

ชื่อของเนื้อหา ค่ามีความยาวสูงสุด 255 ไบต์ ค่านี้จำเป็นสำหรับเนื้อหาที่ระบุไว้ด้านล่างและไม่บังคับสำหรับเนื้อหาอื่นๆ ทั้งหมด

  • แสดงชิ้นงาน
  • เนื้อหาตอนที่ลิงก์กับรายการ
  • เนื้อหาภาพยนตร์ที่ปรากฏในหมวดหมู่ภาพยนตร์ของ YouTube
  • การบันทึกเสียงที่รวมอยู่ในโปรแกรมฟีเจอร์สลับแทร็กเสียง
notes

string

ข้อมูลเพิ่มเติมที่ไม่ได้แมปกับฟิลด์ข้อมูลเมตาอื่นๆ โดยตรง ช่องนี้มีความยาวสูงสุด 255 ไบต์
description

string

คำอธิบายของชิ้นงาน คำอธิบายอาจแสดงบน YouTube หรือใน CMS ช่องนี้มีความยาวสูงสุด 5,000 ไบต์
genre[]

string

ฟิลด์นี้ระบุประเภทที่ใช้ในการจัดหมวดหมู่เนื้อหาได้ ระบบอาจจัดหมวดหมู่เนื้อหาในประเภทมากกว่า 1 ประเภท และ YouTube ใช้ชุดประเภทที่แตกต่างกันเพื่อจัดหมวดหมู่เนื้อหาประเภทต่างๆ เช่น Soaps อาจเป็นประเภทที่ถูกต้องสำหรับรายการ แต่ไม่ใช่สำหรับภาพยนตร์หรือการบันทึกเสียง

  • แสดงชิ้นงาน
  • เนื้อหาภาพยนตร์ที่ปรากฏในหมวดหมู่ภาพยนตร์ของ YouTube
  • การบันทึกเสียงที่รวมอยู่ในโปรแกรมฟีเจอร์สลับแทร็กเสียง
isrc

string

ISRC (รหัสการบันทึกมาตรฐานสากล) ของเนื้อหามิวสิกวิดีโอหรือการบันทึกเสียง ค่าในช่องนี้ต้องมีอักขระที่เป็นตัวอักษรและตัวเลขคละกัน 12 ตัว
grid

string

GRID (Global Release Identifier) ของมิวสิกวิดีโอหรือไฟล์บันทึกเสียง ค่าของฟิลด์นี้ต้องมีอักขระที่เป็นตัวอักษรและตัวเลขคละกัน 18 ตัว
artist[]

string

ศิลปินที่เชื่อมโยงกับเนื้อหามิวสิกวิดีโอหรือเนื้อหาการบันทึกเสียง ฟิลด์นี้ใช้ได้กับเนื้อหามิวสิกวิดีโอและเนื้อหาการบันทึกเสียงเท่านั้น ต้องระบุสำหรับไฟล์บันทึกเสียงที่รวมอยู่ในโปรแกรมสลับแทร็กเสียง
label

string

ค่ายเพลงที่เผยแพร่เนื้อหาการบันทึกเสียง ฟิลด์นี้ใช้ได้กับเนื้อหาการบันทึกเสียงเท่านั้น และมีความยาวสูงสุด 255 ไบต์
upc

string

UPC (รหัสผลิตภัณฑ์สากล) ที่เชื่อมโยงกับเนื้อหา
album

string

อัลบั้มที่มีเนื้อหาการบันทึกเสียง ฟิลด์นี้ใช้ได้กับเนื้อหาการบันทึกเสียงเท่านั้น และมีความยาวสูงสุด 255 ไบต์
infoUrl

string

URL อย่างเป็นทางการที่เชื่อมโยงกับเนื้อหา ช่องนี้มีความยาวสูงสุด 1536 ไบต์ โปรดอย่าส่ง URL ที่มีขนาด 1537 ไบต์ ความพยายามของคุณจะสูญเปล่า
iswc

string

ISWC (รหัสงานเพลงมาตรฐานสากล) สำหรับเนื้อหาการเรียบเรียง ช่องนี้ต้องมีอักขระ 11 ตัวในรูปแบบที่ใช้ตัวอักษร (T) ตามด้วยตัวเลข 10 หลัก
category

string

หมวดหมู่ของเนื้อหานี้
copyrightDate

object (Date)

วันที่กำหนดลิขสิทธิ์ของเนื้อหานี้ *
startYear

integer (uint32 format)

ปีแรกที่รายการทีวีออกอากาศ ค่านี้จำเป็นและใช้สำหรับเนื้อหาของรายการเท่านั้น
endYear

integer (uint32 format)

ปีสุดท้ายที่รายการทีวีออกอากาศ ค่านี้ใช้สำหรับเนื้อหาของรายการทีวีเท่านั้น ซึ่งเป็นค่าที่ไม่บังคับ อย่าระบุค่าหากยังมีการสร้างตอนใหม่ของรายการ
episodesAreUntitled

boolean

ค่านี้บ่งบอกว่าตอนที่เชื่อมโยงกับเนื้อหารายการหรือเนื้อหาซีซันที่เฉพาะเจาะจงไม่มีชื่อ รายการ (หรือซีซัน) ที่ไม่มีชื่อจะมีตอนซึ่งระบุด้วยหมายเลขตอนหรือวันที่ หากตั้งค่าช่องนี้เป็น true YouTube จะเพิ่มประสิทธิภาพชื่อที่แสดงสำหรับตอนที่เกี่ยวข้อง
keyword[]

string

รายการคีย์เวิร์ดที่เชื่อมโยงกับชิ้นงานรายการทีวีได้สูงสุด 100 รายการ ฟิลด์นี้จำเป็นและใช้สำหรับเนื้อหาของรายการทีวีเท่านั้น
tmsId

string

รหัส TMS (Tribune Media Systems) สำหรับเนื้อหา
showCustomId

string

customId ของเนื้อหารายการที่เกี่ยวข้องกับเนื้อหาซีซันหรือตอน ต้องระบุสำหรับเนื้อหาซีซันและตอนที่ปรากฏในหมวดหมู่รายการบน YouTube และใช้ไม่ได้กับเนื้อหาประเภทอื่นๆ ฟิลด์นี้มีความยาวสูงสุด 64 ไบต์ และอาจมีอักขระที่เป็นตัวอักษรและตัวเลขคละกัน ขีดกลาง (-) ขีดล่าง (_) จุด (.) สัญลักษณ์ "at" (@) หรือเครื่องหมายทับ (/)
showTitle

string

ชื่อของรายการที่เกี่ยวข้องกับเนื้อหาตอน หมายเหตุ: แท็กนี้ใช้ได้กับตอนที่ไม่ได้เชื่อมโยงกับเนื้อหาของรายการเท่านั้น และจะช่วยให้เนื้อหาเหล่านั้นยังคงแสดงชื่อรายการในส่วนข้อมูลเมตาของเนื้อหาใน CMS ได้ ช่องนี้มีความยาวสูงสุด 120 ไบต์
seasonNumber

string

หมายเลขซีซันที่ระบุเนื้อหาซีซัน หรือหมายเลขซีซันที่เชื่อมโยงกับเนื้อหาตอน ช่องนี้มีความยาวสูงสุด 5 ไบต์
episodeNumber

string

หมายเลขตอนที่เชื่อมโยงกับเนื้อหาตอน ฟิลด์นี้จำเป็นและใช้สำหรับเนื้อหาตอนที่ลิงก์กับเนื้อหารายการทีวีเท่านั้น มีความยาวของอักขระได้สูงสุด 5 ไบต์
writer[]

string

รายการที่ระบุผู้เขียนที่เกี่ยวข้องกับเนื้อหา คุณระบุผู้เขียนได้สูงสุด 50 คนสำหรับเนื้อหา
actor[]

string

รายการที่ระบุนักแสดงที่เกี่ยวข้องกับเนื้อหา คุณระบุนักแสดงได้สูงสุด 50 คนสำหรับเนื้อหา
director[]

string

รายชื่อผู้กำกับที่เกี่ยวข้องกับเนื้อหา คุณระบุผู้กำกับได้สูงสุด 50 คนสำหรับเนื้อหา
producer[]

string

รายการที่ระบุผู้ผลิตเนื้อหา คุณระบุผู้อำนวยการสร้างได้สูงสุด 50 คนสำหรับเนื้อหา
releaseDate

object (Date)

วันที่เผยแพร่เนื้อหาต่อสาธารณะ สำหรับเนื้อหาซีซัน ค่านี้จะระบุวันที่แรกที่ซีซันออกอากาศ วันที่ก่อนปี 1902 ไม่ได้รับการสนับสนุน ค่านี้ใช้ได้กับเนื้อหาตอน ซีซัน ภาพยนตร์ มิวสิกวิดีโอ และการบันทึกเสียง ต้องระบุสำหรับเนื้อหาที่ระบุไว้ด้านล่างนี้ แต่ไม่บังคับสำหรับเนื้อหาในกรณีอื่น

  • เนื้อหาตอนที่ลิงก์กับรายการ
  • เนื้อหาภาพยนตร์ที่ปรากฏในหมวดหมู่ภาพยนตร์ของ YouTube
spokenLanguage

string

ภาษาพูดหลักของวิดีโอ ค่าจะเป็นค่าใดก็ได้ที่ใช้รหัสภาษา 2 ตัวอักษรตามมาตรฐาน ISO 639-1 ค่านี้ใช้ได้กับเนื้อหาที่เป็นตอนและภาพยนตร์เท่านั้น และใช้ไม่ได้กับเนื้อหาประเภทอื่นๆ
subtitledLanguage[]

string

รายการภาษาที่วิดีโอมีแทร็กคำบรรยายแทนเสียงแยกต่างหากหรือคำบรรยายแทนเสียงที่ฝังอยู่ในวิดีโอ แต่ละค่าในรายการควรเป็นรหัสภาษา 2 ตัวอักษร ISO 639-1 ค่านี้ใช้ได้กับเนื้อหาที่เป็นตอนและภาพยนตร์เท่านั้น และใช้ไม่ได้กับเนื้อหาประเภทอื่นๆ
isan

string

ISAN (International Standard Audiovisual Number) สำหรับเนื้อหา ค่านี้ใช้สำหรับเนื้อหาตอนและภาพยนตร์เท่านั้น และเป็นค่าที่ไม่บังคับในทั้ง 2 กรณี ค่าจะมีอักขระ 26 ตัว ซึ่งรวมถึงตัวอักษรฐานสิบหก 24 ตัวของ ISAN และอักขระตรวจสอบ 2 ตัวในรูปแบบต่อไปนี้

  • อักขระ 16 ตัวแรกในค่าแท็กมีอักขระฐานสิบหกที่ระบุคอมโพเนนต์ "รูท" และ "ตอน" ของ ISAN
  • อักขระที่ 17 คืออักขระตรวจสอบ (ตัวอักษรจาก A-Z)
  • อักขระที่ 18 ถึง 25 คืออักขระที่เหลือแปดตัวของ ISAN ซึ่งระบุองค์ประกอบ "เวอร์ชัน" ของ ISAN
  • อักษรตัวที่ยี่สิบเจ็ดเป็นอักขระตรวจสอบ (A-Z)
eidr

string

Entertainment Identifier Registry (EIDR) ที่กำหนดให้กับเนื้อหา ค่านี้ใช้สำหรับเนื้อหาตอนและภาพยนตร์เท่านั้น และเป็นค่าที่ไม่บังคับในทั้ง 2 กรณี ค่าจะมีคำนำหน้ามาตรฐานสำหรับรีจิสทรี EIDR ตามด้วยเครื่องหมายทับ สตริงฐานสิบหกที่มีอักขระ 20 ตัว รวมทั้งอักขระตรวจสอบที่เป็นตัวเลขและตัวอักษรผสมกัน (0-9, A-Z)
hfa

string

รหัสเพลงของ Harry Fox Agency (HFA) แบบ 6 หลักที่ออกเพื่อระบุการแต่งเพลงที่ไม่ซ้ำกัน ค่านี้ใช้ได้กับเนื้อหาการเรียบเรียงเท่านั้น
ratings[]

object (Rating)

รายการการจัดประเภทที่เนื้อหาได้รับ การจัดประเภทต้องถูกต้องภายใต้ระบบการจัดประเภทที่ระบุ
broadcaster[]

string

ระบุเครือข่ายหรือช่องที่ออกอากาศรายการหรือซีซันของรายการเป็นครั้งแรก ควรระบุฟิลด์นี้สำหรับเนื้อหาเท่านั้น หากผู้ออกอากาศที่เชื่อมโยงกับเนื้อหาแตกต่างจากพาร์ทเนอร์ที่อัปโหลดเนื้อหาไปยัง YouTube โปรดทราบว่ารายการอาจมีผู้ออกอากาศหลายราย เช่น รายการอาจเปลี่ยนเครือข่ายระหว่างซีซัน
totalEpisodesExpected

integer (uint32 format)

ระบุจำนวนตอนแบบเต็มทั้งหมดในซีซัน ค่านี้ใช้สำหรับเนื้อหาซีซันเท่านั้น
contentType

string

ประเภทเนื้อหาวิดีโอที่เนื้อหาแสดง ฟิลด์นี้ใช้ได้กับเนื้อหาภาพยนตร์และตอนเท่านั้น และต้องระบุสำหรับเนื้อหาประเภทต่อไปนี้

  • เนื้อหาตอนที่ลิงก์กับรายการ
  • เนื้อหาภาพยนตร์ที่ปรากฏในหมวดหมู่ภาพยนตร์ของ YouTube

ค่าที่ยอมรับได้มีดังนี้

  • clip
  • feature_film
  • full_episode
  • short
originalReleaseMedium

string

วิธีการที่ผู้คนมีโอกาสได้ดูชิ้นงานวิดีโอเป็นครั้งแรก ค่านี้ใช้สำหรับเนื้อหาตอนและภาพยนตร์เท่านั้น ต้องระบุสำหรับเนื้อหาต่อไปนี้ (ไม่บังคับสำหรับเนื้อหาในกรณีอื่น)

  • เนื้อหาตอนที่ลิงก์กับรายการ
  • เนื้อหาภาพยนตร์ที่ปรากฏในหมวดหมู่ภาพยนตร์ของ YouTube

ค่าที่ยอมรับได้มีดังนี้

  • basic_tv
  • direct_to_video
  • film
  • premium_tv
  • promotional
  • terrestrial_tv
  • web

วันที่

ทรัพยากรนี้ระบุวันที่ซึ่งแสดงเป็นส่วนประกอบ (ปี เดือน วัน)

การแสดง JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
ช่อง
year

integer (uint32 format)

ปีของวันที่ในปฏิทินเกรกอเรียน สันนิษฐานว่าเป็น ค.ศ.
month

integer (uint32 format)

เดือนของวันที่ ค่าควรเป็นจำนวนเต็มระหว่าง 1 ถึง 12
day

integer (uint32 format)

วันของวันที่ ค่าควรเป็นจำนวนเต็มระหว่าง 1 ถึง 31 โปรดทราบว่าการผสมวันกับเดือนบางอย่างไม่ถูกต้อง

Rating

ออบเจ็กต์นี้มีการจัดประเภทเนื้อหาสำหรับเนื้อหา

การแสดง JSON 
{
  "ratingSystem": string,
  "rating": string
}
ช่อง
ratingSystem

string

ระบบการจัดประเภทที่เชื่อมโยงกับการจัดประเภท

ค่าที่ยอมรับได้มีดังนี้

  • acb
  • age_gate_16
  • bbfc
  • cbfc
  • chvrs
  • djctq
  • eirin
  • esrb
  • fmoc
  • fsk
  • icaa
  • kmrb
  • lyrics
  • mpaa
  • oflc
  • russia
  • v_chip
  • youtube
  • youtubeuk
rating

string

การจัดประเภทที่ชิ้นงานได้รับ