YouTube Content ID API - 修訂記錄

注意：YouTube Content ID API 僅供 YouTube 內容合作夥伴使用，並非所有開發人員或 YouTube 使用者都能存取。如果 Google API 控制台 未列出 YouTube Content ID API 服務，請參閱 YouTube 說明中心，進一步瞭解 YouTube 合作夥伴計畫。

本頁面列出 YouTube Content ID API 的異動和說明文件更新。

2025 年 3 月 26 日

自 2025 年 3 月 31 日起，YouTube 將變更 Shorts 觀看次數的計算方式。以往，一部 Shorts 的播放時間達特定秒數後，才計為一次觀看。系統之後會計算 Shorts 開始播放或重播的次數，沒有觀看時間下限。 瞭解詳情

自 2025 年 6 月 30 日起，Content ID API 將依據這項異動進行以下更新：

  • claimSearch.list.sort 的排序順序會更新：
    • DAILY_ENGAGED_VIEWS 會根據先前的觀看次數計算方法，新增每日觀看次數。
    • LIFETIME_ENGAGED_VIEWS 會根據先前的觀看次數計算方法，加入終身觀看次數。
  • assetSearch.list.sort 的排序順序會更新：
    • DAILY_ENGAGED_VIEWS 會根據先前的觀看次數計算方法，新增每日觀看次數。

自 2025 年 9 月 30 日起，Content ID API 將依據這項異動進行以下更新：

  • assetSearch.list.sort 排序順序 VIEWS 將遭到淘汰。
  • claimSearch.list.sort 排序順序 VIEW_COUNT 將遭到淘汰。
  • claimSearch.claimSnippet.videoViews 會更新，以反映 Shorts 觀看次數的最新計算方式。
  • 系統會根據先前的觀看次數計算方法，為觀看次數新增 claimSearch.claimSnippet.engagedViews

2025 年 1 月 14 日

videoAdvertisingOption 資源的 autoGeneratedBreaks[] 欄位已更新，因為我們現在允許同時提供 ad_breaks 和 autoGeneratedBreaks。如果在已定義 adBreaks 的影片中將 autoGeneratedBreaks 設為 true，系統除了手動建立的廣告版位，也會找出適合放送廣告的位置。詳情請參閱支援文章。

2023 年 11 月 10 日

videoAdvertisingOption 資源的 adFormats[] 欄位已更新，因此 third_party 是該欄位的唯一有效值。系統不再支援下列廣告格式：instream_trueview、instream_standard、display、preroll、postroll。詳情請參閱這篇說明文章。

2023 年 6 月 1 日

注意：這是一則淘汰功能的公告。

這項更新包含下列異動：

2022 年 12 月 20 日

assetSearch.list 方法的 ownershipRestriction 查詢參數定義已更新，以便清楚說明如果該參數的值為 none，metadataSearchFields 參數值也必須使用至少一個 ID 篩選器。這項說明文件的變更並不會反映 API 行為的變更。

2022 年 11 月 9 日

asset.get 和 asset.list 方法的說明文件已更新，清楚說明以下項目如何支援多個值：

2022 年 9 月 28 日

已在 asset resource 中新增授權資訊。

2022 年 7 月 18 日

claimSearch.list 方法的 inactiveReasons 說明文件已更新，以反映與 YouTube 工作室一致的改善項目：

  • Studio 先前已移除對 Audio Swap 和 Song Erase 的支援。系統會默默忽略對應的 API 值 audio_removed 和 song_erased，且現在已不再記錄。
  • channel_whitelisted 已由 channel_allowlisted 取代。 雖然先前的值已不再列於文件中，但仍受支援。
  • 目前支援的值為 closed_disabled_monetization、closed_manually、closed_no_adsense、closed_own_video_match、reference_removed、replaced 和 video_modified。

2022 年 6 月 14 日

assetSearch 資源說明文件已更新，反映兩項新屬性：isrcs[] 和 iswcs[]。新的 isrcs[] 和 iswcs[] 屬性值各自包含字串值陣列，每個值都會指定 ISRC 或 ISWC (視情況而定)，並對應至搜尋結果所識別的資產。

建議您使用新資源，而非已納入 assetSearch 資源的 isrc 和 iswc 資源，因為新資源可提供更準確的資料。雖然新屬性可能會列出字串值陣列，但 isrc 和 iswc 屬性各自只會識別與搜尋結果相關聯的一個 ISRC 或 ISWC 代碼。

2022 年 5 月 12 日

用戶端程式庫的連結已更新，指向標準 Google API 用戶端程式庫。已更新 PHP 的預先產生繫結。

2022 年 5 月 3 日

claimSearch.list 方法的 status 參數現在支援更多篩選條件，可根據潛在聲明詳細資料進行篩選。

2022 年 5 月 2 日

assetSearch.list 方法的 Response 說明文件已更新，反映出為了與 AIP-158 保持一致而進行的改善：

  • pageInfo.totalResults 的說明明確指出該值為預估值，而非實際值
  • 已移除 pageInfo.resultsPerPage 和 pageInfo.startIndex 欄位

2022 年 4 月 25 日

assetLabels.list 資源的說明文件已更新，清楚說明 labelPrefix 和 q 要求參數的含義，並說明要求 / 回應支援分頁。

2021 年 12 月 8 日

claimSearch.list 資源的說明文件已更新，正確反映此方法涵蓋的兩種用途：

  • 依 ID (資產、參考檔案或影片) 或查詢字串搜尋
  • 依著作權聲明建立日期、修改日期或狀態搜尋

每個用途都支援不同的查詢參數組合。claimSearch.list 方法的說明文件已更新，說明每種用途支援哪些參數。

2021 年 11 月 17 日

這項更新包含下列異動：

  • claims.update 方法現在支援將未啟用或潛在聲明的狀態更新為 active。claim 資源的 status 屬性定義會提供更多詳細資訊。
  • claim 和 claimSearch 資源的說明文件已更新，反映新增的 studioInfo 物件，其中包含與版權聲明相關的 YouTube 工作室頁面連結。
  • claimSearch.list 方法的 origin 參數支援的值清單已變更。這個參數現在支援四個額外的值：batchTool、inProductShorts、melodyMatch 和 youTubeAdmin。此外，系統已不再支援 dropboxUpload 和 webUpload 值。

2021 年 2 月 26 日

claimSearch.list 方法的 videoId 參數說明文件已更新，指出參數值現在最多可接受 10 個以逗號分隔的影片 ID。如果值包含超過 10 個影片 ID，API 會傳回 badRequest 錯誤 (400 HTTP 回應代碼)。

2018 年 12 月 6 日

