Metadata

Siêu dữ liệu của một tài sản. Một số trường siêu dữ liệu chỉ hợp lệ cho một số loại tài sản nhất định.

Biểu diễn dưới dạng 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
}
Trường
customId

string

Một giá trị duy nhất mà bạn (nhà cung cấp siêu dữ liệu) sử dụng để xác định một tài sản. Giá trị này có thể là một mã nhận dạng riêng biệt mà bạn đã tạo cho tài sản hoặc một giá trị nhận dạng tiêu chuẩn, chẳng hạn như mã ISRC. Giá trị này có độ dài tối đa là 64 byte và có thể chứa các ký tự chữ số, dấu gạch nối (-), dấu gạch dưới (_), dấu chấm (.), ký hiệu "@" (@) hoặc dấu gạch chéo lên (/).
title

string

Tiêu đề hoặc tên của tài sản. Giá trị này có độ dài tối đa là 255 byte. Giá trị này là bắt buộc đối với những nội dung được liệt kê dưới đây và không bắt buộc đối với tất cả nội dung khác:

  • Hiện thành phần
  • Nội dung tập được liên kết với chương trình
  • Nội dung phim xuất hiện trong danh mục Phim của YouTube
  • Bản ghi âm có trong chương trình Hoán đổi âm thanh
notes

string

Thông tin bổ sung không liên kết trực tiếp với một trong các trường siêu dữ liệu khác. Trường này có chiều dài tối đa 255 byte.
description

string

Nội dung mô tả về tài sản. Nội dung mô tả có thể xuất hiện trên YouTube hoặc trong CMS. Trường này có độ dài tối đa là 5.000 byte.
genre[]

string

Trường này chỉ định một thể loại có thể dùng để phân loại tài sản. Tài sản có thể được phân loại theo nhiều thể loại và YouTube sử dụng nhiều bộ thể loại để phân loại các loại tài sản. Ví dụ: Soaps có thể là một thể loại hợp lệ cho chương trình nhưng không hợp lệ cho phim hoặc bản ghi âm.

  • Hiện thành phần
  • Nội dung phim xuất hiện trong danh mục Phim của YouTube
  • Bản ghi âm có trong chương trình Hoán đổi âm thanh
isrc

string

Mã ghi âm chuẩn quốc tế (ISRC) của tài sản video nhạc hoặc bản ghi âm. Giá trị của trường này phải chứa chính xác 12 ký tự chữ số.
grid

string

GRID (Mã nhận dạng bản phát hành trên toàn cầu) của một video nhạc hoặc bản ghi âm. Giá trị của trường này phải chứa chính xác 18 ký tự chữ số.
artist[]

string

Nghệ sĩ liên kết với tài sản video nhạc hoặc bản ghi âm. Trường này chỉ hợp lệ đối với tài sản video nhạc và bản ghi âm. Đây là thông tin bắt buộc đối với bản ghi âm có trong chương trình Hoán đổi âm thanh.
label

string

Hãng thu âm phát hành tài sản bản ghi âm. Trường này chỉ hợp lệ cho tài sản bản ghi âm và có độ dài tối đa là 255 byte.
upc

string

Mã UPC (Mã sản phẩm toàn cầu) được liên kết với tài sản.
album

string

Đĩa nhạc chứa tài sản bản ghi âm. Trường này chỉ hợp lệ cho tài sản bản ghi âm và có độ dài tối đa là 255 byte.
infoUrl

string

URL chính thức được liên kết với tài sản. Trường này có độ dài tối đa là 1536 byte. Vui lòng không gửi URL có độ dài 1.537 byte. Mọi nỗ lực của bạn đều vô ích.
iswc

string

ISWC (Mã tác phẩm âm nhạc chuẩn quốc tế) cho tài sản bản sáng tác. Giá trị của trường phải chứa chính xác 11 ký tự theo định dạng chữ cái (T), theo sau là 10 chữ số.
category

string

Danh mục của thành phần này.
copyrightDate

object (Date)

Ngày bản quyền của tài sản này được thiết lập. *
startYear

integer (uint32 format)

Năm đầu tiên một chương trình truyền hình phát sóng. Bạn phải cung cấp giá trị này và giá trị này cũng chỉ được dùng cho nội dung chương trình.
endYear

integer (uint32 format)

