修訂記錄

本頁面列出 YouTube Data API (v3) 的變更與說明文件更新內容。訂閱這份變更記錄訂閱

2024 年 3 月 13 日

注意:這是淘汰公告。

這次更新的修改如下:

captions.insertcaptions.update 方法的 sync 參數已淘汰。YouTube 將於 2024 年 4 月 12 日起停止支援這個參數。

這項變更生效後,開發人員必須在插入或更新字幕軌時提供時間資訊,否則上傳會失敗。

2024 年 3 月 12 日

這次更新的修改如下:

已更新 captions 資源的說明文件,請注意,snippet.name 欄位的長度上限是 150 個字元。如果曲目名稱長度超過上限,API 就會傳回 nameTooLong 錯誤。

2024 年 3 月 7 日

注意:這是淘汰公告。

已淘汰 channel 資源屬性 brandingSettings.channel.moderateComments。YouTube 將於 2024 年 3 月 7 日起停止支援這個參數。

2024 年 1 月 31 日

這次更新的修改如下:

channels.list 方法的新 forHandle 參數可讓您指定頻道的 YouTube 帳號代碼,藉此擷取頻道的相關資訊。

2023 年 11 月 9 日

由於系統不會透過 API 呼叫傳回 videoId 資源,因此 Comments 底下對 videoId 資源的所有參照也已移除。

2023 年 9 月 12 日

注意:這是淘汰公告。

comments.markAsSpam 方法已淘汰數年。YouTube 已不支援這個方法,且不再支援此 API。

在參照 comments.markAsSpam 方法的所有文件中,已新增淘汰通知。

2023 年 8 月 22 日

search.list 方法現在支援 videoPaidProductPlacement 參數。您可以使用這個參數篩選搜尋結果,僅納入創作者標示為含有付費宣傳內容的影片。

2023 年 8 月 18 日

video 資源的 liveStreamingDetails.concurrentViewers 定義已更新,請注意,YouTube Data API 傳回的並行觀眾人數可能與經過處理且去垃圾內容的並行觀眾人數不同,但可透過 YouTube 數據分析取得。如要進一步瞭解直播指標,請前往 YouTube 說明中心

2023 年 8 月 7 日

在 2023 年 6 月 12 日宣布search.list 方法的 relatedToVideoId 參數已淘汰。系統已不再支援該參數,且該參數的參照也已從 API 說明文件中移除。

2023 年 6 月 28 日

thumbnails.set 方法現在支援 uploadRateLimitExceeded 錯誤,表示頻道在過去 24 小時內上傳了太多縮圖,請稍後再試。

2023 年 6 月 12 日

注意:這是淘汰公告。

search.list 方法的 relatedToVideoId 參數已淘汰。YouTube 將於 2023 年 8 月 7 日起停止支援這個參數。

目前,search.list 方法的說明文件已新增淘汰通知。此參數將在 2023 年 8 月 7 日當天或之後完全從 search.list 說明文件中移除。

另外,API 導入指南列出瞭如何擷取相關影片的範例。

2022 年 8 月 22 日

video.statistics 欄位的類型註解修正為未簽署的 Long 字串。

2022 年 8 月 5 日

YouTube 變更字幕 ID 的產生方式。為因應這項異動,YouTube 將為所有字幕軌指派新的字幕 ID。對於儲存 caption_id 值的應用程式,這項變更可能具有回溯相容性,但不會影響不會儲存 caption_id 值的應用程式。

從現在起到 2022 年 12 月 1 日,captions.listcaptions.updatecaptions.downloadcaptions.delete 方法將同時支援新舊字幕軌 ID。然而,自 2022 年 12 月 1 日起,YouTube 將停止支援舊的字幕軌 ID。屆時,使用舊字幕軌 ID 呼叫上述任何 API 方法將會導致 captionNotFound 錯誤。

為了因應這項異動,您應計劃在 2022 年 12 月 1 日前完整取代所有已儲存的字幕軌資料。也就是說,對於您儲存字幕軌資料的任何影片,您應刪除目前儲存的資料,然後呼叫 captions.list 方法以擷取目前的影片字幕軌組合,並照常將資料儲存在 API 回應中。

2022 年 7 月 12 日

《YouTube API 服務條款》已更新。詳情請參閱《YouTube API 服務條款 - 修訂版本記錄》。

2022 年 4 月 27 日

videos.insert 方法說明已更新,請注意,上傳影片的檔案大小上限已從 128GB 提高為 256GB。

2022 年 4 月 8 日

subscriptions.list 方法的 myRecentSubscribersmySubscribers 參數定義皆已更新,以請注意 API 傳回的訂閱者數量上限可能有限。這項變更代表說明文件更正,而非 API 行為變更。

2021 年 12 月 15 日

2021 年 11 月 18 日的公告所述,隨著調整措施,防止整個 YouTube 平台顯示影片的不喜歡人數video 資源的 statistics.dislikeCount 屬性現已設為不公開。

如要進一步瞭解這項異動,請造訪 YouTube 官方網誌

2021 年 11 月 18 日

除了針對整個 YouTube 平台提供不公開的影片不喜歡人數異動外,video 資源的 statistics.dislikeCount 屬性也將於 2021 年 12 月 13 日起設為不公開。這表示只有在影片擁有者已驗證 API 要求時,該 API 回應才會納入來自 videos.list 端點的 API 回應。

videos.rate 端點不受這項異動影響。

如未公開顯示不喜歡人數,但仍需要 API 用戶端的不喜歡次數,可以申請列入豁免清單。如要申請豁免資格,您必須填寫這份申請表

如要進一步瞭解這項異動,請造訪 YouTube 官方網誌

2021 年 7 月 2 日

注意:這是淘汰公告。

commentThreads.update 端點已淘汰,我們不再提供支援。 此端點重複提供透過其他 API 端點使用的功能。您可以改為呼叫 comments.update

方法。如果您的程式碼需要 commentThreads 資源,請對 commentThreads.list 方法發出次要呼叫。

2021 年 7 月 1 日

使用 YouTube API 服務的所有開發人員都必須完成 API 法規遵循稽核,才能獲得超過預設配額 (10,000 個單位) 的授權。截至目前為止,開發人員均已填寫並提交 YouTube API 服務 - 稽核與配額擴充表單,並完成法規遵循稽核程序和額外配額單位分配要求。

為釐清這些程序,並進一步滿足使用 Google API 服務的開發人員需求,我們新增了三份新表單和填寫這些表單的指南:

  • 稽核的開發人員要求表單:如果開發人員已通過 API 法規遵循稽核,可以填寫並提交這份較短的表單,申請延長配額。
  • 申訴表單:如果開發人員的 API 專案未通過法規遵循稽核 (或拒絕提高配額單位),可以填寫並提交這份表單。
  • 控制權異動:開發人員,或是代表開發人員操作 API 用戶端的任何一方,如果對 API 專案進行控制權異動 (例如透過股票買賣、合併或其他形式的公司交易),則必須填寫並提交這份表單。方便 YouTube 的 API 團隊更新記錄、稽核新 API 專案的用途是否符合規定,以及驗證開發人員目前的配額分配情形。

透過每份新表單,我們即可得知您的 YouTube API 使用量,讓我們為您提供更完善的協助。

如需更多詳細資訊,請參閱新的 API 法規遵循稽核指南

2021 年 5 月 12 日

注意:這是淘汰公告。

本次更新涵蓋下列 API 變更:

  • channel 資源的 contentDetails.relatedPlaylists.favorites 屬性已淘汰。「最愛的影片」功能在過去幾年內已淘汰,如 2016 年 4 月 28 日的修訂版本記錄項目所述。

    在更新之前,如果 API 用戶端嘗試將影片加入不存在的收藏播放清單,API 仍會建立新的播放清單。日後將不會建立播放清單,而且 API 會傳回錯誤。如果嘗試透過新增、修改或刪除項目來修改收藏的播放清單,也已於先前公告中淘汰,且可能隨時會開始傳回錯誤。

  • 下列 channel 資源屬性已淘汰。YouTube 工作室使用者介面和 YouTube 均不支援這些屬性。因此也不再支援透過 API 使用。

    • brandingSettings.channel.defaultTab
    • brandingSettings.channel.featuredChannelsTitle
    • brandingSettings.channel.featuredChannelsUrls[]
    • brandingSettings.channel.profileColor
    • brandingSettings.channel.showBrowseView
    • brandingSettings.channel.showRelatedChannels

    所有屬性皆已從 channel 資源表示法中移除,且相關定義已從資源的屬性清單中移除。此外,與這些屬性相關的錯誤也已從方法專屬說明文件中移除。

  • 下列 channelSection 資源屬性已淘汰。YouTube 工作室使用者介面和 YouTube 均不支援這些屬性。因此也不再支援透過 API 使用。

    • snippet.style
    • snippet.defaultLanguage
    • snippet.localized.title
    • localizations
    • localizations.(key)
    • localizations.(key).title
    • targeting
    • targeting.languages[]
    • targeting.regions[]
    • targeting.countries[]

    與這項變更同時,我們也淘汰了 channelSection.list 方法的 hl 參數,因為其支援的功能不受支援。

    所有屬性皆已從 channelSection 資源表示法中移除,且相關定義已從資源的屬性清單中移除。此外,與這些屬性相關的錯誤也已從方法專屬說明文件中移除。

  • 對於 channelSection 資源的 snippet.type 屬性,下列值已淘汰。YouTube 頻道頁面已不支援這些值,因此也不再支援透過 API 使用這些值。

    • likedPlaylists
    • likes
    • postedPlaylists
    • postedVideos
    • recentActivity
    • recentPosts
  • playlist 資源的 snippet.tags[] 屬性已淘汰。YouTube 已不支援這項屬性,因此 API 不再支援這項屬性。

2021 年 2 月 9 日

playlistItem 資源支援兩種新屬性:

2021 年 1 月 28 日

這次更新的修改如下:

  • playlistItems.deleteplaylistItems.insertplaylistItems.listplaylistItems.updateplaylists.deleteplaylists.listplaylists.update 方法皆支援新的 playlistOperationUnsupported 錯誤。如果要求嘗試執行特定播放清單不允許的作業,就會發生錯誤。舉例來說,使用者無法從自己上傳的影片播放清單中刪除影片,也不能刪除播放清單本身。

    在所有情況下,這個錯誤會傳回 400 HTTP 回應代碼 (Bad Request)。

  • playlistItems.list 方法的 watchHistoryNotAccessiblewatchLaterNotAccessible 錯誤已從說明文件中移除。雖然使用者的觀看記錄和「稍後觀看」清單確實無法透過 API 存取,但這類錯誤不會由 API 傳回。

2020 年 10 月 15 日

我們在《開發人員政策》中新增了兩個部分:

  • 新的第 III.E.4.i 節針對透過 YouTube 嵌入式播放器收集及傳送的資料提供了額外資訊。在使用者與播放器互動以表示播放意圖之前,您透過任何 YouTube 嵌入式播放器傳送給我們的使用者資料均由您負責。你可以將自動播放設為 False,藉此限制使用者與 YouTube 互動前就與 YouTube 分享的資料。
  • 新的第 III.E.4.j 節是檢查兒童專屬 (MFK) 狀態,再將其嵌入網站和應用程式。您有責任瞭解嵌入在 API 用戶端中的影片是否為兒童專屬,並視情況處理從嵌入播放器收集到的資料。因此,您必須先使用 YouTube Data API 服務檢查內容狀態,才能透過任何 YouTube 嵌入式播放器將內容嵌入您的 API 用戶端。

新版找出影片的 MadeForKids 狀態指南說明如何使用 YouTube Data API 服務查詢影片的 MFK 狀態。

為因應這些變更,「嵌入式播放器參數」說明文件中新增了提醒,說明如果啟用自動播放功能,系統會在使用者不與玩家互動的情況下執行播放作業;系統會在載入網頁時開始收集與分享播放資料。

2020 年 10 月 8 日