注意：這是一則淘汰功能的公告。

API 說明文件已更新，移除對 contentOwnerAdvertisingOptions 資源及其方法的參照。這些方法的使用率極低，我們已在本公告發布前，個別與使用這些方法的 API 使用者聯絡。

2018 年 3 月 21 日

這次更新的修改如下：

  • 從現在起，每次插入、更新或修補音樂影片或錄音資產時，都必須設定 metadataMine.artist 屬性。如果未為這些資源類型設定屬性，API 現會傳回錯誤。此外，請注意，metadataMine.artist 屬性僅適用於音樂影片和錄音藝術家。

2017 年 7 月 24 日

這次更新的修改如下：

  • 新的 package 資源代表透過網路、SFTP 或其他提交機制提交的一組檔案。此 API 支援此資源的兩種方法：

    • package.insert 方法會驗證並上傳僅包含一個中繼資料檔案的純中繼資料檔案包。
    • package.get 方法會擷取先前上傳套件的相關資訊。

  • 針對 validator.validate 方法，我們已更新 uploaderName 屬性的定義，指出該值並非用來識別上傳資料的內容合作夥伴，而是用來識別內容擁有者使用的特定上傳者帳戶 (例如 web-google 或 yt-google) 的值。

  • reference 資源的 status 屬性不再使用 duplicate_on_hold 值，用來指出某個參照是另一個參照的重複項目。相反地，如果參照項目重複，status 屬性的值現在會設為 inactive，而 statusReason 屬性的值則為 REASON_DUPLICATE_FOR_OWNERS。

    不過，如同先前所述，只有在參照項目重複時，資源的 duplicateLeader 屬性才會填入資料。如果已設為已設定，則該屬性的值會標示重複的參照。

2017 年 4 月 17 日

這次更新的修改如下：

  • 新的 assetShare 資源只與組合資產相關，可識別資產資源兩種表示法之間的關係。這些呈現方式反映了新的發布資料模式，旨在讓發布商能更清楚掌握並掌控自身權利如何與錄音資產建立關聯。

    在新模式中，每個錄音檔都會對應至一個專屬資產，稱為曲目檢視畫面。該資產的中繼資料代表 YouTube 顯示的音樂版權資訊標準組合，與特定錄音檔相關聯，並可能綜合多個資料提供者的資訊。

    此外，每位作曲人都有自己的作曲分成資產。作曲分成代表特定發布者為作曲資產提供的資訊。詞曲持份可與多個錄音內容建立關聯。

    assetShare 資源可識別組合檢視畫面和組合共用項目之間的關係。新的 assetShares.list 方法可讓您執行下列任一操作：

    • 提供樂曲檢視畫面的 ID，並擷取授權要求的合作夥伴擁有的對應樂曲持份 (如果有此持份的話)。
    • 提供內容合作夥伴擁有的樂曲持份 ID，並擷取該持份連結的所有樂曲檢視畫面清單。

  • 新的「管理構圖資產」指南說明如何根據提交至這些方法的資產 ID 是否識別構圖檢視畫面或構圖分享，說明不同的 API 方法如何處理要求。

  • contentOwnerAdvertisingOptions 資源的新 claimedVideoOptions.autoGeneratedBreaks 屬性會指出 YouTube 應否在已宣稱的長度超過 10 分鐘的影片中自動產生廣告插播。雖然這項屬性會影響內容擁有者所有長度超過 10 分鐘的影片，但如果影片收到多項版權聲明，則第一個聲明影片著作權的合作夥伴會為該影片設定這項屬性的預設行為。

2016 年 8 月 11 日

這次更新的修改如下：

  • 我們已發布新版《YouTube API 服務條款》(「新版條款」)，詳情請見 YouTube 工程和開發人員網誌，其中針對現行服務條款提供豐富的更新內容。除了修訂條款 (自 2017 年 2 月 10 日起生效) 之外，這次更新也包含多份輔助文件，協助說明開發人員必須遵守的政策。

    如需完整的新版文件，請參閱修訂版條款的修訂版本記錄。此外，日後對更新版條款或相關附件文件的變更，也會在該修訂版本記錄中說明。你可以透過文件中的連結，訂閱該修訂版本記錄中的變更項目 RSS 動態消息。

2016 年 5 月 31 日

這次更新的修改如下：

  • 新資源和方法

    • 新的 validator.validate 方法可讓您判斷中繼資料檔案是否含有驗證錯誤，導致 YouTube 無法順利處理檔案。如果檔案含有錯誤，API 回應的 errors 屬性就會包含驗證錯誤清單，指出每個錯誤的嚴重程度、原因和位置。

  • 新增及更新的錯誤

    • assets.patch 和 assets.update 方法現在支援下列錯誤。提醒您，方法可支援多個具有相同錯誤類型的錯誤。如需完整的可能錯誤清單，請參閱各個方法的錯誤說明文件或「錯誤」頁面。

      錯誤
      invalidValue (400) parameters.assetId
      由於要更新的資產已與其他資產合併，因此要求失敗。使用錯誤訊息中傳回的資產 ID 做為 assetId 參數的值，重新提交要求。

2016 年 3 月 28 日

這次更新的修改如下：

  • 現有資源和方法的更新

    • claim 資源的新 matchInfo.matchSegments[] 屬性包含清單，其中每個項目都會說明與參考影片部分相符的版權聲明影片片段。聲明可以包含多個相符區段。舉例來說，如果上傳影片的音訊和影像內容與參考影片相符，就會有兩個相符片段。一個片段說明音訊比對，另一個片段則說明影像比對。

      針對每個比對片段，API 會傳回相符內容的時間長度和類型 (音訊或影片)。這個 API 也會在版權聲明影片和參考影片中，找出每個相符片段的開始和結束時間偏移。

    • 呼叫 contentOwnerAdvertisingOptions.patch 或 contentOwnerAdvertisingOptions.update 方法時，現在可以更新 contentOwnerAdvertisingOptions 資源的 claimedVideoOptions.newVideoDefaults[] 屬性值。

    • contentOwnerAdvertisingOptions 資源的唯讀 allowedOptions.autoGeneratedBreaks 屬性已淘汰。

  • 新增及更新的錯誤

    • API 的 claims.update 方法現在支援下列錯誤。提醒您，方法可支援多個具有相同錯誤類型的錯誤。如需完整的可能錯誤清單，請參閱各個方法的錯誤說明文件或「錯誤」頁面。

      錯誤
      badRequest (400) alreadyClaimed
      版權聲明與其他現有版權聲明重複，因此無法更新。

    • assets.list 方法偶爾會逾時，並傳回 500 HTTP 回應代碼 (Internal Server Error)，尤其是在要求擷取多個資產的資料，且 fetchMatchPolicy 參數的值為 effective 時。如果 assets.list 要求指定多個資產 ID 並傳回 500 錯誤，請嘗試針對單一資產或較少數量的資產重新提交要求。

    • references.insert 錯誤說明文件已更新，指出如果要求上傳損毀的參考資料檔案，系統會在處理參考資料時才識別該問題。因此，即使 references.insert 要求傳回成功回應，參照項目仍可能無法順利處理。建議您在插入參照後，使用 references.list 方法進行輪詢，確認參照是否如預期啟用。

