Method: ownershipHistory.list

無論是哪位內容擁有者提供資料，都能擷取資產的擁有權資料清單。這份清單只會列出每位內容擁有者的最新擁有權資料。不過，如果內容擁有者透過多個資料來源 (API、內容動態饋給等) 提交擁有權資料，清單就會包含每個內容擁有者和資料來源的最新資料。

HTTP 要求

GET https://youtubepartner.googleapis.com/youtube/partner/v1/ownershipHistory

這個網址使用 gRPC 轉碼語法。

查詢參數

參數
assetId

string

assetId 參數會指定你要擷取擁有權資料歷程記錄的 YouTube 資產 ID。
onBehalfOfContentOwner

string

onBehalfOfContentOwner 參數會指出使用者所代表的內容擁有者。這個參數支援帳戶與多個內容擁有者相關聯的使用者。

要求主體

要求主體必須為空白。

回應主體

與資產相關聯的 ownershipHistory 資源清單。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "kind": string,
  "items": [
    {
      object (RightsOwnershipHistory)
    }
  ]
}
欄位
kind

string

API 回應的類型。對於這項作業，值為 youtubePartner#ownershipHistoryList。
items[]

object (RightsOwnershipHistory)

符合要求條件的擁有權記錄 (youtubePartner#ownershipHistory) 資源清單。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/youtubepartner

詳情請參閱 OAuth 2.0 Overview。