這項更新會涵蓋與 channel 資源相關的三個小變更:

  • 如果是新建頻道,可識別頻道縮圖圖片的 snippet.thumbnails 物件可以空白,但最多可能需要一天才能填入內容。
  • statistics.videoCount 屬性只能反映頻道公開影片的數量,即使是擁有者也一樣。這項行為與 YouTube 網站上顯示的人數一致。
  • brandingSettings.channel.keywords 屬性中識別的頻道關鍵字如果超過 500 個字元的長度上限,或是含有未逸出的引號 ("),可能會遭到截斷。請注意,500 的字元限制並非每個關鍵字的上限,而是所有關鍵字的總長度限制。這種行為與 YouTube 網站上的行為一致。

2020 年 9 月 9 日

注意:這是淘汰公告。

本次更新涵蓋下列 API 變更。所有變更將於本公告的發布日期自 2020 年 9 月 9 日當天或之後生效。因此,開發人員不應再依賴下列任何 API 功能。

  • 下列 API 資源、方法、參數和資源屬性立即淘汰,自本公告發布當天或之後將停止運作:
    • 下列 channel 資源屬性:
      • statistics.commentCount 屬性
      • brandingSettings.image 物件及其所有子項屬性
      • brandingSettings.hints 清單及其所有子項屬性
    • channels.list 方法的 categoryId 篩選器參數
    • guideCategories 資源和 guideCategories.list 方法
  • 如果 API 要求將 managedByMe 參數設為 truechannels.list 方法的 API 回應就不會再包含 prevPageToken 屬性。這項變更不會影響其他 channels.list 要求的 prevPageToken 屬性,也不會影響任何要求的 nextPageToken 屬性。
  • channel 資源的 contentDetails.relatedPlaylists.watchLatercontentDetails.relatedPlaylists.watchHistory 屬性已於 2016 年 8 月 11 日宣布淘汰。playlistItems.insert 方法和 playlistItems.delete 方法對這些播放清單的支援功能現已完全淘汰,這兩項屬性已從說明文件中移除。
  • channels.list 方法的 mySubscribers 參數已於 2013 年 7 月 30 日宣布淘汰,因此已從說明文件中移除。使用 subscriptions.list 方法及其 mySubscribers 參數,擷取已驗證使用者頻道的訂閱者清單。
  • channel 資源的 invideoPromotion 物件及其所有子項屬性 (已於 2017 年 11 月 27 日宣布淘汰) 從說明文件中移除。

2020 年 7 月 29 日

我們移除了與 part 參數相關聯的額外費用,以簡化 API 要求的計費程序。從現在起,我們只會針對呼叫的方法收取基本費用。如要進一步瞭解簡化的配額,請按這裡

這項變更的效果為大多數 API 呼叫的配額費用都略低,但有些 API 呼叫的費用仍會相同。這項異動不會增加任何 API 呼叫的費用。整體來說,在 Google Cloud 控制台中查看分配的配額,可能會有進一步的影響。

強烈建議所有開發人員完成專案法規遵循稽核,確保能繼續存取 YouTube API 服務。

這個修訂版本歷史記錄的發布時間是 2020 年 7 月 20 日。

2020 年 7 月 28 日

凡是在 2020 年 7 月 28 日之後建立的未經驗證 API 專案,透過 videos.insert 端點上傳的影片將限制為私人觀看模式。如要解除這項限制,每項專案都必須接受稽核,以確認符合《服務條款》。

創作者如果透過未經驗證的 API 用戶端上傳影片,系統將會傳送電子郵件給創作者,說明影片已鎖定為私人影片,此時他們可以透過官方或稽核的用戶端避免受到限制。

在 2020 年 7 月 28 日前建立的 API 專案目前不會受到這項異動影響。不過,我們強烈建議所有開發人員完成專案法規遵循稽核,確保你能繼續使用 YouTube API 服務。

2020 年 7 月 21 日

[更新日期:2020 年 7 月 28 日]這個修訂版本記錄項目中參照的說明文件更新已於 2020 年 7 月 28 日重新發布。

我們昨天發布了關於收費配額程序的說明文件更新。 但由於發生無法預期的狀況,配額變更尚未生效。因此,為求正確,說明文件已撤銷。為了避免混淆,我們已移除說明這項變更的修訂記錄項目,近期內就會重新發布。

2020 年 7 月 7 日

注意:這是淘汰公告。

videos.insert 方法的 autoLevelsstabilize 參數現已淘汰,這兩項參數已從說明文件中移除。系統會忽略這些數值,不會影響新上傳影片的處理方式。

2020 年 6 月 15 日

新版《遵守 YouTube 開發人員政策》指南提供指南和範例,可協助您確保您的 API 用戶端符合 YouTube API 服務條款政策 (API 服務條款) 的特定部分。

這份指南旨在說明 YouTube 如何落實 API TOS 的特定部分,但不會取代任何現有文件。本指南迴答開發人員在 API 法規遵循稽核期間最常問的一些問題。希望這項功能可以幫助您瞭解 Google 如何解讀及執行政策,進而簡化功能開發程序。

2020 年 6 月 4 日

注意:這是先前淘汰的公告。

「頻道公告」功能現已全面停用。這項異動首次於 2020 年 4 月 17 日宣布,現已生效。因此,不再支援 activities.insert 方法,activities.list 方法也不會再傳回頻道公告。詳情請前往 YouTube 說明中心

2020 年 4 月 17 日

注意:這是淘汰公告。

YouTube 即將淘汰頻道公告功能。因此,activities.insert 方法將會遭到淘汰,activities.list 方法則會停止傳回頻道公告。這些異動將於 2020 年 5 月 18 日當天或之後在 API 中生效。詳情請前往 YouTube 說明中心

2020 年 3 月 31 日

這次更新的修改如下:

  • 全新資源和方法

    • 新的 member 資源代表 YouTube 頻道的頻道會員。會員只要定期為創作者提供金錢支援,即可享有特殊福利。舉例來說,創作者啟用會員專屬模式後,會員就能聊天。

      這項資源取代了在 YouTube Live Streaming API 中註明的 sponsor 資源。sponsor 資源現已淘汰,API 用戶端應更新對 sponsors.list 方法的呼叫,以便改用 members.list 方法。

    • 新的 membershipsLevel 資源指明瞭授權 API 要求建立者管理的定價級別。membershipsLevels.list 方法會擷取建立者的所有會員等級清單。

2020 年 1 月 10 日

這個 API 現已支援識別兒童導向內容的功能,也就是 YouTube 稱為「兒童專屬」。如要進一步瞭解「兒童專屬」內容,請前往 YouTube 說明中心。

channelvideo 資源支援兩項新資源,方便內容創作者和觀眾找出兒童專屬內容:

  • selfDeclaredMadeForKids 屬性可讓內容創作者指定頻道影片是否為兒童專屬。

    如果是管道,您可以在呼叫 channels.update 方法時設定這個屬性。如果是影片,您可以在呼叫 videos.insertvideos.update 方法時設定這個屬性。

    請注意,只有在頻道擁有者授權 API 要求時,含有 channelvideo 資源的 API 回應才會包含這個屬性。
  • madeForKids 屬性可讓任何使用者擷取頻道影片的「兒童專屬」狀態。舉例來說,系統可能會根據 selfDeclaredMadeForKids 屬性的值決定狀態。如要進一步瞭解如何為頻道、影片或廣播設定目標觀眾,請參閱 YouTube 說明中心

我們也更新了 YouTube API 的《服務條款》和《開發人員政策》。詳情請參閱《YouTube API 服務條款 - 修訂版本記錄》。《YouTube API 服務條款》和《開發人員政策》異動將於太平洋時間 2020 年 1 月 10 日生效。

2019 年 9 月 10 日

API 參考說明文件已更新,以反映 YouTube 系統記錄訂閱人數的方式,進而以 API 回應的形式更新。由於這項變更,YouTube Data API 服務傳回的訂閱人數將四捨五入至訂閱人數超過 1,000 的三位數。這項變更會影響 channel 資源的 statistics.subscriberCount 屬性。

注意:即便使用者已針對自己頻道的資料提出授權要求,這項變更也會影響此屬性值。頻道擁有者仍可在 YouTube 工作室中查看確切的訂閱人數。

舉例來說,如果頻道有 123,456 名訂閱者,statistics.subscriberCount 屬性將包含 123000 值。下表範例顯示訂閱人數在 API 回應中會四捨五入,並以縮寫的形式顯示在其他公開的 YouTube 使用者介面中:

訂閱人數範例 YouTube Data API 公開顯示的 YouTube UI
1,234 人 1230 1230
12,345 人 12300 1.23 萬
123,456 人 123000 12.3 萬
1,234,567 人 1230000 123 萬
12,345,678 人 12300000 1230 萬
123,456,789 123000000 1.23 億

2019 年 4 月 4 日

這次更新的修改如下:

  • API 參考說明文件已更新,以更詳細地解釋各種方法的常見用途,並透過 APIs Explorer 小工具提供高品質的動態程式碼範例。如需範例,請參閱 channels.list 方法的說明文件。在描述 API 方法的頁面現在有兩個新元素:

    • API Explorer 小工具可讓您選取授權範圍、輸入範例參數和屬性值,然後傳送實際的 API 要求並查看實際的 API 回應。小工具也會提供全螢幕檢視,顯示完整的程式碼範例,讓這些範例動態更新為使用您輸入的範圍和值。

    • 常見用途」一節會說明本頁所述方法的一或多個常見用途。舉例來說,您可以呼叫 channels.list 方法擷取特定頻道的資料,或擷取目前使用者頻道的資料。

      您可以使用該區段中的連結,根據您的用途為 API Explorer 填入範例值,或開啟已填入這些值的全螢幕 API Explorer。這些變更的目的是方便您查看直接適用於您嘗試在自家應用程式中實作的用途的程式碼範例。

    程式碼範例目前支援 Java、JavaScript、PHP、Python 和 curl

  • 程式碼範例工具也已更新為新版 UI,提供上述所有功能。該工具可讓您探索不同方法的用途、將值載入 APIs Explorer,以及開啟全螢幕 APIs Explorer,取得 Java、JavaScript、PHP 和 Python 的程式碼範例。

    與這項變更同時,我們移除了先前列出的 Java、JavaScript、PHP 和 Python 程式碼範例網頁,

  • 更新了 JavaJavaScriptPHPPython 的快速入門指南。修訂的指南說明如何使用 APIs Explorer 的程式碼範例,執行包含 API 金鑰的範例,以及使用 OAuth 2.0 用戶端 ID 執行另一個範例。

請注意,上述變更取代了在 2017 年加入 API 說明文件中的互動式工具。

2018 年 7 月 9 日

這次更新的修改如下:

  • channel 資源的 snippet.thumbnails 屬性定義已更新,請注意,在應用程式中顯示縮圖時,程式碼使用的圖片網址應與 API 回應中傳回的圖片網址完全相同。舉例來說,您的應用程式不應使用 http 網域,而不是 API 回應中傳回的網址中的 https 網域。

    2018 年 7 月起,頻道縮圖網址將只能在 https 網域中使用,這也是網址在 API 回應中顯示的方式。在那之後,如果應用程式嘗試從 http 網域載入 YouTube 圖片,應用程式可能會顯示毀損的圖片。

  • 注意:這是淘汰公告。

    video 資源的 recordingDetails.location.altitude 屬性已淘汰。我們無法保證影片會傳回這個屬性的值。同樣地,即使 API 要求嘗試為該屬性設定值,傳入的資料也可能不會儲存。

2018 年 6 月 22 日

我們更新了導入指南 (舊稱「導入與遷移指南」),移除從 v2 API 遷移至 v3 API 的操作說明。此外,我們也針對第 3 版 API 中已淘汰的功能 (例如喜愛的影片),移除相關操作說明。

2017 年 11 月 27 日

這次更新的修改如下:

  • 注意:這是淘汰公告。

    YouTube 將不再支援「精選影片」和「精選網站」功能,因為這些功能是透過 channel 資源的 invideoPromotion 物件在 API 中支援。因此,該物件 (包括其所有子項屬性) 即將淘汰。

    在 2017 年 12 月 14 日前,你仍可擷取及設定 invideoPromotion 資料。付款週期結束後:

    • 嘗試在呼叫 channels.list 時擷取 invideoPromotion 部分,會傳回空白的 invideoPromotion,或完全不會傳回任何 invideoPromotion 資料。
    • 如果嘗試在呼叫 channels.update 時更新 invideoPromotion 資料,至少會傳回 2018 年 5 月 27 日的成功回應,但系統會將其視為免人工管理,也就是說他們實際上不會執行更新。

    2018 年 5 月 27 日後,這些要求可能傳回錯誤訊息,表示 invalidPromotion 是無效的部分。

2017 年 11 月 16 日

這次更新的修改如下:

  • 互動式程式碼片段工具現在支援 Node.js 程式碼範例。這些範例也會出現在幾乎所有 API 方法 (例如 channels.list 方法) 的說明文件中。

    這些可自訂的範例旨在為您提供特定用途的 Node.js 應用程式起點。這項功能與 Node.js 快速入門指南中的程式碼類似。不過,範例包含快速入門導覽課程中未列出的部分公用程式函式:

    • removeEmptyParameters 函式會採用與 API 要求參數對應的鍵/值組合清單,並移除沒有值的參數。
    • createResource 函式會取得與 API 資源中屬性對應的鍵/值組合清單。接著會將屬性轉換為 JSON 物件,該物件可用於 insertupdate 作業。下例顯示一組屬性名稱和值,以及程式碼會為其建立的 JSON 物件:
      # Key-value pairs:
      {'id': 'ABC123',
       'snippet.title': 'Resource title',
       'snippet.description': 'Resource description',
       'status.privacyStatus': 'private'}
      
      # JSON object:
      {
       'id': 'ABC123',
       'snippet': {
         'title': 'Resource title',
         'description': 'Resource description',
       },
       'status': {
         'privacyStatus': 'private'
       }
      }

    這些範例都是專為在本機下載和執行。詳情請參閱程式碼片段工具操作說明中在本機執行完整程式碼範例的必要條件。

2017 年 10 月 25 日

這次更新的修改如下:

  • 互動式程式碼片段工具中的 Python 程式碼範例已更新為使用 google-authgoogle-auth-oauthlib 程式庫,而不是現已淘汰的 oauth2client 程式庫。

    此外,這項工具現在還提供適用於已安裝 Python 應用程式和 Python 網路伺服器應用程式的完整程式碼範例,這些範例的授權流程稍有不同。如要查看完整範例 (以及這項變更):

    1. 前往互動式程式碼片段工具或任何 API 方法 (例如 channels.list 方法) 的說明文件。
    2. 按一下程式碼範例上方的 Python 分頁標籤。
    3. 點選分頁標籤上方的切換鈕,即可從程式碼片段查看完整範例。
    4. 分頁現在會顯示使用 InstalledAppFlow 授權流程的完整程式碼範例。上述範例說明中有提供說明,同時也提供網路伺服器應用程式範例的連結。
    5. 按一下連結即可切換至網路伺服器範例。這個範例使用 Flask 網頁應用程式架構和不同的授權流程。

    這些範例都是專為在本機下載和執行。如要執行範例,請參閱程式碼片段工具操作說明中,在本機執行完整程式碼範例的操作說明。

2017 年 8 月 29 日

這次更新的修改如下:

  • search.list 方法的 forContentOwner 參數定義已更新,請注意,如果參數設為 true,則 type 參數必須設為 video
  • search.list 方法的 regionCode 參數定義已更新,以闡明此參數會將搜尋結果限制在可於指定區域觀看的影片。
  • YouTube 已更新品牌標誌和圖示。您可以前往品牌宣傳指南頁面,下載新的「使用 YouTube 開發」標誌。其他新的 YouTube 標誌和圖示也會顯示在該頁面上,也可從 YouTube 品牌網站下載。

2017 年 7 月 24 日

這次更新的修改如下:

  • iOS 版本已推出新的 YouTube Data API 快速入門指南。本指南將說明如何透過以 Objective-C 或 Swift 撰寫的簡易 iOS 應用程式,使用 YouTube Data API。
  • YouTube Data API 的互動式程式碼片段工具現在提供說明文件,說明此工具的部分功能:
    • 執行 API 要求
    • 切換程式碼片段與完整程式碼範例
    • 使用樣板函式
    • 正在載入現有資源 (適用於更新方法)

    注意:這項工具也會嵌入 API 方法的 API 參考說明文件 (範例)。

2017 年 6 月 1 日

這次更新的修改如下:

2017 年 5 月 17 日

這次更新的修改如下:

  • API 參考說明文件已更新,提供程式碼片段更廣泛、互動性更高的服務。說明 API 方法 (例如 channels.listvideos.rate) 的網頁現在提供互動式工具,讓您查看及自訂 Java、JavaScript、PHP、Python、Ruby、Apps Script 和 Go 的程式碼片段。

    無論使用哪一種指定方法,工具都會顯示一或多個用途的程式碼片段,而每個用途都說明瞭呼叫該方法的一種常見方式。舉例來說,您可以呼叫 channels.list 方法,擷取特定頻道或目前使用者頻道的相關資料。

    您也可以與程式碼範例互動:

    • 修改參數和屬性值,程式碼片段就會動態更新,反映您提供的值。

    • 可切換程式碼片段和完整範例。程式碼片段顯示呼叫 API 方法的程式碼片段。完整樣本包含該程式碼片段,以及授權和傳送要求的樣板程式碼。您可以從指令列或本機網路伺服器複製及執行完整範例。

    • 按一下按鈕即可執行要求。(如要執行要求,您必須授權工具代您呼叫 API)。

    請注意,這項工具已取代頁面上的 APIs Explorer。(每個網頁均會顯示連結,方便您選擇在 API 檢視工具中載入您正在處理的要求)。

  • Data API 程式碼片段工具也已更新,加入了新的使用者介面,以提供上述所有功能。本頁面提供的主要新功能如下:

    • 支援寫入資料的 API 要求。
    • 支援 Java 範例。
    • 更靈活且全面的樣板程式碼,用於授權使用者及建立 API 要求。

2017 年 4 月 27 日

這次更新的修改如下:

2017 年 3 月 30 日

這次更新的修改如下:

  • channel 資源的新 topicDetails.topicCategories[] 屬性,內含描述頻道內容的 Wikipedia 網址清單。網址會對應至資源 topicDetails.topicIds[] 屬性中傳回的主題 ID。
  • playlistItem 資源的新 contentDetails.videoPublishedAt 屬性可識別影片發布至 YouTube 的時間。資源已包含 snippet.publishedAt 屬性,該屬性會指出項目加入播放清單的時間。
  • channel 資源一樣,video 資源現在會傳回 topicDetails.topicCategories[] 屬性,其中包含說明影片內容的 Wikipedia 網址清單。以 video 資源來說,網址會對應至資源 topicDetails.relevantTopicIds[] 屬性中傳回的主題 ID。
  • video 資源的新 contentDetails.contentRating.mpaatRating 屬性可識別美國電影協會對電影預告片或預覽的評分。

2017 年 2 月 27 日

2016 年 8 月 11 日的公告所述,YouTube 已將支援的主題 ID 清單變更為收錄清單。channelvideo 資源的 topicDetails 屬性,以及 search.list 方法的 topicId 參數中,都會完整納入支援主題 ID 的清單。

請注意,已收錄的清單有以下異動:

  • 下列主題已新增為 Society 的子主題:
    名稱主題 ID
    商家/m/09s1f
    健康狀態/m/0kt51
    軍事/m/01h6rj
    政治/m/05qt0
    宗教/m/06bvp
  • 已移除 Animated cartoon 主題,之前是 Entertainment 的子項。
  • 已移除 Children's music 主題,之前是 Music 的子項。

由於這項變更,系統現在一律會在 video 資源的 topicDetails.relevantTopicIds[] 屬性值中傳回與影片相關的主題。

2016 年 11 月 29 日

這次更新的修改如下:

  • 自 2017 年 2 月 10 日起,我們已開始支援主題 ID 清單,但新增了三項小幅變更:

    • Professional wrestling 類別原先是 Sports 類別的子項,現在則是 Entertainment 的子項。
    • TV shows 類別是 Entertainment 的子項。
    • 已移除 Health 類別,之前是 Lifestyle 的子項。

    另請注意,有數個父項類別 (EntertainmentGamingLifestyleMusicSports)。任何與子項類別相關聯的影片 (例如 Tennis) 也會與上層類別 (Sports) 建立關聯。

2016 年 11 月 10 日

這次更新的修改如下:

  • 正如在 2016 年 8 月 11 日首次宣布,Freebase 和 Freebase API 的淘汰事宜將配合主題 ID 進行多項變更。主題 ID 可識別與 channelvideo 資源相關聯的主題。您也可以使用 topicId 搜尋參數尋找與特定主題相關的頻道或影片。

    自 2017 年 2 月 10 日起,YouTube 將開始傳回一小部分的主題 ID,而不是目前為止傳回的更為精細的主題 ID。另請注意,YouTube 不保證頻道和影片能夠與任何主題建立關聯。這個主題與目前的 API 行為一致。

    為協助您針對相關變更做好 API 用戶端的準備,我們已更新下列 API 參數和屬性的定義,列出之後將支援的主題 ID。請注意,所有屬性的類別清單都相同。

  • 注意:這是淘汰公告。

    以下屬性即將淘汰:

    • channel 資源的 topicDetails.topicIds[] 屬性。此屬性將持續到 2017 年 11 月 10 日為止。
    • video 資源的 topicDetails.relevantTopicIds[] 屬性。此屬性將持續到 2017 年 11 月 10 日為止。
    • video 資源的 topicDetails.topicIds[] 屬性。這個屬性不包含 2017 年 2 月 10 日之後的值。(在上述日期過後,topicDetails.relevantTopicIds[] 屬性值會指出與影片相關的所有主題)。

  • 由於 Freebase 已淘汰,使用 Freebase Topics 搜尋指南已從說明文件中移除。該指南提供了程式碼範例,說明應用程式如何使用 Freebase API。

    此外,從 search.list 方法的說明文件中移除了幾個與主題 ID 相關的程式碼範例。

2016 年 11 月 2 日

這次更新的修改如下:

  • 新屬性和參數

    • video 資源包含數個新屬性:

      • player.embedHtml 屬性包含 <iframe> 標記,可用來嵌入播放影片的播放器。新的 player.embedHeightplayer.embedWidth 屬性會識別嵌入播放器的尺寸。只有在 API 要求至少為一個 maxHeightmaxWidth 參數指定一個值時,系統才會傳回這些屬性。我們稍後會在此修訂版本記錄項目中說明這兩個新參數。

      • 新的 hasCustomThumbnail 屬性會指出影片上傳者是否已提供影片的自訂縮圖。請注意,只有影片上傳者才能檢視這項屬性。

      • 新的 fpbRatingReasons[] 會指出影片獲得 FPB (南非) 分級的原因。

      • 新的 mcstRating 代表影片在越南獲得的分級。

    • videos.list 方法支援 maxHeightmaxWidth 這兩個新參數。您可以在擷取 video 資源中的 player 部分時,使用任一參數或兩個參數。

      根據預設,player.embedHtml 屬性中傳回的 <iframe> 高度為 360 像素。系統會根據影片的顯示比例調整寬度,確保嵌入式播放器不會有遮蔽影片的畫面。所以,假設影片的顯示比例為 16:9,播放器寬度會是 640 像素。

      透過新參數,您可以指定嵌入程式碼而非預設尺寸,嵌入程式碼應使用適用於應用程式版面配置的高度和/或寬度。API 伺服器會視情況調整播放器尺寸,確保嵌入式播放器不會有黑色長條框住影片。請注意,這兩個參數都會指定嵌入播放器的最大尺寸。因此,如果同時指定兩個參數,一個維度可能還是會小於該維度允許的數量上限。

      舉例來說,假設影片的長寬比為 16:9。因此,如果未設定 maxHeightmaxWidth 參數,player.embedHtml 標記就會包含 640x360 的播放器。

      • 如果 maxHeight 參數設為 720,且未設定 maxWidth 參數,API 會傳回 1280x720 的播放器。
      • 如果 maxWidth 參數設為 960,且未設定 maxHeight 參數,API 會傳回 960x540 的播放器。
      • 如果 maxWidth 參數設為 960,且 maxHeight 參數設為 450,API 會傳回 800x450 的播放器。

      新的 player.embedHeightplayer.embedWidth 屬性 (如上所述) 可用來識別玩家尺寸。

  • 更新現有方法、屬性及參數

    • channelSection 資源說明已更新,請注意,單一頻道最多可建立 10 個影片櫃,但未設定指定目標資料,且可使用指定目標資料建立最多 100 個專區。

      此外,channelSection 資源的 targeting 屬性也已更新,以反映只能透過 API 設定指定目標選項的情況。如果利用 YouTube 網站的使用者介面修改頻道版面,指定選項就會刪除。

    • i18nLanguage 資源的 snippet.name 屬性定義已修正,以反映該值代表以 i18nLanguage.list 方法 hl 參數指定的語言編寫的語言名稱。

    • playlistItem 資源的 contentDetails.note 屬性已更新,請注意,屬性值的長度上限為 280 個字元。

    • playlistItem 資源的 contentDetails.startAtcontentDetails.endAt 屬性已淘汰。如果在 playlistItems.insertplaylistItems.update 要求中設定這些欄位,系統就會忽略這些欄位。

    • playlistItems.deleteplaylistItems.update 方法現在支援 onBehalfOfContentOwner 參數,某些方法已支援該參數。使用該方法的要求也必須取得提供 https://www.googleapis.com/auth/youtubepartner 範圍存取權的權杖進行授權。

    • search.list 方法的 publishedBeforepublishedAfter 參數皆已更新,以表示參數值包含。例如,如果設定 publishedBefore 參數,API 會傳回指定時間之前「或」建立的資源。

    • video 資源的 contentDetails.contentRating.grfilmRating 屬性支援三個額外的值:grfilmK12grfilmK15grfilmK18

    • 更新了 videos.insert 方法說明,以指出上傳影片的檔案大小上限已從 64GB 增加到 128GB。

  • 最新錯誤和更新後的錯誤

    • 這個 API 支援下列新的錯誤:

      錯誤類型 錯誤詳細資料 說明
      forbidden (403) homeParameterDeprecated activities.list 方法會傳回這個錯誤,表示無法透過這個 API 取得使用者的首頁活動資料。如果您在未經授權的要求中將 home 參數設為 true,就可能會發生這個錯誤。
      invalidValue (400) invalidContentDetails playlistItems.insert 方法會傳回這個錯誤,表示要求中的 contentDetails 物件無效。發生這個錯誤的其中一個原因是 contentDetails.note 欄位長度超過 280 個字元。
      forbidden (403) watchHistoryNotAccessible playlistItems.list 方法傳回這個錯誤,表示要求嘗試擷取「觀看記錄」播放清單項目,但無法使用 API 擷取這些項目。
      forbidden (403) watchLaterNotAccessible playlistItems.list 方法傳回這個錯誤,表示要求嘗試擷取「稍後觀看」播放清單項目,但無法使用 API 擷取這些項目。
      badRequest (400) uploadLimitExceeded videos.insert 方法會傳回這個錯誤,表示頻道已超過可上傳的影片數量。
      forbidden (403) forbiddenEmbedSetting videos.update 方法會傳回這個錯誤,表示 API 要求嘗試為影片設定無效嵌入設定。請注意,部分頻道可能沒有權限為直播提供嵌入式播放器。如需更多資訊,請造訪 YouTube 說明中心
    • 如果在播放清單中插入重複的影片,playlistItems.insert 方法不會再傳回錯誤。先前發生這個錯誤,是因為某些播放清單 (例如最愛的影片) 無法播放重複內容,但系統不再支援此錯誤。一般而言,播放清單允許重複的影片。

  • 其他更新

    • 2016 年 9 月 15 日的修訂版本歷史記錄項目已更新,以清楚說明,每當回應中納入 channel 資源的 contentDetails.relatedPlaylists.watchHistorycontentDetails.relatedPlaylists.watchLater 屬性時,就會分別包含 HLWL 的值。此外,只有在獲得授權的使用者擷取使用者頻道相關資料時,系統才會納入這些屬性。

2016 年 9 月 15 日

這次更新的修改如下:

  • 2016 年 8 月 11 日的修訂版本記錄更新討論了與主題 ID 相關的多項異動,包括支援主題 ID 組合在 2017 年 2 月 10 日將有變動。我們將於 2016 年 11 月 10 日發布支援主題清單。

  • 下列變更現已生效。通知對像在 2016 年 8 月 11 日的修訂版本記錄更新中:

    • 如果在將 home 參數設為 true 的情況下呼叫 activities.list 方法,API 回應現在會包含與未登入 YouTube 使用者在首頁上看到的內容類似。

      我們之所以做出這項微幅變更,是為了提供比 2016 年 8 月 11 日修訂版本記錄更新中描述的行為更好的使用者體驗。這項更新表示使用 home 參數的要求會傳回空白清單。

    • channel 資源的 contentDetails.relatedPlaylists.watchHistorycontentDetails.relatedPlaylists.watchLater 屬性現在為所有管道分別包含 HLWL 的值。

      明確來說,只有獲得授權的使用者擷取使用者頻道相關資料後,才能看見這些屬性。屬性一律包含 HLWL 值,即使是已獲授權的使用者擷取使用者自有頻道相關資料也一樣。因此,您無法透過 API 擷取觀看記錄和稍後觀看播放清單 ID。

      此外,如果要求擷取頻道觀看記錄或稍後觀看播放清單的播放清單詳細資料 (playlists.list) 或播放清單項目 (playlistItems.list),系統現在會傳回空白清單。這個行為適用於新的值 HLWL,以及 API 用戶端先前儲存的任何觀看記錄或稍後觀看播放清單 ID。

  • 系統不再傳回 video 資源的 fileDetails.recordingLocation 物件及其子項屬性。過去,只有影片擁有者才能擷取這類資料 (例如父項 fileDetails 物件)。

2016 年 8 月 11 日

這次更新的修改如下:

  • YouTube 工程與開發人員網誌近期發布的新版《YouTube API 服務條款》(以下簡稱「新版條款」),內容將針對目前的《服務條款》內容提供一系列更新內容。除了將於 2017 年 2 月 10 日生效的《新版條款》外,本次更新還包含幾項佐證文件,可說明開發人員必須遵守的政策。

    如需完整的新文件清單,請參閱新版條款的修訂版本記錄。此外,「新版條款」或相關佐證文件如有變更,我們也會在修訂記錄中註明。您可以透過文件中的連結,訂閱 RSS 動態消息清單,列出該修訂版本記錄的變更。

  • 淘汰 Freebase 和 Freebase API,將導致主題 ID 的多項異動發生。主題 ID 用於下列 API 資源和方法:

    • channel 資源的 topicDetails 部分可識別與頻道相關的主題。
    • video 資源的 topicDetails 部分可識別與影片相關的主題。
    • search.list 方法的 topicId 參數可讓您搜尋與特定主題相關的影片或頻道。

    這些功能的變更如下:

    • 自 2017 年 2 月 10 日起,YouTube 將開始傳回一小部分的主題 ID,而非目前為止傳回的更為精細的主題 ID。支援的主題集可識別「運動」或「籃球」等高階分類,但無法識別特定隊伍或球員。我們將公布支援的主題組合,讓您有時間針對這項異動做好準備。

    • 直到 2017 年 2 月 10 日以前,您已擷取的任何 Freebase 主題 ID 都可以用來搜尋內容。但在那之後,只能使用前一個項目中識別出的較小主題,依主題擷取搜尋結果。

    • 2017 年 2 月 10 日後,如果您嘗試使用不在較小的支援主題 ID 集中的主題 ID 搜尋結果,API 會傳回空白的結果集。

  • 部分 API 欄位和參數將於 2016 年 9 月 12 日淘汰:

    • activities.list 方法的 home 參數可讓已獲授權的使用者擷取顯示在 YouTube 首頁上的活動動態消息。在 2016 年 9 月 12 日後使用這個參數的要求會傳回空白清單。

    • 只有獲得授權的使用者擷取使用者自有頻道相關資料後,才能查看 channel 資源的 contentDetails.relatedPlaylists.watchHistorycontentDetails.relatedPlaylists.watchLater 屬性。2016 年 9 月 12 日之後,contentDetails.relatedPlaylists.watchHistory 會傳回 HL 值,contentDetails.relatedPlaylists.watchLater 屬性則會針對所有管道傳回 WL 值。

      如果要求擷取頻道觀看記錄或稍後觀看播放清單的播放清單詳細資料 (playlists.list),系統將在 2016 年 9 月 12 日後傳回空白清單。在上述任一播放清單擷取播放清單項目 (playlistItems.list) 的要求,也會在這段時間之後傳回空白清單。新的值 (HLWL),以及 API 用戶端已儲存的觀看記錄或稍後觀看播放清單 ID 都是如此。

    • 2016 年 9 月 12 日後,系統不會再傳回 video 資源的 fileDetails.recordingLocation 物件或其任何子項屬性。只有影片擁有者才能擷取父項 fileDetails 物件,因此只有影片擁有者能擷取這項資料。

2016 年 6 月 13 日

這次更新的修改如下:

  • channel 資源的 contentDetails.googlePlusUserId 屬性已淘汰。先前只有在頻道與 Google+ 個人資料建立關聯時,資源才會顯示。淘汰後,所有 channel 資源將不再包含該屬性。

  • comment 資源的 snippet.authorGoogleplusProfileUrl 屬性已淘汰。先前只有在頻道與 Google+ 個人資料建立關聯時,資源才會顯示。淘汰後,所有 comment 資源將不再包含該屬性。

由於淘汰後不會傳回這兩種屬性,因此這兩項屬性已從對應的資源說明文件中移除。

2016 年 5 月 31 日

這次更新的修改如下:

  • subscriptions.list 方法的新 myRecentSubscribers 參數會以反向時間順序,擷取已驗證使用者的頻道訂閱者清單。

    請注意,新參數只能擷取已驗證使用者頻道的最新 1,000 位訂閱者。如要擷取完整的訂閱者清單,請使用 mySubscribers 參數。這個參數不會按照特定順序傳回訂閱者,不會限制可擷取的訂閱人數。

  • 我們更新了活動playlistItem播放清單搜尋結果縮圖影片資源的 snippet.thumbnails.(key) 屬性定義,請注意部分影片可以使用額外的縮圖圖片大小。

    • standard 圖片的寬度為 640 像素,高度為 480 像素。
    • maxres 圖片的寬度為 1280 像素,高度為 720 像素。
  • channelSection.list 方法的 part 參數定義已更新,請注意,您可以擷取 targeting 部分的費用為 2 配額單位。

  • 如果未經授權的要求嘗試擷取 video 資源的 fileDetailsprocessingDetailssuggestions 部分,videos.list 方法現在會傳回禁止 (403) 錯誤。只有影片擁有者才能使用這些部分。

2016 年 5 月 17 日

全新的 Data API 程式碼片段工具提供 YouTube Data API 常見用途的簡短程式碼片段。目前程式碼片段適用於 Apps Script、Go、JavaScript、PHP、Python 和 Ruby 中的所有唯讀 API 方法。

這項工具會針對每個方法,顯示一或多個用途的程式碼範例。例如,它提供五個 search.list 方法的程式碼片段:

  • 依關鍵字列出影片
  • 依地區列出影片
  • 列出現場活動
  • 搜尋已驗證使用者的影片
  • 列出相關影片

這項工具針對每個用途,顯示 API 要求中使用的參數。您可以修改參數值,在此情況下,工具會更新程式碼片段,反映您提供的參數值。

最後,這項工具會顯示每個要求的 API 回應。如果您修改了要求參數,API 回應將以您提供的參數值為準。請注意,您必須授權工具代您提交要求,系統才會顯示 API 回應。

2016 年 4 月 28 日

這次更新的修改如下:

  • video 資源的新 contentDetails.projection 屬性會指定影片的投影格式。有效屬性值為 360rectangular

  • video 資源的 recordingDetails.locationfileDetails.recordingLocation 屬性皆已更新,以說明這兩項屬性的差異:

    • recordingDetails.location 屬性可指明影片擁有者要與影片建立關聯的位置。此位置可編輯、在公開影片中搜尋,並可在公開影片時向使用者顯示。
    • fileDetails.recordingLocation 屬性值無法變更,且代表原始已上傳影片檔案相關聯的位置。只有影片擁有者看得到這個值。

  • channel 資源的 contentDetails.relatedPlaylists.favorites 屬性定義已更新,請注意,屬性值可能包含參照空白播放清單的播放清單 ID,因此無法擷取。因為我們先前已不再提供最愛的影片功能。請注意,這項屬性不適用 API 淘汰政策

  • 已更新 ineligibleAccount 錯誤的定義 (可由 comments.insertcomments.updatecommentThreads.insertcommentThreads.update 方法傳回),以反映用來授權 API 要求的 YouTube 帳戶未與使用者的 Google 帳戶合併時發生錯誤。

2016 年 4 月 20 日

這次更新的修改如下:

  • channels.update 方法的 part 參數定義已更新,請注意, localizations 也是該參數的有效值。

  • 入門指南的「配額用量」部分已更新,連結至 Google 開發人員控制台,方便您查看實際配額和配額使用量。

2016 年 3 月 16 日

這次更新的修改如下:

  • 更新現有資源和方法

    • channelBanner 資源說明文件已更新,請注意,上傳的頻道橫幅圖片建議大小為 2560 x 1440 像素。大小下限 (2048 x 1152 像素) 則維持不變。

    • channel 資源的新 snippet.customUrl 屬性會識別與頻道相關聯的自訂網址。(並非所有頻道都有自訂網址)。YouTube 說明中心說明瞭取得自訂網址的資格規定,以及網址的設定方式。

    • channel 資源的 brandingSettings.watch 物件及其所有子項屬性已淘汰。

    • search.list 要求的 API 回應現在包含 regionCode 屬性。這個屬性可識別搜尋查詢使用的區碼。區碼會指示 API 傳回指定國家/地區的搜尋結果。

      屬性值是兩個字母的 ISO 國家/地區代碼,用於識別區域。i18nRegions.list 方法會傳回支援區域的清單。預設值為 US。如果指定了不支援的地區,YouTube 仍可能選擇其他地區 (而非預設值) 來處理查詢。

    • videoAbuseReportReason 資源的 snippet.labelsnippet.secondaryReasons[].label 屬性定義已更新,請注意,由於濫用檢舉原因,屬性含有本地化標籤文字。

      此外,videoAbuseReportReasons.list 方法現在支援 hl 參數,會指定 API 回應中標籤文字應使用的語言。預設參數值是 en_US

    • video 資源新推出的 contentDetails.contentRating.ecbmctRating 屬性會指出土耳其文化與觀光部的土耳其評估及分類委員會 (Turkey’s Evaluation and Classification Board of the Turkey) 的影片評分。

      此外,其他評分系統的 API 屬性也支援下列新的屬性值:

      • contentDetails.contentRating.fpbRating (南非)
        評分:10;屬性值:fpb10
      • contentDetails.contentRating.moctwRating (臺灣)
        評分:R-12;屬性值:moctwR12
      • contentDetails.contentRating.moctwRating (臺灣)
        評分:R-15;屬性值:moctwR15
    • video 資源的 liveStreamingDetails.activeLiveChatId 屬性包含與影片相關聯的有效聊天室 ID。影片必須是目前已啟用聊天室的現場直播,才會顯示屬性值。直播結束且聊天室結束後,系統就不會再傳回影片的資產。

    • video 資源的 status.rejectionReason 屬性支援新屬性值 legal

  • 這個 API 支援下列新的錯誤:

    錯誤類型 錯誤詳細資料 說明
    badRequest (400) notEditable channelSections.insertchannelSections.updatechannelSections.delete 方法會傳回這個錯誤,表示無法建立、更新或刪除指定頻道版面。
    badRequest (400) styleRequired channelSections.insertchannelSections.update 方法會傳回這個錯誤,表示在 API 要求中提交的 channelSection 資源必須指定 snippet.style 屬性的值。
    badRequest (400) typeRequired channelSections.insertchannelSections.update 方法會傳回這個錯誤,表示在 API 要求中提交的 channelSection 資源必須指定 snippet.type 屬性的值。
    badRequest (400) processingFailure commentThreads.list 方法會傳回這個錯誤,表示 API 伺服器無法成功處理要求。雖然這可能是暫時性錯誤,但通常表示要求的輸入內容無效。檢查要求主體中的 commentThread 資源結構,確保資源有效。
    forbidden (403) commentsDisabled commentThreads.list 方法會傳回這個錯誤,表示 videoId 參數識別的影片已停用留言功能。
    badRequest (400) commentTextTooLong commentThreads.insert 方法會傳回這個錯誤,表示目前插入的 comment 資源在 snippet.topLevelComment.snippet.textOriginal 屬性中包含過多字元。
    invalidValue (400) videoAlreadyInAnotherSeriesPlaylist playlistItems.insert 方法會傳回這個錯誤,表示您要加入播放清單的影片已在其他系列播放清單中。如要進一步瞭解系列播放清單,請前往 YouTube 說明中心
    badRequest (400) subscriptionForbidden subscriptions.insert 方法會傳回這個錯誤,指出您的訂閱項目數量已達上限,或是您最近建立的訂閱項目過多。如果是後者,您可以等到幾小時後再重試要求。
    badRequest (400) invalidCategoryId videos.update 方法會傳回這個錯誤,表示已上傳 video 資源中的 snippet.categoryId 屬性指定的類別 ID 無效。使用 videoCategories.list 方法可擷取支援的類別。
    badRequest (400) invalidDescription videos.update 方法會傳回這個錯誤,表示上傳的 video 資源中的 snippet.description 屬性指定了無效值。
    badRequest (400) invalidPublishAt videos.update 方法會傳回這個錯誤,表示已上傳 video 資源中的 status.publishAt 屬性指定的排定發布時間無效。
    badRequest (400) invalidRecordingDetails videos.update 方法會傳回這個錯誤,表示上傳的 video 資源中的 recordingDetails 物件指定的無效錄製詳細資料。
    badRequest (400) invalidTags videos.update 方法會傳回這個錯誤,表示上傳的 video 資源中的 snippet.tags 屬性指定了無效值。
    badRequest (400) invalidTitle videos.update 方法會傳回這個錯誤,表示上傳的 video 資源中的 snippet.title 屬性指定了無效或空白的影片標題。
    badRequest (400) invalidVideoMetadata videos.update 方法會傳回這個錯誤,表示要求中繼資料無效。如果要求更新 video 資源的 snippet 部分,但並未同時設定 snippet.titlesnippet.categoryId 屬性的值,就會發生這個錯誤。

2015 年 12 月 18 日

根據歐盟 (EU) 法律規定,您必須向歐盟地區使用者揭露特定資訊,並取得他們的同意。因此,針對歐盟地區使用者,您必須遵守《歐盟地區使用者同意授權政策》。我們在《YouTube API 服務條款》中加入了這項規定的通知。

2015 年 11 月 19 日

這個 API 現支援為 playlistvideo 資源的 snippet.titlesnippet.description 屬性、channelSection 資源的 snippet.title 屬性,以及 channel 資源的 snippet.description 屬性設定及擷取本地化文字的功能。

  • 設定標題與說明的本地化

    您可以在呼叫該資源的 insertupdate 方法時,為資源設定本地化值。如要設定資源的本地化值,請執行下列兩項操作:

    • 確認已設定資源的 snippet.defaultLanguage 屬性值。該屬性可識別資源 snippet.titlesnippet.description 屬性的語言。這個值可以是任何支援的應用程式語言或其他多數的 ISO 639-1:2002 語言代碼。舉例來說,如果您上傳的影片含有英文標題和說明,可以將 snippet.defaultLanguage 屬性設為 en

      更新 channel 資源的注意事項:如要設定 channel 資源的 snippet.defaultLanguage 屬性,實際上需要更新 brandingSettings.channel.defaultLanguage 屬性。

    • localizations 物件新增至您要更新的資源。每個物件金鑰都是用來識別應用程式語言或 ISO 639-1:2002 語言代碼的字串,每個鍵會對應至包含資源的本地化標題 (和說明) 的物件。

      下方的程式碼片段範例將資源的預設語言設為英文。並新增德文和西班牙文版的影片標題和說明:

      {
        "kind": "youtube#video",
        ...
        "snippet": {
          "title": "Playing soccer",
          "description": "We play soccer in the park on Sundays.",
          "defaultLanguage": "en",
          ...
        },
        "localizations":
          "de": {
            "title": "Fußball spielen",
            "description": "Wir spielen Fußball im Park am Sonntag"
          },
          "es": {
            "title": "Jugar al fútbol",
            "description": "Nosotros jugamos fútbol en el parque los domingos",
          }
        }
      }
    • 重要事項:提醒您,更新資源的本地化資料時,API 要求必須包含所有現有的本地化版本資料。舉例來說,如果您在上述示例中傳送後續要求,對影片加入葡萄牙文資料,則這項要求也會需要納入德文、西班牙文和葡萄牙文的本地化資料。

  • 擷取本地化值

    這個 API 支援兩種擷取資源的本地化值的方法:

    • hl 參數加到 channels.listchannelSections.listplaylists.listvideos.list 要求中,即可擷取 YouTube 網站支援的特定應用程式語言的本地化資料。如果系統提供該語言版本的本地化資源詳細資料,則資源的 snippet.localized 物件會包含本地化值。不過,如果沒有可用的本地化詳細資料,snippet.localized 物件就會以資源預設語言中的資源詳細資料提供資源詳細資料。

      舉例來說,假設 videos.list 要求為上述影片擷取了德文和西班牙文本地化資料,如果將 hl 參數設為 de,資源會包含下列資料:

      {
        "kind": "youtube#video",
        ...
        "snippet": {
          "title": "Playing soccer",
          "description": "We play soccer in the park on Sundays.",
          "defaultLanguage": "en",
          "localized": {
            "title": "Fußball spielen",
            "description": "Wir spielen Fußball im Park am Sonntag"
          }
          ...
        }
      }

      不過,如果將 hl 參數設為 fr,則 snippet.localized 物件會包含英文標題和說明,因為英文是資源的預設語言,而且無法取得法文版的詳細資料。

      重要事項:hl 參數只支援用於識別 YouTube 網站支援的應用程式語言的值。如要判斷是否提供其他語言的本地化文字,您必須擷取資源的 localizations 部分,並使用篩選器判斷該段文字是否存在。

      例如,您必須擷取完整的本地化清單,才能判斷本地化文字是否提供阿帕拉契文。

    • 擷取資源時,請在 part 參數值中加入 localizations,以擷取該資源的所有本地化詳細資料。如果您擷取的本地化資料語言不是目前的 YouTube 應用程式語言,請使用這個方法擷取所有本地化版本,然後加以篩選,以判斷是否存在所需的本地化資料。

  • 本地化文字值相關錯誤

    這個 API 也支援下列本地化文字值的新錯誤:

    錯誤類型 錯誤詳細資料 說明
    badRequest (400) defaultLanguageNotSetError 此錯誤表示嘗試插入或更新某項資源的 localizations 物件的要求失敗,因為該資源未設定 snippet.defaultLanguage 屬性。channels.updatechannelSections.insertchannelSections.updateplaylists.insertplaylists.updatevideos.insertvideos.update 方法支援這個錯誤。
    badRequest (400) localizationValidationError 這個錯誤代表資源 localizations 物件的其中一個值無法驗證。舉例來說,如果物件包含無效的語言代碼,便可能發生這個錯誤。channels.updatechannelSections.insertchannelSections.updateplaylists.insertplaylists.update 方法支援這個錯誤。