2016 年 2 月 3 日

這次更新的修改如下：

  • 現有資源和方法的更新

    • API 現已支援產品資訊廣告。產品資訊廣告會突顯與影片內容相關或出現在影片中的產品。這類廣告屬於贊助商資訊卡，會在影片播放期間放送。廣告系統會自動在影片中加入這些資訊卡。觀眾會看到幾秒鐘的資訊卡前導廣告，也可以點選影片右上角的圖示，瀏覽影片的資訊卡。

      這項變更的結果是，product_listing 現在可納入下列屬性的值：

      資源/API 方法 屬性
      contentOwnerAdvertisingOptions allowedOptions.licAdFormats[]
      contentOwnerAdvertisingOptions allowedOptions.ugcAdFormats[]
      contentOwnerAdvertisingOptions claimedVideoOptions.newVideoDefaults[]
      videoAdvertisingOptions adFormats[]
      videoAdvertisingOptions.getEnabledAds countriesRestriction[].adFormats[]

    • assetSearch.list 方法的新 createdBefore 和 createdAfter 會指示 API 只傳回在特定日期之前和/或之後建立的素材資源。

    • 在 assetSearch.list 要求的 API 回應中，type 屬性現在支援 art_track_video 值。YouTube 說明中心提供 Art Track 影片的詳細資訊。

    • claimSearch.list 方法支援下列新參數：

      參數
      referenceId 這個篩選器參數會指定你要擷取版權聲明的參考檔案 YouTube 參考檔案 ID。
      inactiveReasons 這個選用參數可讓您限制 API 回應，只包含因特定原因而處於停用的聲明。參數定義會列出可搜尋的無效宣稱類型。
      partnerUploaded 這個選用布林值參數可讓您指定 API 回應只包含合作夥伴上傳或非合作夥伴上傳的聲明。

    • reference 資源的新 references#origination 物件包含說明參照來源的資訊。

    • references.insert 方法現在支援使用 YouTube 的 gfp_gen 軟體產生的參照資料上傳功能。如果您提供預先產生的指紋，請在上傳的 reference 資源中將 fpDirect 屬性值設為 true。

      請注意，在進行這項變更後，如果您在上傳參照時嘗試設定 fpDirect 屬性，API 就不會傳回錯誤。

  • 新增及更新的錯誤

    說明文件現在會列出 whitelist 資源方法傳回的錯誤。

    此外，下表列出 API 支援的新錯誤，以及可能傳回每個錯誤的方法。請注意，方法可能會傳回多個相同錯誤類型的錯誤。詳情請參閱各個方法的錯誤說明文件，或參閱「錯誤」頁面。

    錯誤
    badRequest (400) inappropriateCampaignTarget
    如果廣告活動嘗試刊登可能不適合某些使用者的影片，campaigns.insert 和 campaigns.update 方法會傳回這項錯誤。如要修正這個錯誤，請選擇其他內容來做為主打內容。
    badRequest (400) canNotCreatePartnerUploadedClaimOnCompositionOrSoundRecordingAssets
    如果您嘗試使用樂曲或錄音資產建立合作夥伴上傳的著作權聲明，claims.insert 方法會傳回此錯誤。
    badRequest (400) existingSoundRecordingOrMusicVideoClaim
    如果指定影片中已存在錄音版權聲明，claims.insert 方法就會傳回此錯誤。您無法透過 API 新增直接合成聲明。
    badRequest (400) asset_id
    如果要求嘗試透過檔案建立參照，但未指定 assetId，references.insert 方法就會傳回這個錯誤。
    badRequest (400) canNotBeActivated
    如果參照無法啟用 (可能是因為參照的狀態或擁有權條件)，references.update 方法會傳回此錯誤。
    badRequest (400) videoNotClaimed
    如果您嘗試擷取廣告選項的影片尚未聲明版權，系統就會傳回這個錯誤，導致您無法取得要求的資訊。videoAdvertisingOptions.get

2015 年 12 月 18 日

根據歐盟 (EU) 法律規定，您必須向歐盟境內的使用者揭露特定資訊，並徵得同意聲明。因此，如果使用者位於歐盟地區，您必須遵守《歐盟地區使用者同意授權政策》。我們已在 YouTube API 服務條款中新增這項規定的通知。

2015 年 4 月 21 日

這次更新的修改如下：

2015 年 3 月 30 日

這次更新的修改如下：

  • 現有資源和方法的更新

    • assetSearch.list 方法的新 isrcs 參數可讓您指定最多 50 個 ISRC 的清單。API 回應會包含與這些 ISRC 相關聯的資產。

    • claimHistory 資源的 event[].reason 屬性支援下列新值。每個原因都會說明發生與聲明相關的特定事件的原因：

      • closed_audio_claim_on_visual_reference
      • closed_partner_exclusion
      • closed_reference_conflict

    • claimSearch.list 方法的新 sort 參數會指定在 API 回應中用來排序資源的方法。根據預設，系統會根據資源建立日期，以反向時間順序 (由最新到最舊) 排序資源。你也可以依據已聲明內容的觀看次數，由高至低排序資源。

      請注意，如果 claimSearch.list 要求也將 status 參數值設為 appealed、disputed、pending、potential 或 routedForReview，系統會依聲明審查期結束的時間排序結果。

    • ownership.update 和 ownership.patch 方法現在可正確列出可在呼叫這些方法時更新的所有屬性。這項變更代表 API 說明文件的修正，並未識別 API 功能的變更。

    • assets.get 和 assets.list 方法的 fetchMatchPolicy 參數現在會將 effective 列為支援的值。這個值會指示 API 伺服器擷取 YouTube 為資產套用的比對政策。

    • assets.list、claims.list、contentOwners.list、policies.list、publishers.list 和 references.list 方法的 id 參數現在都會註明，其參數值最多可包含 50 個以半形逗號分隔的 ID。

  • 新增及更新的錯誤

    下表列出 API 支援的新錯誤，以及可能傳回每個錯誤的方法。請注意，方法可能會傳回多個相同錯誤類型的錯誤。

    詳情請參閱各個方法的錯誤說明文件，或參閱「錯誤」頁面。

    錯誤類型 錯誤詳細資料 說明
    badRequest (400) tooManyIsrcs 如果 isrcs 參數指定的 ISRC 超過 50 個，assetSearch.list 方法會傳回此錯誤。
    badRequest (400) videoIsPrivate 如果您嘗試認領私人影片，claims.insert 方法會傳回此錯誤。只有在影片的隱私權狀態為 public 或 unlisted 時，你才能聲明擁有影片。
    notModified (304) blockOutsideOwnershipUnchanged 如果無法成功修改權杖上的 blockOutsideOwnership 標記，claims.update 方法會傳回此錯誤。導致這項錯誤發生的原因有很多，常見的例子是，指定的修改內容對已聲明的影片沒有任何影響。

