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
Retrieves a list of the ownership data for an asset, regardless of which content owner provided the data.

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}
Retrieves a specific whitelisted channel by ID.
insert POST /youtube/partner/v1/whitelists
為內容擁有者將 YouTube 頻道加入許可清單。
list GET /youtube/partner/v1/whitelists
擷取內容擁有者的許可清單頻道。