REST Resource: references

リソース: Reference

reference はアセットの実際のコンテンツを表すリソースです。YouTube は、アセット所有者に対する申し立てを自動的に生成することを目的として、新たにアップロードされた動画を参照ライブラリと比較します。

JSON 表現
{
  "kind": string,
  "status": string,
  "statusReason": string,
  "length": number,
  "hashCode": string,
  "urgent": boolean,
  "fpDirect": boolean,
  "contentType": string,
  "audioswapEnabled": boolean,
  "ignoreFpMatch": boolean,
  "origination": {
    object (Origination)
  },
  "excludedIntervals": [
    {
      object (ExcludedInterval)
    }
  ],
  "id": string,
  "assetId": string,
  "duplicateLeader": string,
  "claimId": string,
  "videoId": string
}
フィールド
kind

string

API リソースのタイプ。reference リソースの場合、値は youtubePartner#reference です。

status

string

参照のステータス。

statusReason

string

参照が現在の状態になった経緯の説明。この値は、参照のステータスが inactive または deleted の場合にのみ存在します。

length

number

参照の長さ(秒)。

hashCode

string

参照コンテンツの MD5 ハッシュコード。非推奨この値はもう入力されません。

urgent

boolean

この値を true に設定すると、YouTube で動画ファイルの Content ID 処理が優先されるようになります。YouTube では、緊急の動画ファイルは緊急と示されていない他のファイルより先に処理されます。この設定はおもにライブイベントの動画または時間的な制約がある他の動画に使用します。YouTube が動画の Content ID 処理を完了するのが早ければ早いほど、ユーザーがアップロードした動画と YouTube の動画を一致させるのも早くなります。

すべてのファイルを緊急としてマークすると、それらのファイルの処理が遅れる可能性があります。

fpDirect

boolean

リファレンスをアップロードするときは、この値を true に設定して、そのリファレンスが事前生成されたフィンガープリントであることを示します。

contentType

string

参照が表すコンテンツのタイプ。

audioswapEnabled

boolean

このフィールドの値を true に設定すると、参照コンテンツが YouTube のオーディオ入れ替えプログラムに含まれるようになります。

ignoreFpMatch

boolean

申し立ての生成に参照を使用してはならないことを示すには、この値を true に設定します。このフィールドはオーディオ入れ替えの参照でのみ使用されます。

origination

object (Origination)

origination オブジェクトには、参照ソースを記述する情報が格納されます。

excludedIntervals[]

object (ExcludedInterval)

一致プロセス中に無視される、この参照の時間間隔のリスト。

id

string

参照を一意に識別するために YouTube が割り当てて使用する値。

assetId

string

参照が関連付けられているアセットを一意に識別する ID。

duplicateLeader

string

この参照が重複している参照を一意に識別する ID。このフィールドは、参照のステータスが inactive で、理由が REASON_DUPLICATE_FOR_OWNERS の場合にのみ存在します。

claimId

string

このフィールドは、CMS アカウントにリンクされた YouTube チャンネルにアップロードされた既存の YouTube 動画にアセットを関連付けることで参照が作成された場合に存在します。その場合、アセットと動画の関連付けを示す申し立ての ID がこのフィールドに含まれます。

videoId

string

このフィールドは、CMS アカウントにリンクされた YouTube チャンネルにアップロードされた既存の YouTube 動画にアセットを関連付けることで参照が作成された場合に存在します。その場合、このフィールドには元の動画の ID が含まれます。

ExcludedInterval

一致プロセス中に無視される参照内の時間枠を定義します。

JSON 表現
{
  "low": number,
  "high": number,
  "origin": string,
  "timeCreated": string
}
フィールド
low

number

時間枠の開始時刻(秒単位)。0high の任意の値を指定できます。すべての間隔で、このフィールドの値を指定する必要があります。

high

number

時間枠の終了時刻(秒単位)。値には low より大きい任意の値を指定できます。high が参照の長さより大きい場合、low から参照の終了までの間隔は除外されます。すべての間隔で、このフィールドの値を指定する必要があります。

origin

string

Content ID の一致から特定の期間を除外するリクエストのソース。

timeCreated

string

除外が作成された日時。値は RFC 3339YYYY-MM-DDThh:mm:ss.000Z)形式で指定します。

Methods

get

指定した参照に関する情報を取得します。

insert

次のいずれかの方法で参照を作成します。
  • リクエストが参照ファイルをアップロードする場合、YouTube は指定されたコンテンツから参照を作成します。

list

ID 別の参照のリスト、または指定したアセットの参照のリストを取得します。

patch

参照にパッチを適用します。

update

参照を更新します。