2014 年 11 月 7 日

這次更新的修改如下：

  • 現有資源和方法的更新

    • claimSearch.list 方法的 status 參數現在支援 routedForReview 值。這個值會將結果限制為依據資產比對政策中的規則，需要人工審查的版權聲明。

    • claimHistory 資源的 event[].reason 屬性支援下列新值。每個原因都會說明發生與聲明相關的特定事件的原因：

      • closed_invalid_reference_segment
      • closed_noadsense
      • suspended_monetization_on_channel
      • video_content_modified

    • claim 資源的 origin.source 屬性可識別聲明的來源，現在支援 melodyMatch 值。旋律相符聲明表示聲明影片與參考資料共用樂曲。

    • references.insert 方法的說明文件已更新，正確反映 API 為該方法使用兩個不同的端點。這並非 API 功能的變更，而是對現有文件的修正。

      • 如果要求是上傳新的參考檔案，正確的端點為：

        POST https://www.googleapis.com/upload/youtube/partner/v1/references

      • 如果要求是使用已聲明版權的影片做為參考內容來建立參考檔案，正確的端點為：

        POST https://www.googleapis.com/youtube/partner/v1/references

  • 新增及更新的錯誤

    下表列出 API 支援的新錯誤，以及可能傳回每個錯誤的方法。請注意，方法可能會傳回多個相同錯誤類型的錯誤。

    詳情請參閱各個方法的錯誤說明文件，或參閱「錯誤」頁面。

    錯誤類型 錯誤詳細資料 說明
    badRequest (400) invalidLabelName 如果資產標籤名稱無效，assets.insert、assets.update 和 assetLabels.insert 方法會傳回這個錯誤。標籤名稱長度必須介於 2 至 30 個半形字元。但不得包含角括號、逗號、冒號、& 符號或直立線字元 (|)。
    badRequest (400) ownerHaveMaximumNumberOfLabels 如果內容擁有者已定義 2500 個專屬資產標籤 (目前允許的最大數量)，assets.insert、assets.update 和 assetLabels.insert 方法會傳回此錯誤。
    badRequest (400) tooManyLabelsOnOneAsset 如果素材資源已與 30 個資產標籤建立關聯 (這是目前允許的最大數量)，assets.insert 和 assets.update 方法會傳回此錯誤。
    badRequest (400) channelMonetizationSuspended 如果影片的頻道因合作夥伴版權聲明而遭到停權，claims.insert 和 claims.update 方法會傳回這項錯誤。
    badRequest (400) channelNotActive 如果影片的頻道未啟用，claims.update 方法會傳回這個錯誤。

  • 如果要求主體中的資源不含 metadataMine.contentType 屬性，assets.insert 和 assets.update 方法就不會再針對部分資產傳回 badRequest 錯誤。

2014 年 9 月 23 日

這次更新的修改如下：

  • 內容擁有者 ID 變更

    我們在 2014 年 7 月 9 日的修訂版本中宣布的內容擁有者 ID 異動已生效。這項異動後，API 會傳回產生的專屬 ID，用於識別與已驗證使用者或透過 API 管理的資源相關聯的內容擁有者。先前，API 會以人類可讀的名稱做為 ID 傳回，例如「qrs_network」。

    這項異動會影響下列 API 功能，並可能影響在應用程式中使用硬式編碼合作夥伴代碼的合作夥伴。

    • API 現在會將新 ID 做為先前傳回合作夥伴代碼的資源屬性值傳回，例如 contentOwner 資源的 id 屬性。
    • 所有 API 方法都支援 onBehalfOfContentOwner 參數，可識別代表誰提出 API 要求的內容擁有者。變更後，您應將參數設為新 ID，而非合作夥伴代碼。為避免程式碼中斷，參數會在轉換期間接受任一值。
    • 變更後，contentOwners.list 方法的 contentOwnerId 參數應指定新 ID，而非合作夥伴代碼。

  • 現有資源和方法的更新

    • assetSearch.list 方法的新 metadataSearchFields 參數可讓您指定要搜尋的資產中繼資料欄位，以及要在這些欄位中搜尋的值。參數值是以逗號分隔的欄位和值組合清單，每個組合中的欄位和值會以半形冒號分隔。

    • claim 資源的新 appliedPolicy 物件會指定 YouTube 實際套用於聲明的政策。物件的值是 policy 資源。該資源包含提交要求的內容擁有者擁有聲明資產的國家/地區政策資訊。

      適用政策與內容擁有者定義的政策可能會有所不同，差異如下：

      1. 這項政策會考量其他擁有者設定的政策，這些擁有者在部分地區擁有聲明版權資產的部分擁有權，而這些地區與提交 API 要求的內容擁有者相同。

      2. 這項政策會考量 YouTube 管理政策，並套用至內容擁有者擁有聲明版權資產的地區。

    • claimHistory 資源的新 uploaderChannelId 屬性會識別已聲明版權影片所屬頻道的頻道 ID。

2014 年 9 月 8 日

這次更新的修改如下：

  • 新資源和方法

    • 新的 assetLabel 資源會識別可指派給資產的文字標籤。你可以使用資產標籤將資產歸入自訂類別，方便整理素材資源庫。您可以根據標籤搜尋資產，這麼做也可以簡化需要更新特定資產群組的用途。

      • assetLabels.list 方法可讓您擷取內容擁有者的標籤清單。
      • assetLabels.insert 方法可讓您建立新的資產標籤。您也可以呼叫 assets.update 方法並更新資產的標籤，藉此建立新標籤。API 伺服器會自動為先前未定義的任何標籤建立新的 assetLabel 資源。

  • 現有資源和方法的更新

    • asset 資源的 label[] 屬性已更新，提醒您可以呼叫 assets.update 方法來更新資產的標籤。不過，您無法在呼叫 assets.insert 方法時設定資產標籤。

      新的「使用資產標籤」指南說明如何建立及擷取資產標籤，以及如何更新資產標籤或搜尋與特定標籤相關聯的資產。

  • 新增及更新的錯誤

    API 支援新的 assetLabels.list 和 assetLabels.insert 方法的多個新錯誤。