2015 年 11 月 4 日

這次更新的修改如下:

  • 更新現有資源和方法

    • search.list 方法的 order 參數已更新,請注意,如果您依據 viewCount 排序現場直播,API 結果會在直播持續進行期間,按照播送的同時觀眾人數排序。

    • 更新 search.list 方法的 relatedToVideoId 參數,請注意,如果設定此參數,則其他支援的參數只有 partmaxResultspageTokenregionCoderelevanceLanguagesafeSearchtype (必須設為 video) 和 fields。這項更新不會反映 API 行為的變更。

    • video 資源的 snippet.publishedAt 屬性定義已更新,請注意,屬性值 (指定影片發布日期與時間) 可能與上傳影片的時間不同。舉例來說,如果將影片上傳為私人影片,稍後設為公開影片,屬性值會指定影片設為公開的時間。新版定義也會說明系統如何填入私人和不公開影片的值。

      這項變更不代表 API 行為改變。

    • video 資源的 status.publishAt 屬性定義已更新為注意:

      • 如果您在呼叫 videos.update 方法時設定此屬性值,您也必須將 status.privacyStatus 屬性值設為 private (即使影片已設定為私人)。
      • 如果對方排定影片的發布時間是過去的某個時間,系統會立即發布影片。因此,將 status.publishAt 屬性設為過去的日期和時間,等同於將影片的 privacyStatusprivate 變更為 public
    • video 資源的 contentDetails.contentRating.cncRating 屬性可指定影片在法國的 Commission de 分類電影院的評分。這個屬性會取代現已淘汰的 contentDetails.contentRating.fmocRating 屬性。

    • 已更新 channel 資源的 brandingSettings.channel.keywords 定義,以正確反映屬性值包含以空格分隔的字串清單,而非如前所述清單的逗號分隔清單。這項更新不代表 API 行為改變。

    • 我們更新了 thumbnails.set 方法的說明文件,以準確反映要求內文,包含您要上傳的縮圖圖片,並與影片建立關聯。要求主體不包含 thumbnail 資源。先前說明文件指出,呼叫這個方法時不應提供要求主體。這項更新不代表 API 行為改變。

    • 為反映 activities.list 方法目前不包含與新影片留言相關的資源,activity 資源的說明已更新。一併更新資源的 snippet.typecontentDetails.comment

  • 最新錯誤和更新後的錯誤

    • 這個 API 現在支援下列錯誤:

      錯誤詳細資料
      activities.insert
      HTTP 回應代碼badRequest (400)
      原因invalidMetadata
      說明kind 屬性與提供的 ID 類型不符。
      commentThreads.update
      comments.insert
      comments.update
      HTTP 回應代碼badRequest (400)
      原因commentTextTooLong
      說明目前插入或更新的 comment 資源的 snippet.topLevelComment.snippet.textOriginal 屬性含有過多字元。
      playlistItems.insert
      playlistItems.update
      HTTP 回應代碼forbidden (403)
      原因playlistItemsNotAccessible
      說明這項要求未獲適當授權,無法插入、更新或刪除指定的播放清單項目。
      playlists.delete
      playlists.insert
      playlists.update
      HTTP 回應代碼badRequest (400)
      原因playlistForbidden
      說明已拒絕這項作業,或是要求未獲適當授權。
      search.list
      HTTP 回應代碼badRequest (400)
      原因invalidLocation
      說明location 和/或 locationRadius 參數值的格式有誤。
      search.list
      HTTP 回應代碼badRequest (400)
      原因invalidRelevanceLanguage
      說明relevanceLanguage 參數值的格式有誤。
      subscriptions.insert
      HTTP 回應代碼badRequest (400)
      原因subscriptionForbidden
      說明下列任一項結果為 true 時就會發生這個錯誤:
      • 您嘗試建立的訂閱項目已經存在
      • 你的訂閱數量已達上限
      • 您正嘗試訂閱自己的頻道,但系統不支援該頻道。
      • 您最近建立太多訂閱項目,必須等待幾小時才能重試要求。
      videos.update
      HTTP 回應代碼badRequest (400)
      原因invalidDefaultBroadcastPrivacySetting
      說明這項要求嘗試為預設播送設定無效的隱私權設定。