Năm cuối cùng mà một chương trình truyền hình phát sóng. Giá trị này chỉ dùng cho tài sản chương trình và không bắt buộc. Đừng chỉ định giá trị nếu các tập mới của chương trình vẫn đang được tạo.
episodesAreUntitled

boolean

Giá trị này cho biết các tập được liên kết với một thành phần chương trình cụ thể hoặc một thành phần mùa cụ thể không có tiêu đề. Một chương trình (hoặc phần) chưa có tiêu đề sẽ có các tập được xác định bằng số tập hoặc ngày phát sóng. Nếu bạn đặt trường này thành true, thì YouTube sẽ tối ưu hoá tiêu đề hiển thị cho các tập có liên quan.
keyword[]

string

Danh sách gồm tối đa 100 từ khoá được liên kết với một tài sản chương trình. Bạn phải điền trường này và trường này cũng chỉ được dùng cho nội dung chương trình.
tmsId

string

Mã TMS (Tribune Media Systems) của tài sản.
showCustomId

string

customId của nội dung chương trình mà nội dung phần hoặc tập liên kết đến. Đây là thông tin bắt buộc đối với nội dung mùa và tập xuất hiện trong danh mục Chương trình trên YouTube, đồng thời không hợp lệ đối với các loại nội dung khác. Trường này có độ dài tối đa là 64 byte và có thể chứa các ký tự chữ số, dấu gạch nối (-), dấu gạch dưới (_), dấu chấm (.), ký hiệu "@" (@) hoặc dấu gạch chéo lên (/).
showTitle

string

Tên của chương trình có nội dung tập liên kết đến. Lưu ý: Thẻ này chỉ được dùng và chỉ có hiệu lực đối với những tập không được liên kết với nội dung chương trình và cho phép những nội dung đó vẫn hiển thị tiêu đề chương trình trong phần siêu dữ liệu nội dung của CMS. Trường này có độ dài tối đa là 120 byte.
seasonNumber

string

Số thứ tự của phần dùng để xác định một tài sản phần hoặc số thứ tự của phần được liên kết với một tài sản tập. Trường này có độ dài tối đa 5 byte.
episodeNumber

string

Số tập liên kết với một tài sản tập. Bạn phải điền trường này và chỉ dùng cho nội dung tập được liên kết với nội dung chương trình. Thuộc tính này có độ dài tối đa là 5 byte.
writer[]

string

Danh sách xác định những nhạc sĩ có liên quan đến tài sản. Bạn có thể chỉ định tối đa 50 người viết cho một tài sản.
actor[]

string

Danh sách xác định những diễn viên có liên kết với tài sản. Bạn có thể chỉ định tối đa 50 diễn viên cho một tài sản.
director[]

string

Danh sách xác định những đạo diễn có liên quan đến tài sản. Bạn có thể chỉ định tối đa 50 đạo diễn cho một tài sản.
producer[]

string

Danh sách xác định nhà sản xuất tài sản. Bạn có thể chỉ định tối đa 50 nhà sản xuất cho một tài sản.
releaseDate

object (Date)

Ngày phát hành công khai một tài sản. Đối với tài sản theo phần, giá trị này chỉ định ngày phát sóng đầu tiên của phần. Các ngày trước năm 1902 không được hỗ trợ. Giá trị này hợp lệ đối với tài sản tập, mùa, phim, video nhạc và bản ghi âm. Đây là thuộc tính bắt buộc đối với những nội dung được liệt kê dưới đây và không bắt buộc đối với những nội dung khác:

  • Nội dung tập được liên kết với chương trình
  • Nội dung phim xuất hiện trong danh mục Phim của YouTube
spokenLanguage

string

Ngôn ngữ lời thoại chính của video. Giá trị có thể là mã ngôn ngữ gồm 2 chữ cái theo tiêu chuẩn ISO 639-1. Giá trị này chỉ được dùng cho nội dung theo tập và nội dung phim, đồng thời không hợp lệ đối với các loại nội dung khác.
subtitledLanguage[]

string

Danh sách các ngôn ngữ mà video có tệp phụ đề riêng hoặc phụ đề được nhúng cố định trong video. Mỗi giá trị trong danh sách phải là mã ngôn ngữ gồm 2 chữ cái theo tiêu chuẩn ISO 639-1. Giá trị này chỉ được dùng cho nội dung theo tập và nội dung phim, đồng thời không hợp lệ đối với các loại nội dung khác.
isan

string