2014 年 7 月 9 日

這次更新的修改如下：

  • 內容擁有者 ID 變更

    以往，API 會使用人類可讀的合作夥伴代碼 (例如「qrs_network」)，來明確識別與已驗證使用者或透過 API 管理的資源相關聯的內容擁有者。2014 年第 3 季，API 將改用 22 個字元的專屬 ID 識別內容擁有者。這項異動會影響下列 API 功能，並可能影響在應用程式中硬式編碼合作夥伴代碼的合作夥伴。

    • API 會將 22 個字元的 ID 傳回為先前傳回合作夥伴代碼的資源屬性值，例如 contentOwner 資源的 id 屬性。
    • 所有 API 方法都支援 onBehalfOfContentOwner 參數，可識別代表誰提出 API 要求的內容擁有者。變更後，您應將參數設為 22 個字元的 ID，而非合作夥伴代碼。為避免程式碼中斷，參數會在轉換期間接受任一值。
    • 變更後，contentOwners.list 方法的 contentOwnerId 參數應指定 22 個字元的 ID，而非合作夥伴代碼。

  • 現有資源和方法的更新

    • asset 資源現在支援 label 屬性，可指定與資產相關聯的資產標籤清單。將一個標籤套用到多個資產就能將資產分組。使用標籤做為搜尋篩選器可以執行批次更新或下載報表，也可以篩選 YouTube 數據分析的資料。

    • assetSearch.list 方法現在支援下列選用參數：

      • labels：限制結果只包含與指定標籤相關聯的資產。根據預設，API 會傳回符合所有指定標籤的資產。不過，您可以使用 includeAnyProvidedLabel 參數指示 API 傳回符合任何指定標籤的素材資源。
      • includeAnyProvidedLabel：與 labels 參數搭配使用時，這個參數會指示 API 傳回與 labels 參數值中指定的任何標籤相關聯的資產。

    • claimHistory 資源現在包含下列新屬性：

    • claimSearch.list 方法現在支援下列選用參數：

      • createdAfter：限制結果只包含指定日期後建立的聲明。
      • createdBefore：限制結果只包含在指定日期之前建立的聲明。
      • includeThirdPartyClaims：與 videoId 參數搭配使用，這個參數會指出是否要在 API 結果中加入第三方宣告。

  • 更詳細的錯誤資訊

    錯誤說明文件現在會指定每種錯誤類型的 HTTP 回應代碼。

  • 新增及更新的錯誤

    下表列出 API 支援的新錯誤，以及可能傳回每個錯誤的方法。請注意，方法可能會傳回多個相同錯誤類型的錯誤。舉例來說，如果您嘗試插入缺少必要中繼資料欄位的 asset 資源，系統就會傳回 required 錯誤。事實上，可能會有多個必要的中繼資料欄位，每個欄位都會傳回錯誤訊息，但訊息內容略有不同。

    詳情請參閱各個方法的錯誤說明文件，或參閱「錯誤」頁面。

    方法 錯誤
    assetSearch.list
    • invalidValue：API 不支援搜尋節目或季別資產。將 type 參數的值變更為支援的值。
    assets.insert
    • conflict：已存在太多 ID 相同的資產 (例如自訂 ID、ISRC 等)。
    • conflict：指定資產的副本數量過多。
    • invalidValue：呼叫 API 的使用者沒有權限建立指定類型的素材資源。
    assets.patch
    assets.update
    • badRequest – API 不支援您嘗試的素材資源類型轉換。
    claimSearch.list
    ownership.patch
    ownership.update
    • badRequest：你無法更新 Art Track 資產的擁有權。
    references.patch
    references.update
    • badRequest：參照項目處於無效狀態，無法執行所嘗試的作業。

2014 年 2 月 3 日

這次更新的修改如下：

  • 現有資源和方法的更新

    • asset 資源現在可以具有 type 值 art_track_video。

    • claimSearch 資源現在包含下列新屬性：

      • origin 物件包含說明聲明建立方式的資訊。
      • thirdPartyClaim 屬性包含布林值，指出聲明是由哪位內容擁有者提出，而該擁有者並非與執行搜尋的使用者相關聯。

    • claimSearch.list 方法現在支援下列選用參數：

      • contentType：限制結果只包含音訊版權聲明、影片版權聲明或視聽版權聲明。
      • origin：指定一或多個版權聲明來源，例如 descriptiveSearch 或 videoMatch，以便找出版權聲明。
      • status：限制結果只包含具有指定狀態的聲明。

    • claim 資源的 status 屬性現在支援以下額外值：appealed、disputed、potential、takedown 和 unknown。

    • claim 資源的新 blockOutsideOwnership 屬性可指出是否應在未明確擁有影片的地區封鎖已聲明版權的影片。根據預設，在未為與聲明相關的資產定義擁有權資料的國家/地區，使用者仍可觀看已聲明著作權的影片。

    • contentOwnerAdvertisingOption 資源的新 allowedOptions.autoGeneratedBreaks 屬性可指出夥伴是否可選擇在 YouTube 自動決定的廣告插播時間點，顯示片中廣告。

    • contentOwners.list 方法現在可以使用指定 https://www.googleapis.com/auth/youtubepartner-content-owner-readonly 範圍的授權權杖來呼叫。

    • policy 資源的新 timeUpdated 屬性會指定政策上次更新的時間。

    • policies.list 方法現在支援選用的 sort 參數，可用於指定結果應依據上次更新時間以遞增或遞減順序排序。

    • referenceConflict 資源的新 expiryTime 屬性會指定參照衝突的審查期結束時間，導致衝突失效。

    • videoAdvertisingOption 資源的新 autoGeneratedBreaks 屬性可指出影片是否應在 YouTube 自動決定的廣告插播時間點，顯示片中廣告。

  • 新增及更新的錯誤

    下表列出 API 支援的新錯誤，以及可能傳回每個錯誤的方法。請注意，方法可能會傳回多個相同錯誤類型的錯誤。舉例來說，如果您嘗試插入缺少必要中繼資料欄位的 asset 資源，系統就會傳回 required 錯誤。事實上，可能會有多個必要的中繼資料欄位，每個欄位都會傳回錯誤訊息，但訊息內容略有不同。

    詳情請參閱各個方法的錯誤說明文件，或參閱「錯誤」頁面。

    方法 錯誤
    assets.insert
    assets.update
    • badRequest：API 不支援對 Art Track 資產執行寫入作業。
    claimSearch.list
    • invalidValue：要求中的 pageToken 參數指定無效的頁面符記。
    claims.insert
    • badRequest：影片頻道未啟用，因此無法建立版權聲明。
    • badRequest – 你嘗試聲明版權的影片不受下架政策規範。如有任何問題，請來信至 copyright@youtube.com
    • badRequest：你無法對指定影片建立第三方版權聲明，因此我們無法受理你的申請。
    • conflict – 影片已針對下架通知提出異議，因此 YouTube 無法建立要求的版權聲明。
    • conflict：影片有有效的下架聲明，因此 YouTube 無法建立要求的聲明。
    references.insert
    • badRequest – 你嘗試使用的版權影片已遭刪除或拒絕，或處理失敗。

  • contentOwnerNotProvided 和 internalError 錯誤並非特定 API 方法專屬，因此不再列在每個方法頁面中。您仍可在 API 錯誤說明文件的「一般錯誤」一節中找到這些錯誤的說明。

