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 や、ISRC などの標準識別子を指定できます。値の最大長は 64 バイトで、英数字、ハイフン（-）、アンダースコア（_）、ピリオド（.）、アットマーク（@）、スラッシュ（/）を含めることができます。
title

string

アセットのタイトルまたは名前。値の最大長は 255 バイトです。この値は、以下のアセットでは必須ですが、他のすべてのアセットでは省略可能です。

  • アセットを表示する
  • 番組にリンクされているエピソード アセット
  • YouTube の [映画] カテゴリに表示される映画アセット
  • AudioSwap プログラムに含まれる音声録音
notes

string

他のメタデータ フィールドに直接マッピングされない追加情報。このフィールドの最大長は 255 バイトです。
description

string

アセットの説明。説明は YouTube または CMS に表示されることがあります。このフィールドの最大長は 5,000 バイトです。
genre[]

string

このフィールドは、アセットのカテゴリ分類に使用できるジャンルを指定します。アセットは複数のジャンルにカテゴリ分類できます。YouTube では、異なるジャンルセットを使用して異なるタイプのアセットを分類します。たとえば、Soaps は番組の有効なジャンルですが、映画やサウンド レコーディングの有効なジャンルではない場合があります。

  • アセットを表示する
  • YouTube の [映画] カテゴリに表示される映画アセット
  • AudioSwap プログラムに含まれる音声録音
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 バイトです。1,537 バイトの URL は送信しないでください。努力は無駄になります。
iswc

string

楽曲アセットの ISWC（国際標準音楽作品コード）。このフィールドには、1 つの文字（T）の後に 10 個の数字が続く形式でちょうど 11 文字の値を含める必要があります。
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

アセットに関連付けられているライターを識別するリスト。1 つのアセットに最大 50 人の脚本家を指定できます。
actor[]

string

アセットに関連付けられているアクターを識別するリスト。1 つのアセットに最大 50 人の俳優を指定できます。
director[]

string

アセットに関連付けられているディレクターを特定するリスト。1 つのアセットに最大 50 人の監督を指定できます。
producer[]

string

アセットのプロデューサーを識別するリスト。1 つのアセットに最大 50 人のプロデューサーを指定できます。
releaseDate

object (Date)

アセットが一般公開された日付。シーズン アセットの場合は、シーズンが初めて放送された日付を指定します。1902 年より前の日付はサポートされていません。この値は、エピソード、シーズン、映画、ミュージック ビデオ、サウンド レコーディングのアセットで有効です。次のアセットでは必須ですが、それ以外の場合は省略可能です。

  • 番組にリンクされているエピソード アセット
  • YouTube の [映画] カテゴリに表示される映画アセット
spokenLanguage

string

動画内で話されている主な言語。値には、ISO 639-1 で規定されている 2 文字の言語コードから任意のものを指定できます。この値はエピソード アセットと映画アセットにのみ使用され、他の種類のアセットには無効です。
subtitledLanguage[]

string

動画に個別の字幕トラックがあるか、動画の一部として字幕が焼き付けられている言語のリスト。リスト内の各値は、ISO 639-1 2 文字言語コードである必要があります。この値はエピソード アセットと映画アセットにのみ使用され、他の種類のアセットには無効です。
isan

string

アセットの ISAN（国際標準視聴覚番号）。この値はエピソードと映画のアセットにのみ使用され、どちらの場合も省略可能です。値は 26 文字で、ISAN の 16 進文字 24 個と 2 つの検査文字で構成されます。書式は次のとおりです。

  • タグ値の最初の 16 文字は、ISAN の 'root' コンポーネントおよび 'episode' コンポーネントを指定する 16 進文字です。
  • 17 番目の文字は検査文字（A ～ Z）です。
  • 18～25 番目の文字は ISAN の残りの 8 文字で、ISAN の 'version' コンポーネントを示します。
  • 26 番目の文字は、もう 1 つの検査文字（A～Z）です。
eidr

string

アセットに割り当てられている Entertainment Identifier Registry（EIDR）。この値はエピソードと映画のアセットにのみ使用され、どちらの場合も省略可能です。値は EIDR レジストリの標準接頭辞で始まり、その後にスラッシュ 1 つ、20 文字の 16 進文字列、英数字（0～9、A～Z）の検査文字 1 つが続きます。
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 の整数にする必要があります。日と月の組み合わせによっては無効になることがあります。

評価

このオブジェクトには、アセットのコンテンツのレーティングが含まれています。

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

アセットに付けられた評価。