ISAN (Số nhận dạng tiêu chuẩn quốc tế cho tác phẩm nghe nhìn) của tài sản. Giá trị này chỉ dùng cho nội dung tập và phim, đồng thời không bắt buộc trong cả hai trường hợp. Giá trị chứa 26 ký tự, bao gồm 24 ký tự thập lục phân của ISAN cũng như hai ký tự kiểm tra, theo định dạng sau:

  • 16 ký tự đầu tiên trong giá trị thẻ chứa các ký tự thập lục phân chỉ định thành phần 'gốc' và 'tập' của ISAN.
  • Ký tự thứ mười bảy là ký tự kiểm tra (một chữ cái từ A đến Z).
  • Các ký tự từ 18 đến 25 là tám ký tự còn lại của ISAN, chỉ định thành phần 'phiên bản' của ISAN.
  • Ký tự thứ 26 là một ký tự kiểm tra khác (A-Z).
eidr

string

Mã đăng ký nhận dạng nội dung giải trí (EIDR) được chỉ định cho một tài sản. Giá trị này chỉ dùng cho nội dung tập và phim, đồng thời không bắt buộc trong cả hai trường hợp. Giá trị chứa tiền tố chuẩn cho sổ đăng ký EIDR, theo sau là dấu gạch chéo lên, chuỗi thập lục phân 20 ký tự và ký tự kiểm tra chữ số (0-9A-Z).
hfa

string

Mã bài hát gồm 6 ký tự của Harry Fox Agency (HFA) được cấp để nhận dạng duy nhất một sáng tác. Giá trị này chỉ hợp lệ cho tài sản bản sáng tác.
ratings[]

object (Rating)

Danh sách điểm xếp hạng mà một tài sản nhận được. Mức phân loại phải hợp lệ theo hệ thống phân loại được chỉ định.
broadcaster[]

string

Xác định mạng hoặc kênh đã phát sóng một chương trình hoặc một mùa của chương trình lần đầu tiên. Bạn chỉ nên thêm trường này cho một tài sản nếu đài truyền hình liên kết với tài sản đó khác với đối tác tải tài sản lên YouTube. Xin lưu ý rằng một chương trình có thể có nhiều đài phát sóng; ví dụ: một chương trình có thể chuyển mạng truyền hình giữa các phần.
totalEpisodesExpected

integer (uint32 format)

Xác định tổng số tập có thời lượng đầy đủ trong mùa. Giá trị này chỉ được dùng cho tài sản mùa.
contentType

string

Loại nội dung video mà tài sản đại diện. Trường này chỉ hợp lệ đối với nội dung phim và tập, đồng thời là trường bắt buộc đối với các loại nội dung sau:

  • Nội dung tập được liên kết với chương trình
  • Nội dung phim xuất hiện trong danh mục Phim của YouTube

Các giá trị được chấp nhận là:

  • clip
  • feature_film
  • full_episode
  • short
originalReleaseMedium

string

Phương thức mà người dùng lần đầu tiên có cơ hội xem một thành phần video. Giá trị này chỉ được dùng cho nội dung tập và phim. Đây là thuộc tính bắt buộc đối với những nội dung sau và không bắt buộc đối với những nội dung khác:

  • Nội dung tập được liên kết với chương trình
  • Nội dung phim xuất hiện trong danh mục Phim của YouTube

Các giá trị được chấp nhận là:

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

Ngày

Tài nguyên này xác định một ngày, được biểu thị dưới dạng các phần cấu thành (năm, tháng, ngày).

Biểu diễn dưới dạng JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Trường
year

integer (uint32 format)

Năm của ngày trong Lịch Gregorian. Được giả định là sau Công nguyên
month

integer (uint32 format)

Tháng của ngày. Giá trị phải là số nguyên từ 1 đến 12.
day

integer (uint32 format)

Ngày trong tháng. Giá trị phải là số nguyên từ 1 đến 31. Xin lưu ý rằng một số tổ hợp ngày và tháng không hợp lệ.

Rating

Đối tượng này chứa mức phân loại nội dung cho một tài sản.

Biểu diễn dưới dạng JSON 
{
  "ratingSystem": string,
  "rating": string
}
Trường
ratingSystem

string

Hệ thống phân loại liên kết với mức phân loại.

Các giá trị được chấp nhận là:

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

string

Điểm xếp hạng mà thành phần nhận được.