YouTube API 服務 - Subject API 服務
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
注意： 遵守 YouTube 開發人員政策提供了指引和範例，協助您確保 API 用戶端遵守 YouTube API 服務條款和政策 (API 服務條款) 的特定部分。這份指南旨在說明 YouTube 如何強制執行 API TOS 的特定部分，但不會取代任何現有文件。
《YouTube API 服務條款》(下稱「條款」第 14 節) 所述：如果 YouTube 打算對 YouTube API 服務進行回溯不相容的變更，YouTube 將公布這些變更，並嘗試在公告發布後的六個月內持續保留軟體程式碼。
本頁列出「條款」第 14.3 節 (「特殊條款」) 中提及的 Subject API 服務，並說明「條款」中的該節對實際淘汰日期的影響。在 2017 年 2 月 10 日 (目前「條款」的生效日期) 之前，「Subject API 服務」會根據之前的「條款」實施一年的廢止政策。為了遵循這項政策，「主題 API 服務」會暫時套用，適用的淘汰規則與其他服務不同。
瞭解淘汰日期
倘若對 Subject API 服務進行回溯不相容的變更，YouTube 將盡合理的努力維護程式碼，直到 2018 年 2 月 10 日 (即本條款生效後的一年) 為止。至於其他服務，YouTube 則會在 6 個月後持續維護軟體程式碼。
豁免資格
「Subject API 服務」的部分功能不受《條款》第 14.3 節定義的規則影響，因為這些功能亦不受「條款」第 14.3 節定義的廢止政策所規範。這些功能列於下方主體服務清單中。
如果豁免項目適用於 object 屬性，則也會套用至該資源的所有子項屬性。此外，這個豁免條件同時適用於擷取、設定、修改或刪除屬性或其子項屬性值的功能，以及屬性值本身。
主體 API 服務
以下各節將定義 Subject API 服務。如需完整資訊，這些章節中也會說明已全面淘汰的 API 服務。而完全淘汰的服務則不在「條款」的涵蓋範圍內。
YouTube Data API 第 3 版
YouTube IFrame 播放器 API
YouTube Reporting API
- 說明文件
-
豁免資格
- 非核心維度。(請參閱維度定義，判斷個別維度是否視為核心維度)。
- 非核心指標。(請參閱指標定義，判斷是否要將個別指標視為核心指標)。
YouTube Analytics API
- 說明文件
-
豁免資格
- 非核心維度。(請參閱維度定義，判斷個別維度是否視為核心維度)。
- 非核心指標。(請參閱指標定義，判斷是否要將個別指標視為核心指標)。
完全淘汰的 API 服務
下列 API 服務已完全淘汰，必須遵守《原始條款》所述的廢止政策，淘汰期也已結束。YouTube 並無義務宣布這些服務的重大異動，也沒有義務繼續提供支援：
YouTube Data API 第 2 版
YouTube Flash Player API
YouTube JavaScript 播放器 API
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-08-21 (世界標準時間)。
[null,null,["上次更新時間：2025-08-21 (世界標準時間)。"],[],["YouTube API services follow a deprecation policy where backward-incompatible changes are announced, and code is maintained for six months. Subject API Services, listed as YouTube Data API v3, IFrame Player API, Reporting API, and Analytics API, have extended maintenance until February 10, 2018, due to prior terms. Exemptions, like specific properties and non-core metrics, exist. Fully deprecated services, such as Data API v2, Flash, and JavaScript Player APIs, are no longer supported.\n"],null,["# YouTube API Services - Subject API Services\n\n**Note:** [Complying with the YouTube Developer Policies](/youtube/terms/developer-policies-guide) provides guidance and examples to help you ensure that your API clients follow specific portions of the YouTube API Services [Terms](/youtube/terms/api-services-terms-of-service) and [Policies](/youtube/terms/developer-policies) (API TOS). The guide offers insight into how YouTube enforces certain aspects of the API TOS, but it does not replace any existing documents.\n\nThe [YouTube API Services Terms of Service](/youtube/terms/api-services-terms-of-service) (the \"Terms\") state (in Section 14) that when YouTube intends to make backward-incompatible changes to YouTube API services, YouTube will announce those changes and try to continue to maintain the software code for six months after the announcement.\n\nThis page identifies the **Subject API Services** referenced in section 14.3 (Special Terms) of the Terms and explains how that section of the Terms affects actual deprecation dates. Prior to February 10, 2017, which is the effective date of the current Terms, the Subject API Services had been subject to a one-year deprecation policy under the previous set of Terms. To honor that policy, the Subject API Services are, temporarily, subject to different deprecation rules than other services.\n\nUnderstanding deprecation dates\n-------------------------------\n\nIn the event of backward-incompatible changes to Subject API Services, YouTube will use reasonable efforts to maintain code until at least February 10, 2018, which is one year after these Terms became effective. For other services, YouTube will try to continue to maintain the software code for six months from the date those changes are announced.\n\n### Exemptions\n\nSome features of Subject API Services are not subject to the rules defined in Section 14.3 of the Terms because those features were also not subject to the deprecation policy defined under the prior set of Terms. Those features are identified as **exemptions** in the list of subject services below.\n\nWhen an exemption applies to an `object` property, it also applies to any of that property's child properties. In addition, the exemption applies to the ability to retrieve, set, modify, or delete values of the property or its child properties as well as to the property values themselves.\n\nSubject API Services\n--------------------\n\nThe following sections define the Subject API Services. For completeness, these sections also identify fully deprecated API services. Those fully deprecated services are not covered under the Terms.\n\n### YouTube Data API, v3\n\n\u003cbr /\u003e\n\n- [Documentation](/youtube/v3)\n- Exemptions\n\n - The following `channel` resource properties:\n - [brandingSettings.channel.profileColor](/youtube/v3/docs/channels#brandingSettings.channel.profileColor)\n - [brandingSettings.hints](/youtube/v3/docs/channels#brandingSettings.hints)\n - [brandingSettings.image.watchIconImageUrl](/youtube/v3/docs/channels#brandingSettings.image.watchIconImageUrl)\n - [brandingSettings.watch](/youtube/v3/docs/channels#brandingSettings.watch)\n - [contentDetails.relatedPlaylists](/youtube/v3/docs/channels#contentDetails.relatedPlaylists)\n - [contentOwnerDetails](/youtube/v3/docs/channels#contentOwnerDetails)\n - [invideoPromotion](/youtube/v3/docs/channels#invideoPromotion)\n - [statistics.commentCount](/youtube/v3/docs/channels#statistics.commentCount)\n - The [guideCategory](/youtube/v3/docs/guideCategories) resource and its methods.\n - The `search.list` method's [safeSearch](/youtube/v3/docs/search/list#safeSearch) parameter and its values.\n - The `video` resource's [status.publishAt](/youtube/v3/docs/videos#status.publishAt) property.\n\n\u003cbr /\u003e\n\n### YouTube IFrame Player API\n\n\u003cbr /\u003e\n\n- [Documentation](/youtube/iframe_api_reference)\n\n\u003cbr /\u003e\n\n### YouTube Reporting API\n\n\u003cbr /\u003e\n\n- [Documentation](/youtube/reporting)\n- Exemptions\n\n - Non-core dimensions. (See the [dimension](/youtube/reporting/v1/reports/dimensions) definitions to determine whether individual dimensions are considered core dimensions.)\n - Non-core metrics. (See the [metric](/youtube/reporting/v1/reports/metrics) definitions to determine whether individual metrics are considered core metrics.)\n\n\u003cbr /\u003e\n\n### YouTube Analytics API\n\n\u003cbr /\u003e\n\n- [Documentation](/youtube/analytics)\n- Exemptions\n\n - Non-core dimensions. (See the [dimension](/youtube/analytics/v1/dimsmets/dims) definitions to determine whether individual dimensions are considered core dimensions.)\n - Non-core metrics. (See the [metric](/youtube/analytics/v1/dimsmets/mets) definitions to determine whether individual metrics are considered core metrics.)\n\n\u003cbr /\u003e\n\nFully deprecated API Services\n-----------------------------\n\nThe following API services are fully deprecated. They were subject to the deprecation policy set forth in the Original Terms and the deprecation period has ended. YouTube is neither obligated to announce breaking changes to these services nor to continue supporting them:\n\n### YouTube Data API, v2\n\n\u003cbr /\u003e\n\n- [Deprecation announcement](http://youtube-eng.blogspot.com/2014/03/committing-to-youtube-data-api-v3_4.html) (March 4, 2014)\n- [Documentation](/youtube/2.0/developers_guide_protocol)\n- Migration path: [YouTube Data API, v3](/youtube/v3/getting-started)\n\n\u003cbr /\u003e\n\n### YouTube Flash Player API\n\n\u003cbr /\u003e\n\n- [Deprecation announcement](http://youtube-eng.blogspot.com/2015/01/youtube-now-defaults-to-html5_27.html) (January 27, 2015)\n- Migration path: [IFrame Player API](/youtube/iframe_api_reference)\n\n\u003cbr /\u003e\n\n### YouTube JavaScript Player API\n\n\u003cbr /\u003e\n\n- [Deprecation announcement](http://youtube-eng.blogspot.com/2015/01/youtube-now-defaults-to-html5_27.html) (January 27, 2015)\n- Migration path: [IFrame Player API](/youtube/iframe_api_reference)\n\n\u003cbr /\u003e"]]