2015 年 8 月 28 日

這次更新的修改如下:

  • 更新現有資源和方法

    • video 資源的 statistics.favoriteCount 屬性已淘汰。

      根據我們的廢止政策,在本次公告後至少一年,我們會在 video 資源中加入這項資源。不過,屬性值現在一律會設為 0

2015 年 8 月 7 日

這次更新的修改如下:

  • 更新現有資源和方法

    • video 資源的 snippet.tags[] 屬性定義已更新,以提供更多 API 伺服器如何計算屬性值長度的資訊。請注意,這項更新不代表 API 行為的變更。

      具體來說,這個定義說明瞭如果標記含有空格,API 伺服器會像設定在引號括住標記值一樣處理代碼值,而半形引號也會計入字元限制。因此,Foo-Baz 代碼有 7 個字元,但代碼「Foo Baz」的代碼卻有 9 個字元,因此才算字元限制。

    • commentThreads.insert 方法不再支援 shareOnGooglePlus 參數,先前表示該留言的留言和回覆是否也應張貼到作者的 Google+ 個人資料中。如果要求提交參數,API 伺服器會忽略該參數,但在其他方面處理要求。

2015 年 6 月 18 日

這次更新的修改如下:

  • 更新現有資源和方法

    • commentThreads.list 方法的新 order 參數可指定 API 回應應列出註解執行緒的順序。討論串可以依時間或關聯性排序。預設行為是依時間排序。

    • video 資源的新 snippet.defaultAudioLanguage 屬性會指定影片預設音軌所使用的語言。

    • 我們更新了 video 資源的 contentDetails.licensedContent 屬性定義,明確指出內容必須是先上傳至與 YouTube 內容合作夥伴相連結的頻道,再由該合作夥伴聲明版權。但這不代表實際的 API 行為變更。

    • captions.deletecaptions.downloadcaptions.insertcaptions.listcaptions.update 方法現在支援 onBehalfOfContentOwner 參數,其他方法已支援這個參數。使用該方法的要求也必須取得提供 https://www.googleapis.com/auth/youtubepartner 範圍存取權的權杖進行授權。

  • 最新錯誤和更新後的錯誤

    • 這個 API 現在支援下列錯誤:

      錯誤詳細資料
      videos.rate
      HTTP 回應代碼badRequest (400)
      原因emailNotVerified
      說明使用者必須先驗證自己的電子郵件地址,才能為影片評分。
      videos.rate
      HTTP 回應代碼badRequest (400)
      原因videoPurchaseRequired
      說明只有已租借影片的使用者才能評分。
    • subscriptions.deletesubscriptions.insert 方法不再支援 accountClosedaccountSuspended 錯誤。

