YouTube Content ID API

有了 YouTube Content ID API，你就能管理 YouTube 資產及其相關內容、參考資料、擁有權、版權和政策。

服務：youtubepartner.googleapis.com

如要呼叫這項服務，建議您使用 Google 提供的用戶端程式庫。如果您的應用程式需要使用您自己的程式庫來呼叫這項服務，請在發出 API 要求時使用下列資訊。

探索文件

探索文件是一種機器可解讀的規格，用於說明和使用 REST API。此文件用於建構用戶端程式庫、IDE 外掛程式，以及與 Google API 互動的其他工具。一項服務可能會提供多個探索文件。這項服務提供下列探索文件：

服務端點

服務端點是指定 API 服務網路位址的基準網址。一項服務可能有多個服務端點。這項服務有以下服務端點，且下方的 URI 皆以此服務端點為基準：

  • https://youtubepartner.googleapis.com

REST 資源：assetLabels

方法
insert POST /youtube/partner/v1/assetLabels
插入擁有者的資產標籤。
list GET /youtube/partner/v1/assetLabels
擷取擁有者所有資產標籤的清單。

REST 資源：assetMatchPolicy

方法
get GET /youtube/partner/v1/assets/{assetId}/matchPolicy
擷取與已驗證使用者相關聯的內容擁有者，為指定資產指定的配對政策。
patch PATCH /youtube/partner/v1/assets/{assetId}/matchPolicy
修補資產的比對政策。
update PUT /youtube/partner/v1/assets/{assetId}/matchPolicy
更新資產的比對政策。

REST 資源：assetRelationships

方法
delete DELETE /youtube/partner/v1/assetRelationships/{assetRelationshipId}
刪除兩個資產之間的關係。
insert POST /youtube/partner/v1/assetRelationships
建立連結兩項資產的關係。
list GET /youtube/partner/v1/assetRelationships
擷取指定資產的關係清單。

REST 資源：assetSearch

方法
list GET /youtube/partner/v1/assetSearch
根據資產中繼資料搜尋資產。

REST 資源：assetShares

方法
list GET /youtube/partner/v1/assetShares
這個方法會擷取合作夥伴擁有的資產共享項目清單，並對應至指定的資產檢視畫面 ID 或擷取與合作夥伴擁有的指定資產共享 ID 相關聯的資產檢視畫面清單。

REST 資源：assets

方法
get GET /youtube/partner/v1/assets/{assetId}
擷取指定資產的中繼資料。
insert POST /youtube/partner/v1/assets
插入含有指定中繼資料的資產。
list GET /youtube/partner/v1/assets
根據資產中繼資料，擷取資產清單。
patch PATCH /youtube/partner/v1/assets/{assetId}
修補指定資產的中繼資料。
update PUT /youtube/partner/v1/assets/{assetId}
更新指定資產的中繼資料。

REST 資源：campaigns

方法
delete DELETE /youtube/partner/v1/campaigns/{campaignId}
刪除擁有者的指定廣告活動。
get GET /youtube/partner/v1/campaigns/{campaignId}
擷取擁有者的特定廣告活動。
insert POST /youtube/partner/v1/campaigns
使用指定的廣告活動資料，為擁有者插入新的廣告活動。
list GET /youtube/partner/v1/campaigns
擷取擁有者的廣告活動清單。
patch PATCH /youtube/partner/v1/campaigns/{campaignId}
修正特定廣告活動的資料。
update PUT /youtube/partner/v1/campaigns/{campaignId}
更新特定廣告活動的資料。

REST 資源：claimHistory

方法
get GET /youtube/partner/v1/claimHistory/{claimId}
擷取指定版權聲明的版權聲明記錄。

REST 資源：claimSearch

方法
list GET /youtube/partner/v1/claimSearch
擷取符合搜尋條件的聲明清單。

REST 資源：claims

方法
get GET /youtube/partner/v1/claims/{claimId}
依 ID 擷取特定版權聲明。
insert POST /youtube/partner/v1/claims
建立版權聲明。
list GET /youtube/partner/v1/claims
擷取內容擁有者管理的聲明清單，並與目前已驗證的使用者相關聯。
patch PATCH /youtube/partner/v1/claims/{claimId}
透過變更政策或狀態，修補現有的聲明。
update PUT /youtube/partner/v1/claims/{claimId}
透過變更政策或狀態來更新現有版權聲明。

REST 資源：contentOwners

方法
get GET /youtube/partner/v1/contentOwners/{contentOwnerId}
擷取指定內容擁有者的相關資訊。
list GET /youtube/partner/v1/contentOwners

擷取符合要求條件的內容擁有者清單。

REST 資源：liveCuepoints