2013 年 9 月 12 日

這次更新的修改如下：

  • 新資源和方法

    • 新的 referenceConflict 資源會指出兩個參考檔案之間的衝突，並在發現衝突時列出這些檔案之間的相符項目。referenceConflicts.list 方法可讓您擷取與授權內容擁有者相關的未解決參照衝突清單。referenceConflicts.get 方法可讓您指定專屬的參照衝突 ID，藉此擷取參照衝突。

    現有資源和方法的更新

    • 這個 API 現已支援擷取資產有效配對政策的功能。這項異動與 2013 年 7 月 16 日發布的異動相呼應，當時我們已支援擷取資產的標準中繼資料和擁有權資料。

      如要擷取資產的有效比對政策，請在呼叫 assets.get 或 assets.list 方法時，將 fetchMatchPolicy 參數值設為 effective。在 API 回應中，每個傳回的 asset 資源中的 matchPolicyEffective 物件，都包含該資產適用的有效比對政策。

    • asset 資源的新 ownershipConflicts 物件包含資產擁有權衝突的相關資訊。這個物件的結構類似 ownership 資源，可識別資產擁有者可持有的各類型權利。(對於大多數資產類型，擁有者只能擁有一般資產所有權，但對於樂曲資產，擁有者可以逐項列出表演權、同步權或機械灌錄權的所有權。)

      同樣地，ownershipConflicts 物件會包含個別清單，用於識別一般擁有權、表演權、同步權和機械灌錄權的衝突。每個衝突資料都會標示發生衝突的地域、提供衝突擁有權資料的擁有者，以及每位衝突擁有者聲稱擁有的資產百分比。

    • assets.get 和 assets.get 方法現在支援新的 fetchOwnershipConflicts 參數。這個參數具有布林值，指出 API 要求是否應在 API 回應中擷取資產的擁有權衝突。預設值為 false，表示不會傳回擁有權衝突。

    • assetSearch.list 方法的 q 參數定義已更新，可識別 YouTube 搜尋的中繼資料欄位。

    • references.insert 方法的說明文件現在指出，您必須設定 contentType 屬性的值。這項變更會更新說明文件，以正確反映實際的 API 功能，但不會代表 API 功能有變更。

  • 新增及更新的錯誤

    • API 支援新的 forbidden 錯誤，這類錯誤並非特定方法專屬，表示服務帳戶無法授權所要求的作業。

    • assets.insert 方法現在會在 metadataMine 物件的屬性中，而非 metadata 物件中，找出中繼資料錯誤 (metadata 物件已在 2013 年 7 月 16 日的 API 更新中淘汰)。

    • 「errors」頁面已更新，針對支援 update 和 patch 方法的每個資源，該頁面都會包含一個表格，列出這兩種方法傳回的錯誤。在此之前，這個頁面會分別列出每個方法的錯誤，但清單內容一律相同。

2013 年 7 月 16 日

