REST Resource: references

資源：參考資料

參考檔案代表資產的實際內容。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

時間範圍的開始 (含) 時間，以秒為單位。這個值可以是 0 至 high 之間的任何值。每個間隔都必須指定這個欄位的值。
high

number

時間範圍的結束 (含) 時間，以秒為單位。值可以是大於 low 的任何值。如果 high 大於參考檔案的長度，就會排除 low 到參考檔案結尾之間的間隔。每個間隔都必須指定這個欄位的值。
origin

string

要求來源，要在 Content ID 比對功能中排除時間間隔。
timeCreated

string

排除的建立日期和時間。指定這個值時採用 RFC 3339 (YYYY-MM-DDThh:mm:ss.000Z) 格式。

方法

get

 擷取指定參照的相關資訊。

insert

 透過下列其中一種方式建立參照：
  • 如果你要求上傳參考檔案，YouTube 會根據提供的內容建立參考檔案。

list

 根據 ID 或指定資產的參考檔案清單擷取參考檔案清單。

patch

 修補參照。

update

 更新參照。