方法
insert POST /youtube/partner/v1/liveCuepoints
在直播中插入提示點。

REST 資源：metadataHistory

方法
list GET /youtube/partner/v1/metadataHistory
無論是哪位內容擁有者提供資料，都能擷取為資產提供的所有中繼資料清單。

REST 資源：musicChangeRequests

方法
create POST /youtube/partner/v1/music/changeRequests
建立要回報給版本或曲目的音樂變更要求。
list GET /youtube/partner/v1/music/changeRequests
擷取已向發布內容或曲目回報的音樂變更要求清單。

REST 資源：musicReleases

方法
list GET /youtube/partner/v1/music/releases
擷取音樂發布內容清單。

REST 資源：musicTracks

方法
list GET /youtube/partner/v1/music/{parent=releases/*}/tracks
擷取音樂曲目清單。

REST 資源：ownership

方法
get GET /youtube/partner/v1/assets/{assetId}/ownership
擷取與已驗證使用者相關聯的內容擁有者為指定資產提供的擁有權資料。
patch PATCH /youtube/partner/v1/assets/{assetId}/ownership
為指定資產提供新的擁有權資訊。
update PUT /youtube/partner/v1/assets/{assetId}/ownership
為指定資產提供新的擁有權資訊。

REST 資源：ownershipHistory

方法
list GET /youtube/partner/v1/ownershipHistory
無論是哪位內容擁有者提供資料，都能擷取資產的擁有權資料清單。

REST 資源：package

方法
get GET /youtube/partner/v1/package/{packageId}
擷取指定套件的資訊。
insert POST /youtube/partner/v1/package
插入僅限中繼資料的套件。

REST 資源：policies

方法
get GET /youtube/partner/v1/policies/{policyId}
擷取指定的已儲存政策。
insert POST /youtube/partner/v1/policies
建立已儲存的政策。
list GET /youtube/partner/v1/policies
擷取內容擁有者已儲存政策的清單。
patch PATCH /youtube/partner/v1/policies/{policyId}
修補指定的已儲存政策。
update PUT /youtube/partner/v1/policies/{policyId}
更新指定的已儲存政策。

REST 資源：referenceConflicts

方法
get GET /youtube/partner/v1/referenceConflicts/{referenceConflictId}
擷取指定參照衝突的相關資訊。
list GET /youtube/partner/v1/referenceConflicts
擷取未解決的參照衝突清單。

REST 資源：references

方法
get GET /youtube/partner/v1/references/{referenceId}
擷取指定參照項目的相關資訊。
insert POST /youtube/partner/v1/references
POST /upload/youtube/partner/v1/references
透過下列任一方式建立參考檔案：
  • 如果您要求上傳參考檔案，YouTube 會根據提供的內容建立參考檔案。
list GET /youtube/partner/v1/references
依 ID 或指定資產的參考檔案清單，擷取參考檔案清單。
patch PATCH /youtube/partner/v1/references/{referenceId}
修補參照。
update PUT /youtube/partner/v1/references/{referenceId}
更新參照。

REST 資源：spreadsheetTemplate

方法
list GET /youtube/partner/v1/spreadsheetTemplate
擷取內容擁有者的試算表範本清單。

REST 資源：uploader

方法
list GET /youtube/partner/v1/uploader
擷取內容擁有者的上傳者清單。

REST 資源：validator

方法
validate POST /youtube/partner/v1/validator
驗證中繼資料檔案。
validateAsync POST /youtube/partner/v1/validatorAsync
以非同步方式驗證中繼資料檔案。
validateAsyncStatus POST /youtube/partner/v1/validatorAsyncStatus
取得非同步驗證狀態。

REST 資源：videoAdvertisingOptions

方法
get GET /youtube/partner/v1/videoAdvertisingOptions/{videoId}
擷取指定影片的廣告設定。
getEnabledAds GET /youtube/partner/v1/videoAdvertisingOptions/{videoId}/getEnabledAds
針對指定合作夥伴或使用者上傳的影片，擷取允許廣告類型的詳細資料。
patch PATCH /youtube/partner/v1/videoAdvertisingOptions/{videoId}
修補指定影片的廣告設定。
update PUT /youtube/partner/v1/videoAdvertisingOptions/{videoId}
更新指定影片的廣告設定。

REST 資源：whitelists

方法
delete DELETE /youtube/partner/v1/whitelists/{id}
移除內容擁有者的許可清單頻道。
get GET /youtube/partner/v1/whitelists/{id}
根據 ID 擷取特定的白名單頻道。
insert POST /youtube/partner/v1/whitelists
將內容擁有者的 YouTube 頻道加入許可清單。
list GET /youtube/partner/v1/whitelists
擷取內容擁有者的許可清單頻道清單。