REST Resource: claims

資源：Claim

claim 會將合作夥伴或使用者上傳的影片連結至與影片相符的資產，版權聲明可以指出影片與資產的音訊、影片或影音 (影音) 元素相符。而著作權擁有者希望 YouTube 對已聲明版權影片套用這項政策。

JSON 表示法 
{
  "kind": string,
  "policy": {
    object (Policy)
  },
  "timeCreated": string,
  "contentType": string,
  "ugcType": string,
  "isPartnerUploaded": boolean,
  "timeStatusLastModified": string,
  "blockOutsideOwnership": boolean,
  "status": string,
  "appliedPolicy": {
    object (Policy)
  },
  "id": string,
  "assetId": string,
  "videoId": string,
  "origin": {
    object (Origin)
  },
  "matchInfo": {
    object (MatchInfo)
  },
  "studioInfo": {
    object (StudioInfo)
  }
}
欄位
kind

string

API 資源的類型。對於 claim 資源，這個值為 youtubePartner#claim。
policy

object (Policy)

版權聲明擁有者提供的政策。
timeCreated

string

版權聲明的建立時間。
contentType

string

這個值代表版權聲明是否涵蓋已聲明版權內容的音訊、影片或影音部分。
ugcType

string

版權聲明的使用者原創內容類型 (標準、優質、歌曲)。
isPartnerUploaded

boolean

指出版權聲明是否為合作夥伴上傳的版權聲明。
timeStatusLastModified

string

著作權聲明狀態和/或狀態詳細資料上次修改的時間。
blockOutsideOwnership

boolean

指出是否應在未明確擁有版權的國家/地區封鎖已聲明版權影片。
status

string

版權聲明狀態。更新著作權聲明時，您可以將狀態從「active」更新為「inactive」，才能有效撤銷著作權聲明，但 API 不支援其他更新著作權聲明狀態。
appliedPolicy

object (Policy)

版權聲明可查看擁有者的適用政策。這可能與影片最後的著作權聲明政策不同，因為未考量到其他合作夥伴相同著作權聲明的政策。
id

string

YouTube 指派的 ID，用於識別版權聲明。
assetId

string

用於識別版權聲明相關資產的專屬 YouTube 資產 ID。
videoId

string

用於識別版權聲明相關影片的專屬 YouTube 影片 ID。
origin

object (Origin)
matchInfo

object (MatchInfo)

如果這項著作權聲明是根據您提供的參考檔案自動產生，這個區段會提供產生該聲明的比對結果詳細資料。
studioInfo

object (StudioInfo)

包含會連回 YouTube 工作室聲明相關頁面的網址。

來源

這個物件包含說明中繼資料或擁有權資料來源的資訊。

JSON 表示法 
{
  "source": string
}
欄位
source

string

MatchInfo

與版權聲明有關的資訊。

JSON 表示法 
{
  "matchSegments": [
    {
      object (MatchSegment)
    }
  ],
  "referenceId": string,
  "longestMatch": {
    object (LongestMatch)
  },
  "totalMatch": {
    object (TotalMatch)
  }
}
欄位
matchSegments[]

object (MatchSegment)

每個比對區隔的詳細資料。清單中的每個項目都包含與版權聲明相關的一個比對區段的相關資訊。可能會有多個比對區隔。舉例來說，如果上傳影片的音訊和影片內容與參考影片的相符，就會有兩個比對片段。其中一個片段用於說明音訊相符，另一個則用於描述影片比對結果。
referenceId

string

產生這個比對相符項目的參照 ID。
longestMatch

object (LongestMatch)

參考檔案和使用者影片之間最長相符片段的詳細資料。
totalMatch

object (TotalMatch)

參考檔案總數和使用者影片內容相符程度的詳細資料。請注意，如果參照或使用者影片中含有迴圈，這兩個值可能不同。

MatchSegment

版權聲明中單一相符片段的相關資訊。

JSON 表示法 
{
  "video_segment": {
    object (Segment)
  },
  "reference_segment": {
    object (Segment)
  },
  "channel": string,
  "manual_segment": {
    object (Segment2)
  }
}
欄位
video_segment

object (Segment)

videoSegment 物件包含與已聲明著作權影片相符部分的相關資訊。
reference_segment

object (Segment)

referenceSegment 物件包含參考資料內容相符部分的相關資訊。
channel

string

指出已聲明著作權影片與參考影片相符的方式。
manual_segment

object (Segment2)

在手動聲明著作權時，manualSegment 物件會包含相關資訊，指出影片要比對哪些特定部分為相符。

區隔

這項資源代表包含開始和結束時間的簡單區段，格式為「hh:mm:ss.mmm」字串。

JSON 表示法 
{
  "start": string,
  "duration": string,
  "kind": string
}
欄位
start

string

區隔的開始時間，從一開始以毫秒為單位。
duration

string

區隔的時間長度 (以毫秒為單位)。
kind

string

API 資源的類型。如果是區隔資源，這個值為 youtubePartner#segment。

Segment2

這項資源代表另一個包含開始和結束時間的簡單區段，格式為「hh:mm:ss.mmm」字串。

JSON 表示法 
{
  "start": string,
  "kind": string,
  "finish": string
}
欄位
start

string

區隔的開始時間，從一開始以毫秒為單位。
kind

string

API 資源的類型。如果是區隔資源，這個值為 youtubePartner#segment。
finish

string

區隔的結束時間，從一開始以毫秒為單位。

LongestMatch

最長相符的著作權聲明。

JSON 表示法 
{
  "durationSecs": string,
  "userVideoOffset": string,
  "referenceOffset": string
}
欄位
durationSecs

string

參考檔案與使用者影片之間最長比對的時間長度。
userVideoOffset

string

使用者影片開始播放時最長的偏移值 (以秒為單位)。
referenceOffset

string

最長的相符項目開始時參照的偏移量 (以秒為單位)。

TotalMatch

聲明總數相符。

JSON 表示法 
{
  "userVideoDurationSecs": string,
  "referenceDurationSecs": string
}
欄位
userVideoDurationSecs

string

使用者影片中與參考檔案相符的內容總數 (以秒為單位)。
referenceDurationSecs

string

參考檔案中與使用者影片相符的內容總數 (以秒為單位)。

方法

get

 依據 ID 擷取特定聲明。

insert

 建立著作權聲明。

list

 擷取與目前驗證使用者相關聯的內容擁有者管理著作權聲明清單。

patch

 透過變更政策或狀態來修補現有著作權聲明。

update

 變更現有版權聲明的政策或狀態，更新現有版權聲明。