2015 年 4 月 27 日

這次更新的修改如下:

  • 全新資源和方法

    • 新的 videoAbuseReportReason 資源內含影片遭檢舉含有不當內容的原因。videoAbuseReportReasons.list 方法可讓您擷取影片遭檢舉的所有原因清單。

    • 新的 videos.reportAbuse 方法可讓您實際檢舉含有不當內容的影片。要求的主體包含 JSON 物件,用於指出遭檢舉的影片及遭判定含有不當內容的原因。您可以使用上述的 videoAbuseReportReason.list 方法取得有效原因。

      此外,我們還更新了遷移指南,提供檢舉不當影片的範例。經過這次異動後,第 3 版 API 現已支援其預定支援的所有 v2 API 功能。遷移指南也會完整說明這些功能。

  • 更新現有資源和方法

    • search.list 方法的新 forDeveloper 篩選器參數會將搜尋範圍限制為只擷取透過開發人員應用程式或網站上傳的影片。forDeveloper 參數可與選用搜尋參數 (例如 q 參數) 搭配使用。

      這項功能會透過 Google Developers Console 中,與開發人員應用程式相關聯的專案編號,自動標記每部上傳的影片。

      當搜尋要求後續將 forDeveloper 參數設為 true 時,API 伺服器會使用要求的授權憑證來識別開發人員。因此,開發人員可以將搜尋結果限制為透過開發人員自家應用程式或網站上傳的影片,但是無法瀏覽透過其他應用程式或網站上傳的影片。

      這項新功能與第 2 版 API 支援的開發人員標記功能相似,但完全相同。

    • channel 資源新增了 snippet.country 資源,可讓頻道擁有者將頻道與特定國家/地區建立關聯。

      注意:如要設定 channel 資源的 snippet.country 屬性,其實需要更新 brandingSettings.channel.country 屬性。

    • API 現已支援指定 channelSection 資源。指定頻道區塊可限制內容版面只對符合特定條件的使用者顯示。

      API 提供三種指定目標選項。使用者必須符合頻道區塊的所有指定目標設定,才會顯示。

    • video 資源的 contentDetails.duration 屬性定義已經過修正,表示該值可以反映小時數、天數等。

    • channelSections.deleteplaylistItems.deleteplaylists.deletesubscriptions.deletevideos.delete 方法的說明文件已經過修正,反映成功後,這些方法都會傳回 HTTP 204 回應代碼 (No Content)。

  • 最新錯誤和更新後的錯誤

    • 這個 API 現在支援下列錯誤:

      錯誤類型 錯誤詳細資料 說明
      badRequest (400) targetInvalidCountry 如果插入的 channelSection 資源含有無效的 targeting.countries[] 屬性值,channelSections.insertchannelSections.update 方法會傳回這個錯誤。
      badRequest (400) targetInvalidLanguage 如果插入的 channelSection 資源含有無效的 targeting.languages[] 屬性值,channelSections.insertchannelSections.update 方法會傳回這個錯誤。
      badRequest (400) targetInvalidRegion 如果插入的 channelSection 資源含有無效的 targeting.regions[] 屬性值,channelSections.insertchannelSections.update 方法會傳回這個錯誤。
      badRequest (400) operationNotSupported 如果 API 使用者無法在 snippet.parentId 屬性識別的頂層註解中插入註解,comments.insert 方法會傳回這個錯誤。在 commentThread 資源中,snippet.canReply 屬性會指出目前的檢視者是否能回覆討論串。
      badRequest (400) invalidChannelId 如果要求中的 channelId 參數指定無效的頻道 ID,search.list 方法會傳回這個錯誤。
      badRequest (400) subscriptionForbidden 如果 API 使用者嘗試訂閱使用者的頻道,subscriptions.insert 方法會傳回這個錯誤。
    • captions.update 方法不再支援 invalidMetadatavideoNotFound 錯誤。

2015 年 4 月 16 日

這次更新的修改如下:

  • 遷移指南已更新,說明如何從第 2 版 API 遷移仍在使用留言功能的應用程式。

    該指南也指出第 2 版 API 不支援但 v3 API 支援的多項註解功能,包括:

    • 擷取頻道留言
    • 擷取與頻道相關的所有留言串,也就是說,API 回應可以包含與頻道或其任何影片有關的評論。
    • 更新留言文字
    • 將留言標示為垃圾內容
    • 設定留言管理狀態

  • 我們更新了《訂閱推播通知》指南,說明通知只會推送到 Google PubSubHubBub 中心,而非如先前所指示的 Superfeedr 中樞。

2015 年 4 月 9 日

這次更新的修改如下:

  • API 提供全新的 commentThreadcomment 資源,可讓您擷取、插入、更新、刪除及管理註解。

    • commentThread 資源包含 YouTube 留言串的相關資訊,其中包含該留言的頂層留言和回覆 (如果有的話)。commentThread 資源可以代表對影片或頻道的留言。

      頂層註解和回覆實際上是巢狀於 commentThread 資源中的 comment 資源。請注意,commentThread 資源不一定會包含註解的所有回覆;如要擷取特定留言的所有回覆,就必須使用 comments.list 方法。此外,有些留言沒有回覆。

      這個 API 支援下列 commentThread 資源方法:

    • comment 資源含有單一 YouTube 留言的相關資訊。comment 資源可以代表對影片或頻道的留言。此外,該留言可能是頂層留言或頂層留言的回覆。

      這個 API 支援下列 comment 資源方法:

    請注意,呼叫 comments.insertcomments.updatecomments.markAsSpamcomments.setModerationStatuscomments.deletecommentThreads.insertcommentThreads.update 方法時,必須根據 2015 年 4 月 2 日的修訂版本記錄所述,提供此 API 的新 https://www.googleapis.com/auth/youtube.force-ssl 範圍。

  • 新的訂閱推播通知指南說明 API 新推出的 PubSubHubBub (一種針對網路可存取資源的伺服器對伺服器發布/訂閱通訊協定),現已支援推播通知。當頻道進行下列任一活動時,PubSubHubBub 回呼伺服器就會接收 Atom 動態消息通知:

    • 上傳影片
    • 更新影片標題
    • 更新影片說明

  • 此外,我們也更新了遷移指南,說明新推出的推播通知支援功能。不過,由於 v2 API 支援許多其他第 3 版 API 不支援的推播通知類型,因此該指南的「已淘汰」一節中仍會列出有關 PubSubHubBub 支援的內容。

  • API 的新 https://www.googleapis.com/auth/youtube.force-ssl 範圍現在是先前支援 https://www.googleapis.com/auth/youtube 範圍的任何 API 方法的有效範圍。

  • 這個 API 現在支援下列錯誤:

    錯誤類型 錯誤詳細資料 說明
    badRequest (400) invalidRating 如果要求包含的 rating 參數非預期值,videos.rate 方法會傳回這個錯誤。
  • subscriptions.insert 方法不再支援 subscriptionLimitExceeded 錯誤,先前表示提出要求的訂閱者已超出訂閱頻率限制。

2015 年 4 月 2 日

這次更新的修改如下:

  • 新的 captions 資源代表 YouTube 字幕軌。字幕軌僅與一部 YouTube 影片相關聯。

    這個 API 支援列出插入更新下載刪除字幕軌的方法。

  • 此外,我們也更新了遷移指南,說明如何遷移仍在第 2 版 API 中使用字幕功能的應用程式。

  • API 的新 https://www.googleapis.com/auth/youtube.force-ssl 範圍需要透過 SSL 連線與 API 伺服器通訊。

    這個新範圍會授予與 https://www.googleapis.com/auth/youtube 範圍相同的存取權。事實上,這兩個範圍其實是相同的,因為 YouTube API 伺服器只能透過 HTTPS 端點使用。因此,雖然 https://www.googleapis.com/auth/youtube 範圍不需要使用 SSL 連線,但實際上卻無法提出 API 要求。

    必須指定新範圍才能呼叫 caption 資源的所有方法。

2015 年 3 月 11 日

這次更新的修改如下:

  • YouTube Data API (v3) 遷移指南包含一個名為「v3 API 的新功能」的新分頁,其中列出 v3 API 支援和 v2 API 不支援的功能。先前保有的功能,在指南的其他分頁中仍會列出。舉例來說,頻道 (設定檔) 分頁下方也會列出說明如何更新頻道內宣傳廣告活動資料的新功能。

  • 我們更新了 YouTube Data API (v3) 遷移指南,說明 v3 API 支援下列 v2 API 功能:

  • 我們更新了 YouTube Data API (v3) 遷移指南,說明 v3 API 將不支援下列 v2 API 功能:

    • 擷取影片建議 – v3 API 不會擷取僅包含針對目前 API 使用者推薦影片的清單。不過,只要呼叫 activities.list 方法並將 home 參數值設為 true,即可使用 v3 API 尋找推薦影片。

      在 API 回應中,如果 snippet.type 屬性值為 recommendation,則資源會對應至建議的影片。在這種情況下,contentDetails.recommendation.reasoncontentDetails.recommendation.seedResourceId 屬性會說明影片推薦的原因。請注意,我們不保證回應內容一定會包含特定數量的推薦影片。

    • 擷取頻道建議

    • 擷取新的訂閱影片 – v3 API 不會擷取只包含最近上傳至 API 使用者所訂閱頻道的影片清單。不過,只要呼叫 activities.list 方法並將 home 參數值設為 true,即可使用 v3 API 尋找新的訂閱影片。

      在 API 回應中,如果 snippet.type 屬性值為 upload,則資源會對應至新訂閱影片。請注意,我們無法保證回應內容一定包含任何特定數量的新訂閱影片。

    • RSS 動態消息支援

    • 動態消息更新的推播通知:第 2 版 API 支援使用簡易更新通訊協定 (SUP) 或 PubSubHubbub 的推播通知,監控 YouTube 使用者的活動動態消息。在新頻道訂閱頻道,以及影片被評分、分享、標示為最愛、留言或上傳時,均會收到通知。

      第 3 版 API 支援使用 PubSubHubbub 通訊協定的推播通知,但通知僅涵蓋影片的上傳和標題或影片說明更新。

    • 頻道位置:第 2 版 API 會使用 <yt:location> 標記來辨識使用者在頻道 YouTube 公開個人資料中輸入的位置。雖然部分開發人員使用這個欄位將頻道與特定國家/地區建立關聯,但該欄位的資料可能無法持續用於該目的。

    • 設定或擷取開發人員標記:第 2 版 API 支援在上傳影片時,將關鍵字或開發人員標記與影片建立關聯。開發人員標記不會向 YouTube 使用者顯示,但影片擁有者可以擷取與特定開發人員標記相符的影片。

      第 3 版 API 會提供類似但不完全相同的功能。具體來說,開發人員將可搜尋開發人員自家應用程式所上傳的影片。這項功能會透過 Google Developers Console 中,與開發人員應用程式相關聯的專案編號,自動標記每部上傳的影片。然後利用相同的專案編號搜尋影片。

    • 按照發布日期、觀看次數或評分列出影片:在第 2 版 API 中,orderby 參數可讓您依位置、時間長度、發布日期、標題和其他幾個值排序播放清單中的影片。在第 3 版 API 中,播放清單項目通常會依遞增順序排序,無法使用其他排序選項。

      有幾個例外狀況。系統會自動將你上傳的新影片、最愛的影片、喜歡的影片或最近看過的影片新增為以下播放清單類型的第一個項目 (snippet.position=0)。因此,每份清單都能根據項目加入時間的順序,由新到舊排序。

      • 使用者上傳
      • 最愛的影片
      • 喜歡的影片
      • 觀看記錄

      不過請注意,新增至「稍後觀看」播放清單的新項目會是清單中最後一個項目,因此這份清單會從最舊到最新項目排序。

    • 批次處理 – v3 API 支援 v2 API 支援的其中一種批次處理用途。v3 API 的 channels.listchannelSections.listguideCategories.listplaylistItems.listplaylists.listsubscriptions.listvideoCategories.listvideos.list 方法都支援 id 參數,可用於指定以半形逗號分隔的 ID 清單 (影片 ID、頻道 ID 等)。使用這些方法,您就可以在單一要求中擷取多個資源清單。

    在進行這些變更後,本指南現在會列出目前 API 版本 (v3) 中淘汰的舊版 (v2) API 支援的所有功能。

2015 年 3 月 4 日

