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

這是中繼資料提供者用來識別資產的專屬值。這個值可以是您為資產建立的唯一 ID，也可以是標準 ID，例如 ISRC。值長度上限為 64 位元組，可包含英數字元、連字號 (-)、底線 (_)、半形句號 (.)、「@」符號 (@) 或正斜線 (/)。
title

string

資產的標題或名稱。值的長度上限為 255 個位元組。下列資產必須提供這個值，其他資產則為選填：

  • 顯示資產
  • 連結至節目的集數資產
  • YouTube「電影」類別中顯示的電影資產
  • 「背景音樂切換」計畫中的錄音片段
notes

string

無法直接對應至其他中繼資料欄位的額外資訊。這個欄位的長度上限為 255 位元組。
description

string

資產說明。說明可能會顯示在 YouTube 或 CMS 中。這個欄位的長度上限為 5,000 位元組。
genre[]

string

這個欄位說明可用來區分資產所屬類別的類型資訊。任何一種資產都可以被歸為多種類型，且 YouTube 會使用不同的類型組合來分類不同類型的資產。舉例來說，Soaps 可能適用於節目，但不適用於電影或錄音內容。

  • 顯示資產
  • YouTube「電影」類別中顯示的電影資產
  • 「背景音樂切換」計畫中的錄音片段
isrc

string

音樂影片或錄音資產的國際標準錄音錄影資料代碼 (ISRC)。這個欄位的值必須為 12 個英數字元。
grid

string

音樂影片或錄音的全球發行品識別碼 (GRid)。這個欄位的值必須為 18 個英數字元。
artist[]

string

與音樂影片或錄音資產相關聯的藝人。這個欄位僅適用於音樂影片和錄音資產。如果錄音片段已加入背景音樂切換程式，則必須提供這項資訊。
label

string

發行錄音資產的唱片公司。這個欄位僅適用於錄音資產，長度上限為 255 位元組。
upc

string

與資產相關聯的 UPC (通用產品代碼)。
album

string

收錄錄音資產的專輯。這個欄位僅適用於錄音資產，長度上限為 255 位元組。
infoUrl

string

與資產相關聯的官方網址。這個欄位的長度上限為 1536 位元組。請勿提交 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) ID。
showCustomId

string

季別或劇集資產所屬節目資產的 customId。如果季別和劇集資產會顯示在 YouTube 的「節目」類別中，就必須使用這個標記，其他類型的資產則不適用。這個欄位的長度上限為 64 位元組，而且可包含英數字元、連字號 (-)、底線 (_)、句號 (.)、「@」符號 (@) 或正斜線 (/)。
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

影片的主要語言。值可以是任何 ISO 639-1 雙字母語言代碼。這個值僅適用於集數和電影資產，不適用於其他類型的資產。
subtitledLanguage[]

string

影片附帶獨立字幕軌或內建字幕的語言清單。清單中的每個值都應是 ISO 639-1 雙字母語言代碼。這個值僅適用於集數和電影資產，不適用於其他類型的資產。
isan

string

資產的 ISAN (國際標準視聽著作號)。這個值僅適用於劇集和電影資產，且在這兩種情況下都是選填。這個值有 26 個字元，其中 24 個是十六進位的 ISAN 字元，另外兩個則是檢查字元，其格式如下：

  • 標記值的前 16 個字元包含十六進位字元，用於指定 ISAN 的「根」和「集」元件。
  • 第十七個字元是檢查字元 (A-Z 的字母)。
  • 第 18 到 25 個字元是其餘的八個 ISAN 字元，用來表示 ISAN 的「版本」。
  • 第 26 個字元是另一個檢查字元 (A-Z)。
eidr

string

指派給資產的國際影視產業識別碼機構 (EIDR)。這個值僅適用於劇集和電影資產，且在這兩種情況下都是選填。這個值包含 EIDR 識別碼的標準字首、正斜線、20 位數十六進制字串和英數 (0-9、A-Z) 檢查字元。
hfa

string

Harry Fox Agency (HFA) 核發的樂曲專屬識別碼 (共六個字元)。這個值僅適用於詞曲資產。
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

素材資源獲得的評分。