Method: references.insert

透過下列其中一種方式建立參照：

  • 如果你要求上傳參考檔案，YouTube 會根據所提供的內容建立參考檔案。你可以提供影片/音訊檔案或預先產生的指紋。如要提供預先產生的指紋，請在要求主體中，將 reference 資源的 fpDirect 屬性設為 true。在這個流程中，您可以使用多部分或resumable的上傳流程來提供參考內容。
  • 如要用已聲明版權影片當做參考內容來建立參考檔案，請使用 claimId 參數識別版權聲明。

HTTP 要求

  • 上傳 URI，適用於媒體上傳要求：
    POST https://youtubepartner.googleapis.com/upload/youtube/partner/v1/references
  • 中繼資料 URI，適用於僅限中繼資料的要求：
    POST https://youtubepartner.googleapis.com/youtube/partner/v1/references

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

查詢參數

參數
claimId

string

claimId 參數會指定應建立參考檔案的現有版權聲明的 YouTube 聲明 ID。(版權影片會用來當做參考內容)。
onBehalfOfContentOwner

string

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

要求主體

要求主體包含 Reference 的例項。

回應主體

如果成功，回應主體會包含 Reference 的執行例項。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。