這次更新的修改如下:

  • channelSections.deletechannelSections.update 方法現在支援 onBehalfOfContentOwner 參數,某些方法已支援該參數。

  • 下列屬性及其子項屬性已淘汰:

    • brandingSettings.image.backgroundImageUrl
    • brandingSettings.image.largeBrandedBannerImageImapScript
    • brandingSettings.image.largeBrandedBannerImageUrl
    • brandingSettings.image.smallBrandedBannerImageImapScript
    • brandingSettings.image.smallBrandedBannerImageUrl

    注意:上述屬性皆不符合《API 淘汰政策》規定。

  • video 資源的新 contentDetails.contentRating.contentDetails.contentRating.djctqRatingReasons 屬性會指出影片獲得 DJCQT (巴西) 分級的原因。

  • 這個 API 現在支援下列錯誤:

    錯誤類型 錯誤詳細資料 說明
    notFound (404) channelNotFound 如果要求的 id 參數指定找不到的頻道,channels.update 方法會傳回這個錯誤。
    badRequest (400) manualSortRequiredinvalidValue 如果要求嘗試設定播放清單項目的位置,但播放清單並未使用手動排序,playlistItems.insertplaylistItems.update 方法會傳回這個錯誤。舉例來說,播放清單項目可以按照日期或熱門程度排序。如要解決這個錯誤,請從要求主體中傳送的資源中移除 snippet.position 元素。如果您希望播放清單項目在清單中的特定位置,就必須先將播放清單的順序設定更新為「手動」。你可以在 YouTube 影片管理員中調整這項設定。
    forbidden (403) channelClosed 如果要求的 channelId 參數指定已關閉的頻道,playlists.list 方法會傳回這個錯誤。
    forbidden (403) channelSuspended 如果要求的 channelId 參數指定遭停權的頻道,playlists.list 方法會傳回這個錯誤。
    forbidden (403) playlistForbidden 如果要求的 id 參數不支援要求,或者要求未獲適當授權,playlists.list 方法會傳回這個錯誤。
    notFound (404) channelNotFound 如果要求的 channelId 參數指定找不到的頻道,playlists.list 方法會傳回這個錯誤。
    notFound (404) playlistNotFound 如果要求的 id 參數指定找不到的播放清單,playlists.list 方法會傳回這個錯誤。
    notFound (404) videoNotFound 如果要求的 id 參數指定找不到的影片,videos.list 方法會傳回這個錯誤。
    badRequest (400) invalidRating 如果要求包含的 rating 參數非預期值,videos.rate 方法會傳回這個錯誤。

2015 年 3 月 2 日

這次更新的修改如下:

2015 年 1 月 14 日

這次更新的修改如下:

  • 我們更新了 YouTube Data API (v3) 遷移指南,說明如何使用 v3 API 透過 JavaScript 上傳影片。(詳情請參閱「上傳影片」一節)。這項功能與第 2 版 API 支援的瀏覽器上傳上傳功能類似。請注意,這項遷移指南的變更並非反映實際的 API 變更,而是提供新的程式碼範例,讓您透過用戶端 JavaScript 上傳影片。

    自從 JavaScript 用戶端程式庫和 CORS 上傳影片時,遷移指南不再列出透過瀏覽器上傳的功能,此功能可能在 v3 API 中淘汰。

  • videos.insert 方法的說明文件已更新,納入上述的新 JavaScript 程式碼範例。YouTube Data API (v3) 的 JavaScript 程式碼範例清單也已更新。

2014 年 11 月 11 日

這次更新的修改如下:

  • 呼叫 search.list 方法的配額費用已變更為 100 個單位。

    重要事項:在許多情況下,您可以使用其他 API 方法擷取資訊,並降低配額。例如,有兩種方法可以搜尋上傳至 GoogleDevelopers 頻道的影片。

    • 配額費用:100 個單位

      呼叫 search.list 方法,然後搜尋 GoogleDevelopers

    • 配額費用:6 個單位

      呼叫 channels.list 方法,找出正確的頻道 ID。將 forUsername 參數設為 GoogleDevelopers,並將 part 參數設為 contentDetails。在 API 回應中,contentDetails.relatedPlaylists.uploads 屬性會指定頻道上傳影片的播放清單 ID。

      接著呼叫 playlistItems.list 方法,並將 playlistId 參數設為擷取的 ID,並將 part 參數設為 snippet

2014 年 10 月 8 日

這次更新的修改如下:

  • channel 資源包含兩個新屬性:

    • status.longUploadsStatus 屬性可指出頻道是否有資格上傳長度超過 15 分鐘的影片。只有在頻道擁有者授權 API 要求時,才會傳回這個屬性。有效的屬性值為:

      • allowed:頻道可以上傳長度超過 15 分鐘的影片。
      • eligible:頻道有資格上傳長度超過 15 分鐘的影片,但必須先啟用這項功能。
      • disallowed:頻道無法或符合資格,無法上傳長度超過 15 分鐘的影片。

      如要進一步瞭解這些值,請參閱屬性定義。如要進一步瞭解這項功能,請造訪 YouTube 說明中心

    • invideoPromotion.useSmartTiming 屬性會指出頻道宣傳廣告活動是否採用「智慧時間」。這項功能會試著在影片播放時間點顯示宣傳活動,吸引觀眾點擊的機率較高,且較不可能幹擾觀看體驗。這項功能也會挑選每部影片來顯示一項宣傳活動。

  • video 資源的 snippet.titlesnippet.categoryId 屬性定義也已更新,以明確說明 API 處理對 videos.update 方法呼叫的方式。如果您呼叫該方法更新 video 資源的 snippet 部分,就必須為這兩個屬性設定值。

    如果您嘗試更新 video 資源的 snippet 部分,但未設定這兩項屬性的值,API 會傳回 invalidRequest 錯誤。該錯誤的說明也已更新。

  • video 資源的 contentDetails.contentRating.oflcRating 屬性可識別紐西蘭電影及文學分類辦公室 (Office of Film and Literature Classification) 提供的影片評分,現在支援兩種新的分級:oflcRp13oflcRp16。這些項目分別對應 RP13RP16 評分。

  • channelBanners.insert 方法現在支援下列錯誤:

    錯誤類型 錯誤詳細資料 說明
    badRequest bannerAlbumFull 頻道擁有者的 YouTube 頻道圖片相簿有太多圖片。頻道擁有者應前往 http://photos.google.com 瀏覽相簿頁面,並從該相簿中移除部分圖片。

2014 年 9 月 12 日

這次更新的修改如下:

  • 除了指定資源部分的費用外,呼叫 search.list 方法的配額費用已從 1 個單位變更為 2 個單位。

2014 年 8 月 13 日

這次更新的修改如下:

  • subscriptions.insert 方法現在支援下列錯誤:

    錯誤類型 錯誤詳細資料 說明
    badRequest subscriptionLimitExceeded 此要求所識別的訂閱者已超出訂閱頻率限制。請於幾小時後嘗試更多訂閱。

2014 年 8 月 12 日

這次更新的修改如下:

  • 名為將應用程式遷移至 YouTube Data API (v3) 的新指南說明如何透過 YouTube Data API (v3) 執行 YouTube Data API (第 2 版) 的各項功能。舊版 API 已於 2014 年 3 月 4 日淘汰。本指南可協助您將仍在使用第 2 版 API 的應用程式遷移至最新版 API。

2014 年 7 月 8 日

這次更新的修改如下:

  • playlists.insert 方法現在支援下列錯誤:

    錯誤類型 錯誤詳細資料 說明
    badRequest maxPlaylistExceeded 如果頻道的播放清單數量已達上限,導致無法建立播放清單,就會發生這個錯誤。

2014 年 6 月 18 日