這次更新的修改如下：

  • 新資源和方法

    • 新的 claimHistory.get 方法可讓您識別並擷取特定宣告的相關資訊。傳回的 claimHistory 資源包含與版權聲明相關的事件清單，例如版權聲明的建立、更新、爭議或關閉。

    • 新的 claimSearch.list 方法可讓您搜尋符合下列任一或所有條件的版權聲明：

      • 版權聲明會與特定資產建立關聯。
      • 版權聲明與特定影片相關聯。
      • 權利聲明會與要求中提供的查詢字串相符。

      API 回應中的每個 claimSnippet 資源都包含版權聲明的詳細資料，包括版權聲明的專屬 ID、狀態、類型 (audio、video 或 audiovisual)，以及與版權聲明相關聯的資產和影片。這項資源也會指定已聲明版權影片的觀看次數，以及已聲明版權影片的標題。

  • 現有資源和方法的更新

    • 說明文件現在會列出具有一組列舉值的屬性支援的值。這類屬性包括 asset 資源的 type 屬性，以及 claim 資源的 status 屬性。

    • 針對 assets.get 和 assets.list 方法，API 現在支援 fetchMetadata 和 fetchOwnership 要求參數的逗號分隔值，讓您能夠擷取多組中繼資料或擁有權資料。

      下列清單說明 asset 資源結構的對應變更，以及這些變更對 get、list、insert、update 或 patch asset 資源的 API 方法所造成的影響。

      • metadata 物件已淘汰，並由 metadataMine 和 metadataEffective 物件取代。新物件可讓 asset 資源包含內容擁有者提出 API 要求時提供的中繼資料，以及 YouTube 判定為資產最準確、完整的中繼資料。

      • 同樣地，ownership 物件已替換為 ownershipMine 和 ownershipEffective 物件。

      • matchPolicy 物件已替換為 matchPolicyMine 物件。(API 目前不支援擷取素材資源有效配對政策的功能)。

      注意：為確保向後相容性，如果您只針對資產要求一個中繼資料版本、一組擁有權資料或一個比對政策，API 回應就會包含已淘汰的物件，以及新支援的物件。舉例來說，如果要求將 fetchMetadata 參數設為 mine，API 回應就會包含 metadata 物件和 metadataMine 物件，兩者都會包含相同的資料。(在功能更新前，系統支援設定 fetchMetadata=mine 的功能，可讓您擷取多個中繼資料版本)。

      不過，如果 fetchMetadata 參數設為 mine,effective，API 回應會包含 metadataMine 和 metadataEffective 物件，但不會包含 metadata 物件。(在這個功能更新前，系統不支援設定 fetchMetadata=mine,effective 的功能，因此不必為了回溯相容性而傳回 metadata 物件)。同樣的原則也適用於 fetchOwnership 和 fetchMatchPolicy 參數。

      同樣地，為了向下相容性，對 insert、update 或 patch asset 資源的要求可以包含 metadataMine 物件或 metadata 物件。設定 asset 資源的擁有權資料或比對政策時，也適用相同的原則。

    • claims.list 方法的 assetId、q 和 videoId 參數已淘汰。如要使用任何上述條件搜尋版權聲明，請使用 claimSearch.list 方法，因為該方法支援所有這些參數。

    • 在 ownership 資源中，general[].ratio、performance[].ratio、synchronization[].ratio 和 mechanical[].ratio 屬性的值現在都採用 double 而非 integer 的內容格式。

    • policy 資源的 rules[].action 屬性定義現在會列出該屬性的有效值：block、monetize、takedown 和 track。不過，請注意，您無法使用 API 將下架政策套用至版權聲明。

    • 如果參考資料是透過將資產與已上傳至連結至 CMS 帳戶的 YouTube 頻道中現有 YouTube 影片建立，就會顯示 reference 資源的新 claimId 屬性。在這種情況下，這個欄位會包含版權聲明 ID，代表資產與影片之間的關聯。

    • reference 資源的新 excludedIntervals[] 屬性會指定參考資料中的時間間隔清單，YouTube 在嘗試比對參考資料時應忽略這些時間間隔。每個間隔都會指定開始和結束時間，以從影片開頭算起的秒數為單位。

    • API 不再要求在 references.update 或 references.patch 要求內容中傳送的 reference 資源中設定 status 屬性。

    • 說明文件已修正，正確說明 videoAdvertisingOptions.getEnabledAds 方法的 API 回應格式。回應是 youtubePartner#videoAdvertisingOptionGetEnabledAds 資源，其中包含下列資訊：

      • id：YouTube 用來識別與設定相關的已聲明版權影片的 ID。

      • adBreaks：物件清單，其中每個物件都包含影片播放前、播放期間或播放後可放送廣告的時間點資訊。每個物件也可以指定廣告插播的其他屬性，例如廣告插播期間的廣告版位，以及每個版位可放送的廣告類型。

      • adsOnEmbeds：布林值欄位，指出 YouTube 是否可以在嵌入式播放器中播放影片時放送廣告。

      • countriesRestriction：物件清單，其中每個物件會標示一組地區，以及在該地區播放影片時使用的廣告格式。

  • 新增及更新的錯誤

    • 下表列出 API 支援的新錯誤，以及可能傳回每個錯誤的方法。並找出變更的錯誤。請注意，方法可能會傳回多個相同錯誤類型的錯誤。舉例來說，如果您嘗試插入缺少必要中繼資料欄位的 asset 資源，系統就會傳回 required 錯誤。事實上，可能會有多個必要的中繼資料欄位，每個欄位都會傳回錯誤訊息，但訊息內容略有不同。

      詳情請參閱各個方法的錯誤說明文件，或參閱「錯誤」頁面。

      方法 錯誤
      assets.insert
      assets.update
      assets.patch
      • invalidValue 和 required 錯誤先前與 metadata 物件的子項屬性相關聯，現在則與 metadataMine 物件中的相同子項屬性相關聯。
      claimHistory.get
      • notFound – 找不到你要擷取記錄的版權聲明。
      • required：要求未指定 claimId 參數的值。
      claimSearch.list
      claims.list
      • badRequest：要求指定無效的條件。最多只能指定下列其中一個篩選器參數：q、assetId、videoId。
      claims.insert
      • badRequest – 您嘗試建立的版權聲明無效，因為要求的內容擁有者並非與版權聲明相關聯的資產擁有者。
      • badRequest：您所代表的內容擁有者無權建立含有指定動作的政策。
      • invalidValue – 你所代表的內容擁有者沒有權限透過 API 聲明版權。
      contentOwners.list
      • badRequest：要求指定無效的條件。您必須指定下列其中一個篩選器參數：fetchMine、id。(先前，錯誤訊息列出的是不同的篩選器參數組合，包括 has_conflicts_with、restrict_to_user、name_prefix 和 id)。
      ownership.update
      ownership.patch
      • badRequest – 更新組合式資產擁有權資料的要求必須指定精細的擁有權資料 (mechanical、performance、synchronization 和/或 lyric 權利)，而非 general 擁有權。系統新增支援 lyric 權利類型。
      policies.insert
      policies.update
      policies.patch
      • invalidValue：要求包含無效的政策規則，因為 API 不支援建立或修改指定 takedown 動作的政策。這個錯誤會回報 invalidPolicyTakedownAction 的原因，並取代已淘汰的 invalidPolicyConditionalTakedown 錯誤。
      references.insert
      • badRequest：要求必須傳送媒體檔案，或為 claimId 要求參數指定值。不過，要求可能不會傳送媒體檔案，且不會為 claimId 要求參數指定值。
      • badRequest：同一部 YouTube 影片的另一項版權聲明已建立相同內容的參考檔案。
      • badRequest：API 不支援在建立參照時為 fpDirect 屬性設定值。
      • internalError – 上傳的媒體檔案有問題。
      • invalidValue：contentType、assetId 或 claimId 要求參數的值無效。錯誤會指出無效的值。
      • notFound：找不到您指定的素材資源或聲明。請檢查要求中的 assetId 和 claimId 參數值。
      • required：要求必須為 contentType 參數指定值。
      references.insert
      references.update
      references.patch
      • invalidValue：為參照指定的 excludedIntervals 無效。請注意，您無法在停用參照時指定排除間隔。

2013 年 5 月 10 日

這次更新的修改如下：

2013 年 4 月 8 日

這次更新的修改如下：

  • 該 API 已重新命名為 YouTube Content ID API。

  • assetMatchPolicy 資源中的幾個屬性已變更：

    • kind 屬性值已從 youtubePartner#policy 變更為 youtubePartner#assetMatchPolicy。
    • 新的 policyId 屬性包含可用來唯一識別已儲存的政策資源 的值。
    • rules[].subaction 屬性值現在是字串清單，而非字串。
    • rules[].conditions.contentMatchType 屬性值現在是字串清單，而非字串。
    • 已移除 id、name 和 description 屬性。

  • assetMatchPolicy.update 方法的說明文件已更新，反映您在呼叫方法時，可以為 policyId 屬性或 rules[] 物件設定值的事實。

  • claims 資源現在支援多項新屬性：

    屬性名稱 值 說明
    timeCreated datetime 版權聲明的建立日期和時間。
    matchInfo object matchInfo 物件包含產生聲明的相符內容相關資訊。只有在上傳的影片與現有參考檔案相符，系統才會自動產生版權聲明，並將這項資訊納入 claim 資源。
    matchInfo.referenceId string YouTube 用來識別產生比對結果的參照 reference 的專屬 ID。
    matchInfo.longestMatch object longestMatch 物件包含參考檔案與上傳影片之間最長相符程度的資訊。
    matchInfo.longestMatch.durationSecs unsigned long 比對的時間長度，以秒為單位。
    matchInfo.longestMatch.userVideoOffset unsigned long 比對開始時間的時間偏移量，以從上傳影片開頭算起的秒數為單位。
    matchInfo.longestMatch.referenceOffset unsigned long 比對開始時間的時間偏移量，以從參考值開頭算起的秒數為單位。
    matchInfo.totalMatch object totalMatch 物件包含上傳影片與參考檔案相符的總量，以及參考檔案與上傳影片相符的總量。如果上傳的影片或參考影片中，有重複內容以循環播放，這些值可能會有所不同。舉例來說，如果上傳的影片包含參考檔案中的 10 秒片段，但該片段重複了 6 次，則上傳影片中的相符內容總長度為 60 秒，但參考檔案中的相符內容總長度只有 10 秒。
    matchInfo.totalMatch.userVideoDurationSecs unsigned long 上傳影片與參考檔案相符的總長度 (以秒為單位)。
    matchInfo.totalMatch.referenceDurationSecs unsigned long 與上傳影片相符的參考內容總長度 (以秒為單位)。
    origin object origin 物件包含說明聲明來源的資訊。
    origin.source string 版權聲明的來源。

  • claims 資源中的 policy 屬性已更新，以便指出無法更新 AudioSwap 聲明的值。

  • metadataHistory 資源的 timeProvidedMs 屬性已重新命名為 timeProvided。

  • ownershipHistory 資源的 timeProvidedMs 屬性已重新命名為 timeProvided。

  • ownershipHistory.list 方法的定義已更新，指出該方法只會擷取每位內容擁有者的最新擁有權資料。不過，如果內容擁有者透過多個資料來源 (API、內容動態饋給等) 提交擁有權資料，清單就會包含每個內容擁有者和資料來源的最新資料。

  • policy 資源中的幾個屬性已變更：

    • rule 屬性已重新命名為「rules」。
    • rules[].subaction 屬性值現在是字串清單，而非字串。
    • rules[].conditions.contentMatchType 屬性值現在是字串清單，而非字串。

  • policies.insert 和 policies.update 方法的說明文件已更新，反映出您可以在呼叫這些方法時為 rules[] 物件設定值。

  • 多個 API 方法支援新的錯誤類型。下表列出方法，並簡要說明新支援的錯誤類型。在許多情況下，某個類型可能會有多個錯誤。舉例來說，如果您嘗試插入缺少必要中繼資料欄位的 asset 資源，系統就會傳回 required 錯誤。事實上，可能會有多個必要的中繼資料欄位，每個欄位都會傳回錯誤訊息，但訊息內容略有不同。

    詳情請參閱各個方法的錯誤說明文件，或參閱「錯誤」頁面。

    方法 錯誤
    assets.insert
    • invalidValue：資產中繼資料欄位含有無效的值。
    • required：缺少必填的資產中繼資料欄位。
    assets.update
    assets.patch
    • forbidden – 合作夥伴嘗試更新的資產並非其擁有的資產。
    • invalidValue：資產中繼資料欄位含有無效的值。
    • notFound：素材資源與找不到的季別資產或節目資產相關聯。
    • required：缺少必填的資產中繼資料欄位。
    claims.insert
    • badRequest：要求嘗試聲明影片版權，但系統不允許。
    ownership.update
    ownership.patch
    • badRequest：要求定義的某個地區總擁有權超過 100%。
    policies.insert
    policies.patch
    policies.update
    • conflictingPolicyRules – 政策包含相衝突的政策規則。

  • 新的「errors」頁面會列出 API 可能傳回的錯誤。這個頁面包含一般錯誤，這些錯誤可能會發生在多種不同的 API 方法中，也可能會發生在特定方法中。

2013 年 1 月 18 日

這次更新的修改如下：

  • 您可以透過新發布的 videoAdvertisingOptions.getEnabledAds 方法，擷取特定合作夥伴或使用者上傳影片可用的廣告類型詳細資料。

  • assetSearch.list 方法的 ownershipRestriction 參數定義已更新，指出預設參數值為 mine，表示 API 應只擷取目前使用者擁有的資產。

  • assets.list 方法的說明文件反映了以下變更：

    • id 參數現在為必要參數。

    • 新支援的 fetchMatchPolicy 參數可讓您指出 API 要求是否也應擷取您為資產設定的比對政策。

    • 您可以使用新支援的 fetchOwnership 參數，指出 API 要求是否也應擷取資產的擁有權資料。

    • API 傳回的素材資源清單不再包含分頁資料。因此，API 回應中已移除 nextPageToken 屬性和 pageInfo 物件。pageInfo 物件包含 totalResults、resultsPerPage 和 startIndex 屬性。

  • claims 資源說明文件已更新，指出您必須在建立版權聲明時指定政策。(如果插入的聲明未指定政策，YouTube 目前不會套用預設的使用政策，但說明文件先前指出會這樣做)。

  • policy 資源的 hasUnpublishedDraft 屬性已淘汰。

  • policies.list 方法新支援的 id 參數可讓您識別 API 要求應擷取的已儲存政策。只有目前已驗證的內容擁有者，才能擷取相關政策。

  • references.patch 和 references.update 方法的 releaseClaims 參數定義已更新，指出該參數僅在聲明狀態更新為 inactive 時才有效。在這種情況下，您也可以將 releaseClaims 參數的值設為 true，釋出參照產生的所有比對聲明。

  • references.patch 和 references.update 方法都已更新，提醒您在執行這兩種作業時，必須指定參照狀態。

  • 多個 API 方法支援新的錯誤類型。下表列出方法和新支援的錯誤：

    方法 錯誤類型 錯誤詳細資料 說明
    guideCategories.list notFound Unavailable 找不到您嘗試擷取比對政策的資產。
    claims.get notFound Unavailable 找不到你要擷取的聲明。
    ownership.patch invalidValue Unavailable 你提供的擁有權資料包含無效值。
    ownership.update invalidValue Unavailable 你提供的擁有權資料包含無效值。