這次更新的修改如下:

  • 每個 API 方法的說明已更新,現在包含呼叫該方法產生的配額費用。同樣地,part 參數的定義也已更新,以指定可透過 API 呼叫擷取各部分的配額成本。舉例來說,呼叫 subscriptions.insert 方法的配額費用大約為 50 個單位。subscription 資源也包含三個部分 (snippetcontentDetailssubscriberSnippet),且每個部分的費用為兩個單位。

    請注意,配額費用可能會在無預警的情況下變更。

  • video 資源現在支援 43 個新的內容分級系統,可識別各國分級機構的影片評分。下列分級系統阿根廷、印尼 {臺灣{ {130{ 110{ { {臺灣{ { {臺灣{ { {臺灣{ { {印尼{ {10{{ { { {印尼{{ { {10

2014 年 5 月 28 日

這次更新的修改如下:

  • search.list 方法現在支援 locationlocationRadius 參數,可讓您搜尋與地理位置相關聯的影片。要求必須同時為兩個參數指定值,才能根據位置擷取結果,如果要求只包含這兩個參數之一,API 就會傳回錯誤。

    • location 參數會指定圓形地理區域中心的經緯度座標。

    • locationRadius 參數會指定與影片相關聯的位置距離將出現在搜尋結果的最遠距離內。

2014 年 5 月 13 日

這次更新的修改如下:

  • channel 資源的 invideoPromotion.items[] 屬性已更新,請注意,您通常只能為頻道設定一個宣傳項目。如果您嘗試插入的宣傳商品太多,API 就會傳回 tooManyPromotedItems 錯誤,而會顯示 HTTP 400 狀態碼。

  • channelSection 資源現在包含幾種全新類型精選內容的相關資訊。channelSection 資源的 snippet.type 屬性現在支援下列值:

    • postedPlaylists - 頻道擁有者發布至頻道活動動態消息的播放清單
    • postedVideos - 頻道擁有者發布至頻道活動動態消息的影片
    • subscriptions - 頻道擁有者訂閱的頻道

  • video 資源的新 contentDetails.contentRating.ifcoRating 屬性可識別來自愛爾蘭電影分類辦公室的影片分級。

  • watermark 資源的 position.cornerPosition 屬性定義已更新,請注意,浮水印一律會顯示在播放器的右上角。

  • search.list 方法的 q 參數定義已更新,請注意,查詢字詞可使用布林 NOT (-) 運算子,排除與特定搜尋字詞相關的影片。這個值也可以使用布林 OR (|) 運算子,尋找與多個搜尋字詞之一相關聯的影片。

  • 在 API 呼叫 search.list 呼叫中傳回的 pageInfo.totalResults 屬性定義已更新,請注意該值是約略值,不一定代表實際值。此外,最大值為 1,000,000。請不要使用這個值建立分頁連結。請改用 nextPageTokenprevPageToken 屬性值來判斷是否要顯示分頁連結。

  • watermarks.setwatermarks.unset 方法已更新,以反映 API 會在成功向這些方法發出要求時傳回 HTTP 204 回應代碼。

2014 年 5 月 2 日

這次更新的修改如下:

  • 新的 i18nLanguage 資源會指出 YouTube 網站支援的應用程式語言。應用程式語言也可以稱為 UI 語言。在 YouTube 網站上,應用程式語言會根據 Google 帳戶設定、瀏覽器語言或 IP 位置自動選取,使用者也可以從 YouTube 網站頁尾手動選取所需語言。

    API 支援一種方法,列出支援的語言。呼叫 videoCategories.listguideCategories.list 等 API 方法時,支援的語言可做為 hl 參數的值。

  • 新的 i18nRegion 資源會指出 YouTube 使用者可以選取做為偏好內容地區的地理區域。內容地區也可稱為內容語言代碼。如果是 YouTube 網站,系統可能會根據 YouTube 網域或使用者的 IP 位置等經驗法則自動選取內容地區,而使用者也可以在 YouTube 網站頁尾手動選取所需的內容區域。

    API 支援一種方法,列出支援的內容地區。呼叫 search.listvideos.listactivities.listvideoCategories.list 等 API 方法時,支援的區碼可做為 regionCode 參數的值。

2014 年 4 月 7 日

這次更新的修改如下:

  • 新的 channelSection 資源含有頻道選擇要主打的一組影片相關資訊。舉例來說,「版面」可以是頻道最近上傳的影片、最受歡迎的上傳影片,或是一或多個播放清單中的影片。

    這個 API 支援 listinsertupdatedelete 頻道區段的方法。您可以擷取已驗證使用者的頻道頻道區段清單、指定特定頻道 ID,或是指定不重複的頻道版面 ID 清單。

    此外,錯誤說明文件也已更新,以說明 API 針對這些新方法特別支援的錯誤訊息。

  • video 資源的 fileDetails 物件定義已更新,說明只有在影片的 processingDetails.fileDetailsAvailability 屬性值是 available 時,才會傳回該物件。

    同樣地,video 資源的 suggestions 物件定義也已更新,說明只有在影片的 processingDetails.tagSuggestionsAvailability 屬性或 processingDetails.editorSuggestionsAvailability 屬性值為 available 時,系統才會傳回該物件。

  • videos.insertvideos.update 方法的說明文件已更新,以指出在呼叫這些方法時,您可以設定 status.publishAt 屬性。

  • channel 資源的 invideoPromotion 物件定義已更新,說明只有頻道擁有者才能擷取該物件。

  • videos.rate 方法的參數清單已更新,以反映該方法實際上不支援 onBehalfOfContentOwner 參數。這是說明文件錯誤,因為 videos.rate 要求設定此參數會傳回 500 錯誤。

2014 年 3 月 31 日

這次更新的修改如下:

2014 年 3 月 13 日

這次更新的修改如下:

  • API 現已支援 channel 資源的 contentOwnerDetails 部分。新的部分包含與頻道連結的 YouTube 合作夥伴相關的頻道資料,包含頻道連結的內容擁有者 ID,以及內容擁有者與頻道連結的日期與時間。請注意,這個新段落不受廢止政策約束

  • 說明文件現在列出下列屬性支援的字元長度上限:

    資源 屬性 長度上限
    channel invideoPromotion.items[].customMessage 40 個半形字元
    video snippet.title 100 個字元 (或 50 個全形字元)
    video snippet.description 5,000 個位元組
    video snippet.tags 500 個半形字元,請注意,屬性值是清單,且清單中各個項目之間的半形逗號都會計入限制。
  • channel 資源的 brandingSettings.watch.featuredPlaylistId 屬性已淘汰。如果您嘗試設定其值,API 將傳回錯誤。

  • 插入更新影片時,這些值的清單已新增下列 video 資源屬性:

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

  • 這個 API 現在支援下列錯誤:

    錯誤類型 錯誤詳細資料 說明
    badRequest (400) invalidCriteria 如果要求指定的篩選器參數無法彼此搭配使用,channels.list 方法會傳回這個錯誤。
    badRequest (400) channelTitleUpdateForbidden 如果您嘗試更新頻道的 brandingSettings 部分並變更 brandingSettings.channel.title 屬性的值,channels.update 方法會傳回這個錯誤。(請注意,如果省略屬性,API 不會傳回錯誤)。
    badRequest (400) invalidRecentlyUploadedBy 如果 invideoPromotion.items[].id.recentlyUploadedBy 屬性指定無效的頻道 ID,channels.update 方法會傳回這個錯誤。
    badRequest (400) invalidTimingOffset 如果 invideoPromotion 部分指定無效的時間偏移,channels.update 方法會傳回這個錯誤。
    badRequest (400) tooManyPromotedItems 如果 invideoPromotion 部分指定的宣傳商品數量超過允許的數量,channels.update 方法會傳回這個錯誤。
    forbidden (403) promotedVideoNotAllowed 如果 invideoPromotion.items[].id.videoId 屬性指定的影片 ID 找不到或無法當做宣傳項目使用,channels.update 方法會傳回這個錯誤。
    forbidden (403) websiteLinkNotAllowed 如果 invideoPromotion.items[].id.websiteUrl 屬性指定不允許的網址,channels.update 方法會傳回這個錯誤。
    required (400) requiredTimingType 如果要求沒有指定預設時間設定,決定 YouTube 顯示宣傳商品的時間,channels.update 方法會傳回這個錯誤。
    required (400) requiredTiming channels.update 方法必須為每個宣傳項目指定 invideoPromotion.items[].timing 物件。
    required (400) requiredWebsiteUrl channels.update 方法必須為每個宣傳項目指定 invideoPromotion.items[].id.websiteUrl 屬性。
    badRequest (400) invalidPublishAt 如果要求中繼資料指定了無效的排定發布時間,videos.insert 方法會傳回這個錯誤。

2014 年 3 月 4 日

這次更新的修改如下:

2013 年 12 月 5 日

這次更新的修改如下:

  • search.list 方法的說明文件已正確更新,可正確反映提交搜尋要求時,您不需要只指定一個篩選器參數值。而是可以為 0 個篩選器參數或一個篩選器參數設定值。

  • search.list 方法參數的定義已更新,請注意,如果您同時指定下列任一參數的值,則必須將 type 參數值設為 video

    • eventType
    • videoCaption
    • videoCategoryId
    • videoDefinition
    • videoDimension
    • videoDuration
    • videoEmbeddable
    • videoLicense
    • videoSyndicated
    • videoType

  • 上傳的頻道橫幅圖片最小尺寸已縮減為 2048 像素 x 1152 像素。(先前大小的下限為 2120 x 1192 像素)。此外,請注意 channel 資源說明文件會指定 API 放送的所有橫幅圖片大小上限。舉例來說,電視應用程式的 brandingSettings.image.bannerTvImageUrl 圖片大小上限為 2120 x 1192 像素,但實際圖片大小可能為 2048 x 1152 像素。YouTube 說明中心提供其他指引,說明如何最佳化頻道圖片,以便在不同類型的裝置上顯示。

  • 我們更新了多項 channel 資源屬性定義,以反映下列資訊:

    • brandingSettings.channel.description 屬性的值的長度上限為 1000 個半形字元。
    • brandingSettings.channel.featuredChannelsTitle 屬性的長度上限為 30 個半形字元。
    • brandingSettings.channel.featuredChannelsUrls[] 資源現在最多可列出 100 個頻道。
    • 設定 brandingSettings.channel.unsubscribedTrailer 屬性值時,必須指定頻道擁有者擁有的公開或不公開影片的 YouTube 影片 ID。

  • channels.update 方法現在支援對 invideoPromotion.items[].promotedByContentOwner 屬性的更新。該屬性會指出顯示宣傳活動時,是否會顯示內容擁有者的名稱。只有在使用 onBehalfOfContentOwner 參數代表內容擁有者代表設定屬性值的 API 要求時,才能設定這個值。

  • playlistItems.listplaylistItems.insert 方法現在支援 onBehalfOfContentOwner 參數,某些方法已支援該參數。

  • contentDetails.contentRating.acbRating 屬性現在可以指定澳洲分級委員會 (ACB) 提供的電影分級,也可以由澳洲通訊及媒體局 (ACMA) 針對兒童電視節目指定分級。

  • 新的 contentDetails.contentRating.catvRatingcontentDetails.contentRating.catvfrRating 屬性可識別影片受到加拿大電視分級系統 (Canadian TV Classification System) 獲得的分級,以及法語 Régie du cinéma 分級系統 (魁北克) 分別採用的法文分級系統。

  • videoCategory 資源的新 snippet.assignable 屬性會指出已更新的影片或新上傳的影片是否可與該影片類別建立關聯。

  • 已為下列方法新增程式碼範例:

2013 年 10 月 24 日

這次更新的修改如下:

  • 這個 API 包含兩項額外功能,可協助尋找及宣傳現場直播內容:

    搜尋結果中的新的 snippet.liveBroadcastContent 屬性會指出影片或頻道資源是否具有現場直播內容。有效屬性值為 upcomingactivenone

    請注意,我們在 2013 年 10 月 1 日發布了另外兩項用於識別直播內容的功能:search.list 方法的 eventType 參數和搜尋結果的 snippet.liveBroadcastContent 屬性。

  • videos.insert 方法現在支援 notifySubscribers 參數,指示 YouTube 是否應該向訂閱影片頻道的使用者傳送新影片的通知。這個參數的預設值為 True,表示訂閱者會收到新上傳影片的通知。不過,如果頻道擁有者上傳了多部影片,建議將值設為 False,以免系統將每部新影片上架的通知傳送給頻道的訂閱者。

  • 已更新呼叫 channels.update 方法時可修改的屬性清單,納入 invideoPromotion.items[].customMessageinvideoPromotion.items[].websiteUrl 屬性。此外,清單也已經過修改,找出可修改的 brandingSettings 屬性。這些 brandingSettings 屬性已可以修改,因此說明文件變更內容並不會反映 API 現有功能的變更。

  • playlists.insertplaylists.updateplaylists.delete 方法現在支援 onBehalfOfContentOwner 參數,某些方法已支援該參數。

  • playlists.insert 方法現在支援 onBehalfOfContentOwnerChannel 參數,其他多種方法已支援此參數。

  • video 資源的 contentDetails.contentRating.tvpgRating 屬性現在支援 pg14 值,該值與 TV-14 評分相對應。

  • 系統已修正 snippet.liveBroadcastContent 屬性 (屬於搜尋結果的一部分) 的定義,反映 live 是有效的屬性值,但 active 不是有效的屬性值。

  • video 資源的 contentDetails.contentRating.mibacRating 屬性現在支援兩個額外的評分:

    • mibacVap (VAP):兒童應由成人陪同觀賞。
    • mibacVm6 (V.M.6):僅限 6 歲以上觀眾觀看。
    • mibacVm12 (V.M.12):僅限 12 歲以上的使用者。

  • channel 資源的新 invideoPromotion.items[].promotedByContentOwner 屬性可指定在顯示宣傳活動時,是否會顯示內容擁有者的名稱。只有由內容擁有者代表提出該值的 API 要求時,才能設定這個欄位。詳情請參閱 onBehalfOfContentOwner 參數。

2013 年 10 月 1 日

這次更新的修改如下:

  • channel 資源的新 auditDetails 物件包含多頻道聯播網 (MCN) 會在評估是否要接受或拒絕特定頻道時評估的頻道資料。請注意,任何擷取這個資源部分的 API 要求都必須提供包含 https://www.googleapis.com/auth/youtubepartner-channel-audit 範圍的授權權杖。此外,當 MCN 決定接受或拒絕頻道時,或在核發權杖後的兩週內,必須撤銷使用該範圍的權杖。

  • channel 資源的 invideoPromotion.items[].id.type 屬性現在支援 recentUpload 值,這表示宣傳項目是指定頻道最新上傳的影片。

    根據預設,頻道與設定影片內宣傳資料的帳戶相同。但您可以將新 invideoPromotion.items[].id.recentlyUploadedBy 屬性的值設為頻道 ID,藉此宣傳其他頻道最新上傳的影片。

  • channel 資源包含 brandingSettings.image.bannerTvLowImageUrlbrandingSettings.image.bannerTvMediumImageUrlbrandingSettings.image.bannerTvHighImageUrl 這三個新屬性,可用來指定電視應用程式頻道頁面中顯示的橫幅圖片網址。

  • 搜尋結果中的新的 snippet.liveBroadcastContent 屬性會指出影片或頻道資源是否具有現場直播內容。有效屬性值為 upcomingactivenone

    • 如果是 video 資源,如果值為 upcoming,表示影片是尚未開始的現場直播,而 active 值表示影片正在進行現場直播。
    • 如果是 channel 資源,如果值為 upcoming,表示頻道有排定的直播尚未開始,如果值為 acive,則表示頻道有進行中的現場直播。

  • watermark 資源中,targetChannelId 屬性已從物件變更為字串。現在起,targetChannelId 屬性會指定該值本身,不再加入子屬性來指定浮水印圖片連結的 YouTube 頻道 ID。因此,已移除該資源的 targetChannelId.value 屬性。

  • thumbnails.set 方法現在支援 onBehalfOfContentOwner 參數,其他多種方法已支援此參數。

  • search.list 方法現在支援 eventType 參數,可限制搜尋作業僅傳回進行中、即將開始或已完成的播送事件。

  • 新的 contentDetails.contentRating.mibacRating 屬性可識別義大利部長大白先決 e delle Attivita Culturali e del Turismo 的影片評分。

  • 這個 API 現在支援下列錯誤:

    錯誤類型 錯誤詳細資料 說明
    badRequest invalidImage 如果提供的圖片內容無效,thumbnails.set 方法會傳回這個錯誤。
    forbidden videoRatingDisabled 如果受評分影片的擁有者停用了該影片的評分功能,videos.rate 方法會傳回這個錯誤。

2013 年 8 月 27 日

這次更新的修改如下:

  • 新的 watermark 資源會識別播放指定頻道影片期間顯示的圖片。您也可以指定圖片連結的目標頻道,以及有關浮水印在影片播放期間出現的時間及顯示時間長度。

    watermarks.set 方法會上傳並設定頻道的浮水印圖片。watermarks.unset 方法會刪除頻道的浮水印圖片。

    錯誤說明文件說明瞭 API 針對 watermarks.setwatermarks.unset 方法特別支援的錯誤訊息。

  • channel 資源的新 statistics.hiddenSubscriberCount 屬性包含布林值,表示是否隱藏頻道的訂閱人數。因此,如果公開頻道的訂閱人數為公開,屬性值會是 false

  • playlists.list 方法現在支援 onBehalfOfContentOwneronBehalfOfContentOwnerChannel 參數。這兩個參數都已適用於其他幾種方法。

  • videos.list 方法現在支援 regionCode 參數,可識別應擷取圖表的內容區域。這個參數只能搭配 chart 參數使用。參數值是 ISO 3166-1 alpha-2 國家/地區代碼。

  • error documentation 說明下列新的常見要求錯誤,這些錯誤可能會出現在多個 API 方法中:

    錯誤類型 錯誤詳細資料 說明
    forbidden insufficientPermissions 與要求提供的 OAuth 2.0 權杖相關聯的範圍不足,無法存取所要求的資料。

2013 年 8 月 15 日

這次更新的修改如下:

  • channel 資源的 invideoPromotion 物件包含下列新屬性和更新後的屬性:

  • subscriptions.list 方法現在支援 onBehalfOfContentOwneronBehalfOfContentOwnerChannel 參數。這兩個參數都已適用於其他幾種方法。

  • 在對 thumbnails.set 要求的 API 回應中,kind 屬性值已從 youtube#thumbnailListResponse 變更為 youtube#thumbnailSetResponse

  • 已為下列方法新增程式碼範例:

    請注意,playlistItems.insert 方法的 Python 範例也已經移除,因為其示範的功能現在由 videos.rate 方法處理。

  • error documentation 說明瞭下列新的要求內容錯誤,任何支援 mine 要求參數的 API 方法都可能會發生這類錯誤:

    錯誤類型 錯誤詳細資料 說明
    badRequest invalidMine 如果已驗證的使用者是 YouTube 合作夥伴,則不得使用 mine 參數。您應移除 mine 參數、移除 onBehalfOfContentOwner 參數以以 YouTube 使用者身分進行驗證,或提供 onBehalfOfContentOwnerChannel 參數 (如果呼叫方法可用),藉此充當合作夥伴的頻道。

2013 年 8 月 8 日

這次更新的修改如下:

2013 年 7 月 30 日

這次更新的修改如下:

  • channelBanner 資源中,kind 屬性的值已從 youtube#channelBannerInsertResponse 變更為 youtube#channelBannerResource。系統會回應 channelBanners.insert 要求。

  • channel 資源的新 brandingSettings.channel.profileColor 屬性會指定與頻道內容互補的明顯顏色。屬性值是井字號 (#),後面接著六個字元十六進位字串,例如 #2793e6

  • 這個 API 現在可以指定訂閱項目是否適用於所有頻道的所有活動,或只用於新上傳的影片。subscription 資源的新 contentDetails.activityType 屬性可識別訂閱者要收到通知的活動類型。有效屬性值為 alluploads

  • videos.list 方法支援下列新參數,可用於擷取 YouTube 熱門影片的圖表:

    • chart 參數代表您要擷取的圖表。目前唯一支援的值是 mostPopular。請注意,chart 參數是篩選器參數,因此無法用於與其他篩選器參數 (idmyRating) 相同的要求。
    • videoCategoryId 參數可指明應擷取圖表的影片類別。這個參數只能搭配 chart 參數使用。根據預設,圖表不限於特定類別。

  • video 資源的新 topicDetails.relevantTopicIds[] 屬性,提供與影片或內容相關的 Freebase 主題 ID 清單。片中或提及這些主題的題材,

  • video 資源的 recordingDetails.location.elevation 屬性已重新命名為 recordingDetails.location.altitude,而其 fileDetails.recordingLocation.location.elevation 屬性已重新命名為 fileDetails.recordingLocation.location.altitude

  • video 資源的 contentDetails.contentRating 物件會指定影片在不同分級配置 (包括 MPAA 分級、TVPG 分級等) 時獲得的內容分級。API 現在支援每個分級系統的分級值,代表影片尚未評分。請注意,MPAA 分級時,我們會經常使用「無分級」分級來識別具有官方分級的電影未剪輯版本。

  • video 資源的新 contentDetails.contentRating.ytRating 屬性可識別年齡限制內容。如果 YouTube 發現影片含有不適合 18 歲以下使用者的內容,屬性值將為 ytAgeRestricted。如未提供這項屬性,或是屬性值為空白,表示內容並未被認定為年齡限制。

  • channels.list 方法的 mySubscribers 參數已淘汰。使用 subscriptions.list 方法及其 mySubscribers 參數,擷取已驗證使用者頻道的訂閱者清單。

  • channelBanners.insertchannels.updatevideos.getRatingvideos.rate 方法現在都支援 onBehalfOfContentOwner 參數。該參數表示經驗證的使用者,是代表參數值中指定的內容擁有者。

  • 更新 channels.update 方法的說明文件,以反映該方法可用於更新 channel 資源的 brandingSettings 物件及其子項屬性。說明文件現在也列出了您可以為 channel 資源的 invideoPromotion 物件設定的屬性更新清單。

  • error documentation 說明下列新的錯誤:

    錯誤類型 錯誤詳細資料 說明
    forbidden accountDelegationForbidden 這個錯誤並非僅適用於特定 API 方法。表示已通過驗證的使用者並未獲得授權,無法代表指定的 Google 帳戶執行這項操作。
    forbidden authenticatedUserAccountClosed 這個錯誤並非僅適用於特定 API 方法。代表已驗證使用者的 YouTube 帳戶已關閉。如果使用者代表其他 Google 帳戶,這則錯誤訊息會指出其他帳戶已關閉。
    forbidden authenticatedUserAccountSuspended 這個錯誤並非僅適用於特定 API 方法。代表已驗證使用者的 YouTube 帳戶已遭停權。如果使用者的代表其他 Google 帳戶已遭到停權,那麼這則錯誤訊息表示其他帳戶已遭停權。
    forbidden authenticatedUserNotChannel 這個錯誤並非僅適用於特定 API 方法。而是指出 API 伺服器無法識別與 API 要求相關聯的頻道。如果要求已獲得授權,且使用 onBehalfOfContentOwner 參數,請一併設定 onBehalfOfContentOwnerChannel 參數。
    forbidden cmsUserAccountNotFound 這個錯誤並非僅適用於特定 API 方法。CMS 使用者無法代表指定的內容擁有者。
    notFound contentOwnerAccountNotFound 這個錯誤並非僅適用於特定 API 方法。找不到指定的內容擁有者帳戶。
    badRequest invalidPart 這個錯誤並非僅適用於特定 API 方法。要求的 part 參數指定了無法同時寫入的部分。
    badRequest videoChartNotFound 要求指定不支援或無法使用的影片圖表時,videos.list 方法會傳回這個錯誤。
    notFound videoNotFound videos.update 方法會傳回這個錯誤,表示找不到要更新的影片。檢查要求主體中的 id 屬性值,確保其正確。

2013 年 6 月 10 日

這次更新的修改如下:

  • channels.list 方法的新 forUsername 參數可讓您指定 YouTube 使用者名稱,藉此擷取頻道的相關資訊。

  • activities.list 方法現在支援 regionCode 參數,可指示 API 傳回與指定國家/地區相關的結果。如果獲得授權的使用者先前在 YouTube 上的活動並未提供充足的資訊來產生活動動態消息,系統就會使用這個值。

  • 播放清單資源現在包含 snippet.tags 屬性。這個屬性只會傳回給擷取其播放清單相關資料的授權使用者。授權使用者也可以在呼叫 playlists.insertplaylists.update 方法時設定播放清單標記。

  • onBehalfOfContentOwner 參數先前支援 channels.listsearch.list 方法,現在也支援 videos.insertvideos.updatevideos.delete 方法。請注意,如果在呼叫 videos.insert 方法時使用這個參數,要求也必須為新的 onBehalfOfContentOwnerChannel 參數值指定值,以識別要新增影片的管道。此頻道必須與 onBehalfOfContentOwner 參數指定的內容擁有者相連結。

    這個參數表示該項要求的授權憑證,可識別 YouTube CMS 使用者,代表在參數值中指定的內容擁有者。用於驗證的 CMS 帳戶,必須連結至指定的 YouTube 內容擁有者。

    這個參數適用於擁有及管理多個不同 YouTube 頻道的內容合作夥伴。有了這個參數,這些合作夥伴只需驗證一次,即可存取所有影片和頻道資料,不必分別提供各個頻道的驗證憑證。

    關於這個版本,內容合作夥伴現在可以在合作夥伴擁有的 YouTube 頻道上,插入、更新或刪除影片。

  • error documentation 說明下列新的錯誤:

    錯誤類型 錯誤詳細資料 說明
    forbidden insufficientCapabilities 這個錯誤並非僅適用於特定 API 方法。表示呼叫 API 的 CMS 使用者沒有足夠的權限執行要求的作業。這項錯誤與 onBehalfOfContentOwner 參數的使用有關,但某些 API 方法支援該參數。
    unauthorized authorizationRequired 如果要求使用 home 參數,但未獲適當授權,activities.list 方法會傳回這個錯誤。
  • channels 資源中,系統已移除 invideoPromotion.channelId 屬性,因為已透過資源的 id 屬性指定頻道 ID。

  • 新的「使用管道 ID」指南說明瞭 API 如何使用管道 ID。開發人員從舊版 API 遷移,或本身有應用程式為 default 使用者要求內容,或是仰賴每位 YouTube 頻道皆擁有專屬使用者名稱 (但現在不再適用) 的觀念時,這份指南會特別有用。

2013 年 5 月 22 日

這次更新的修改如下:

2013 年 5 月 14 日

這次更新的修改如下:

  • 獨立網頁現在會列出 Java.NETPHPRuby 的程式碼範例。

  • 列出 Python 程式碼範例的頁面現在提供了新增訂閱、建立播放清單及更新影片的範例。

2013 年 5 月 10 日

這次更新的修改如下:

2013 年 5 月 8 日

這次更新的修改如下:

  • 頻道資源現在支援 inVideoPromotion 物件,該物件會封裝與頻道相關的宣傳活動資訊。頻道可以使用影片內宣傳廣告活動,在播放頻道影片時,在影片播放器中顯示推薦影片的縮圖。

    您可以在 channels.list 要求的 part 參數值中加入 invideoPromotion,以擷取這項資料。

  • 新的 channels.update 方法可用於更新頻道的影片內宣傳廣告活動資料。請注意,這個方法僅支援更新 channel 資源中的 invideoPromotion 部分,尚未支援該資源其他部分的更新。

2013 年 5 月 2 日

這次更新的修改如下:

  • 頻道資源現在支援 status.isLinked 屬性,這表示頻道資料會指出已連結至 YouTube 使用者名稱或 Google+ 帳戶的使用者。具有這類連結的使用者已具有公開的 YouTube 身分,這是執行多項操作 (例如上傳影片) 的先決條件。

  • 訂閱資源現在支援 subscriberSnippet 部分。這個物件封裝包含訂閱者頻道的程式碼片段資料。

  • API 現在支援 videos.getRating 方法,可擷取已驗證使用者給一或多部影片清單的評分。

  • videos.list 方法的新 myRating 參數可讓您擷取已驗證使用者評分為 likedislike 的影片清單。

    myRating 參數和 id 參數現已視為篩選器參數,也就是說,API 要求必須明確指定其中一個參數。(過去,id 參數是這個方法的必要參數)。

    此方法會在未獲適當授權的情況下,針對嘗試擷取影片分級資訊的要求傳回 forbidden 錯誤。

  • 隨著 myRating 參數推出,videos.list 方法也已更新以支援分頁。不過請注意,只有使用 myRating 參數的要求才支援分頁參數。(使用 id 參數的要求不支援 Paging 參數和資訊)。

    • maxResults 參數會指定 API 在結果集可傳回的影片數量上限,pageToken 參數則指定您要擷取的結果集中中的特定網頁。

    • 為回應 videos.list 要求而傳回的 youtube#videoListResponse 資源,現在包含 pageInfo 物件,其中包含結果總數和目前結果集包含的結果數量等詳細資料。youtube#videoListResponse 資源也可以包含 nextPageTokenprevPageToken 屬性,每個屬性都會提供可在結果集中擷取特定網頁的符記。

  • videos.insert 方法支援下列新參數:

    • autoLevels:將此參數值設為 true,指示 YouTube 自動改善影片的亮度和色彩。
    • stabilize:將這項參數值設為 true,指示 YouTube 移除鏡頭動作所產生的晃動程度來調整影片。

  • 已針對以下資源的 snippet 新增 channelTitle 屬性:

    • playlistItem - 這個屬性會指定新增播放清單項目的頻道名稱。
    • playlist - 這個屬性可指定建立播放清單的頻道名稱。
    • subscription - 屬性會指定所訂閱頻道的名稱。

  • 已為下列方法新增程式碼範例:

  • subscriptions.list 方法的新 mySubscribers 參數可讓您擷取目前已驗證使用者的訂閱者清單。這個參數只能在正確授權要求中使用。

    注意:這項功能旨在取代目前適用於 channels.list 方法的 mySubscribers 參數。該參數將被淘汰。

  • video 資源中,下列任何屬性的 unspecified 屬性值不再是可能的值:

  • 包含非預期參數的 API 要求現在會傳回 badRequest 錯誤,而回報錯誤的原因為 unexpectedParameter

  • 如果播放清單所含的允許項目數量已達上限,playlistItems.insert 方法會傳回錯誤。這項錯誤現在會回報為 forbidden 錯誤,錯誤原因為 playlistContainsMaximumNumberOfVideos

2013 年 4 月 19 日

這次更新的修改如下:

2013 年 3 月 12 日

這次更新的修改如下:

  • 已針對以下資源的 snippet 新增 channelTitle 屬性:

    • activity - 屬性會指定負責該活動的管道名稱。
    • search - 這個屬性會指定與搜尋結果所識別資源相關聯的頻道名稱。
    • video - 這個屬性可指定上傳影片的頻道名稱。

  • search.list 方法支援下列新參數:

    • channelType 參數可讓您限制搜尋頻道以擷取所有頻道,或是只擷取節目。

    • videoType 參數可讓你限制搜尋影片以擷取所有影片,或是只擷取電影或節目集數。

  • 更新 video 資源的 recordingDetails 部分定義,請注意,只有在已設定影片的地理位置資料或錄製時間時,系統才會傳回影片的物件。

  • playlistItems.update 方法現在會傳回 invalidSnippet 錯誤,如果 API 要求未指定有效的程式碼片段,就會傳回此錯誤。

  • 部分 API 方法支援 YouTube 內容合作夥伴專用的新參數。YouTube 內容合作夥伴包括影視工作室、唱片公司,以及其他在 YouTube 上提供內容的內容創作者。

    • onBehalfOfContentOwner 參數代表要求的授權憑證,用於識別 YouTube CMS 使用者,代表在參數值中指定的內容擁有者。用於驗證的 CMS 帳戶,必須連結至指定的 YouTube 內容擁有者。

      這個參數適用於擁有及管理多個不同 YouTube 頻道的內容合作夥伴。有了這個參數,這些合作夥伴只需驗證一次,即可存取所有影片和頻道資料,不必分別提供各個頻道的驗證憑證。

      channels.listsearch.listvideos.deletevideos.listvideos.update 方法都支援這個參數。

    • channels.list 方法支援的 managedByMe 參數會指示 API 傳回 onBehalfOfContentOwner 參數指定內容擁有者擁有的所有頻道。

    • search.list 方法支援的 forContentOwner 參數會指示 API 將搜尋結果限制為僅包含由 onBehalfOfContentOwner 參數指定的內容擁有者所擁有的資源。

2013 年 2 月 25 日

這次更新的修改如下:

  • 這個 API 支援 video 資源的多個新部分和屬性:

    • 新的 fileDetailsprocessingDetailssuggestions 部分會為影片擁有者提供上傳影片的相關資訊。這類資料對於可上傳影片的應用程式非常有用,包含:

      • 處理狀態和進度
      • 處理影片時發生的錯誤或其他問題
      • 縮圖的可用性
      • 改善影片或中繼資料品質的建議
      • 上傳至 YouTube 的原始檔案詳細資料

      只有影片擁有者才能擷取上述所有部分。以下清單簡要說明新部分,video 資源說明文件則定義各部分包含的所有屬性。

      • fileDetails 物件包含上傳至 YouTube 的影片檔案相關資訊,包括檔案的解析度、時間長度、音訊和視訊轉碼器、串流位元率等等。

      • processingProgress 物件含有 YouTube 處理上傳影片檔案的進度相關資訊。物件屬性可識別目前的處理狀態,並預估 YouTube 完成影片處理前的剩餘時間。這個部分也指出影片是否支援不同類型的資料或內容,例如檔案詳細資料或縮圖。

        這個物件旨在調查,讓影片上傳者能追蹤 YouTube 處理上傳影片檔案的進度。

      • suggestions 物件包含建議,可協助您找出改善影片品質或上傳影片中繼資料的機會。

    • contentDetails 部分包含四個新屬性。使用者可在未經驗證的情況下要求擷取這些屬性。

      • dimension:指出影片支援 2D 或 3D 模式。
      • definition:指出影片提供標準或高畫質。
      • caption:指出影片是否可使用字幕。
      • licensedContent:指出影片是否含有已由 YouTube 內容合作夥伴聲明版權的內容。

    • status 部分包含兩個新屬性。影片擁有者在插入或更新影片時,可以設定這兩種屬性的值。也可以透過未經驗證的要求擷取這些屬性。

      • embeddable:指出影片是否可嵌入其他網站。
      • license:指定影片授權。有效值為 creativeCommonyoutube

  • 我們已更新 videos.listvideos.insertvideos.update 方法的 part 參數定義,以列出上述新增的部分,以及不小心省略的 recordingDetails 部分。

  • channel 資源的新 contentDetails.googlePlusUserId 屬性會指定與頻道相關聯的 Google+ 個人資料 ID。這個值可用來產生 Google+ 個人資料的連結。

  • 現在每個縮圖圖片物件都會指定圖片的寬度和高度。縮圖圖片目前會在 activitychannelplaylistplaylistItemsearch resultsubscriptionvideo 資源中傳回。

  • playlistItems.list 現在支援 videoId 參數,可與 playlistId 參數搭配使用,只會擷取代表指定影片的播放清單項目。

    如果播放清單中找不到參數識別的影片,API 會傳回 notFound 錯誤。

  • 錯誤說明文件說明新的 forbidden 錯誤,表示要求未獲適當授權執行所要求的動作。

  • channel 資源的 snippet.channelId 屬性已移除。資源的 id 屬性提供相同的值。

2013 年 1 月 30 日

這次更新的修改如下:

  • 新的「error」頁面會列出 API 可傳回的錯誤。網頁含有可能會用於多種不同 API 方法的一般錯誤,以及特定方法的錯誤。

2013 年 1 月 16 日

這次更新的修改如下:

  • 以下清單中的方法和語言現在提供程式碼範例:

  • activity 資源現在可以回報 channelItem 動作。當 YouTube 在自動產生的 YouTube 頻道中加入影片時,就會發生這種情況。(YouTube 會透過演算法找出在 YouTube 網站上大量曝光的主題,並自動為這些主題產生頻道)。

  • 下列 search.list 參數已更新:

    • q 參數不再指定為篩選器,這表示 ....
    • relatedToVideo 參數已重新命名為 relatedToVideoId
    • published 參數已替換為 publishedAfterpublishedBefore 這兩個新參數,如下所述。

  • search.list 方法支援下列新參數:

    參數名稱 說明
    channelId string 傳回指定頻道建立的資源。
    publishedAfter datetime 傳回在指定時間之後建立的資源。
    publishedBefore datetime 傳回在指定時間之前建立的資源。
    regionCode string 傳回指定國家/地區的資源。
    videoCategoryId string 篩選影片搜尋結果,只納入與指定影片類別相關聯的影片。
    videoEmbeddable string 篩選影片搜尋結果,只納入網頁中內嵌播放器可播放的影片。將參數值設為 true,即可只擷取可嵌入的影片。
    videoSyndicated string 篩選影片搜尋結果,只納入可在 YouTube.com 以外播放的影片。如果將參數值設為 true,即可只擷取聯合發布影片。
  • 有些 API 資源支援新屬性。下表列出資源及其新屬性:

    資源 資源名稱 說明
    activity contentDetails.playlistItem.playlistItemId string YouTube 指派的播放清單項目 ID,用於識別播放清單中的項目。
    activity contentDetails.channelItem object 包含已新增至管道資源相關資訊的物件。只有在 snippet.typechannelItem 時,才會顯示這個屬性。
    activity contentDetails.channelItem.resourceId object 這個物件可以識別加入管道的資源。和其他 resourceId 屬性一樣,其中包含 kind 屬性,用於指定影片或播放清單等資源類型。且含有 videoIdplaylistId 等屬性,是專門用來識別該資源的專屬 ID 之一。
    channel status object 這個物件會封裝頻道隱私權狀態的相關資訊。
    channel status.privacyStatus string 頻道的隱私權狀態。有效值為 privatepublic
    playlist contentDetails object 這個物件包含播放清單內容的中繼資料。
    playlist contentDetails.itemCount unsigned integer 播放清單中的影片數量。
    playlist player object 這個物件包含可在嵌入式播放器中播放播放清單的資訊。
    playlist player.embedHtml string <iframe> 標記,用於嵌入播放播放清單的影片播放器。
    video recordingDetails object 這個物件所包含的資訊,可識別或說明影片錄製時間和地點。
    video recordingDetails.location object 這個物件包含與影片相關聯的地理位置資訊。
    video recordingDetails.location.latitude double 緯度度數,
    video recordingDetails.location.longitude double 經度度數。
    video recordingDetails.location.elevation double 地表的海拔高度 (以公尺為單位)。
    video recordingDetails.locationDescription string 描述影片錄製地點的文字說明。
    video recordingDetails.recordingDate datetime 錄製影片的日期和時間。這個值是以 ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) 格式指定。
  • 數種 API 方法的說明文件,可識別必須在要求主體中指定的屬性,或是根據要求主體中的值進行更新的屬性。下表列出這些方法,以及必要或可修改的屬性。

    注意:其他方法的說明文件可能已列出必要和可修改的屬性。

    方法 屬性
    activities.insert 必要屬性:
    • snippet.description
    可修改的資源:
    • snippet.description
    • contentDetails.bulletin.resourceId
    playlists.update 必要屬性:
    • id
    playlistItems.update 必要屬性:
    • id
    videos.update 必要屬性:
    • id
  • 如果建立更新播放清單與相同頻道中已有的播放清單名稱相同,API 不會再回報 playlistAlreadyExists 錯誤。

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

    方法 錯誤類型 錯誤詳細資料 說明
    guideCategories.list notFound notFound 找不到 id 參數所識別的指南類別。使用 guideCategories.list 方法擷取有效值的清單。
    playlistItems.delete forbidden playlistItemsNotAccessible 這項要求未獲適當授權,無法刪除指定的播放清單項目。
    videoCategories.list notFound videoCategoryNotFound 找不到 id 參數識別的影片類別。使用 videoCategories.list 方法擷取有效值的清單。