YouTube API 服务 - Subject API 服务
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
注意:遵守 YouTube 开发者政策提供了一些指导和示例,可帮助您确保 API 客户端遵守 YouTube API 服务条款和政策 (API TOS) 的特定部分。本指南深入介绍了 YouTube 如何执行《API 服务条款》的特定方面,但并未取代任何现有文档。
YouTube API 服务的服务条款(以下简称“条款”)规定(参见第 14 条),如果 YouTube 打算对 YouTube API 服务做出不向后兼容的更改,YouTube 会公布这些更改,并力求在公告发布后的六个月内继续维护软件代码。
本页列出了条款第 14.3 条(“特殊条款”)中提及的主题 API 服务,并说明了条款的这一部分对实际弃用日期的影响。在 2017 年 2 月 10 日(即当前条款的生效日期)之前,根据之前的一套条款,Subject API 服务须遵守为期一年的弃用政策。为了遵守该政策,Subject API 服务暂时会受到与其他服务不同的弃用规则的约束。
了解弃用日期
如果对 Subject API 服务的更改不向后兼容,YouTube 会尽合理的努力在 2018 年 2 月 10 日(即本条款生效后一年)前维护代码。对于其他服务,YouTube 会尝试继续维护软件代码,期限为自这些更改公布之日起的六个月。
豁免
Subject API 服务的某些功能也不受本条款第 14.3 条规定的规则约束,因为这些功能也不受前一组条款规定的弃用政策的约束。在下面的主题服务列表中,这些功能被列为豁免。
当豁免应用于 object
属性时,它也会应用于该属性的任何子属性。此外,这个例外规则还适用于检索、设置、修改或删除属性值或其子属性的值的功能,以及属性值本身。
Subject API 服务
以下几部分介绍了主题 API 服务。为完整起见,这些部分还列出了已完全弃用的 API 服务。这些完全弃用的服务不在本条款的涵盖范围内。
YouTube Data API 版本 3
YouTube iframe Player API
YouTube Reporting API
- 文档
-
豁免
- 非核心维度。(要确定单个维度是否会被视为核心维度,请参阅维度定义。)
- 非核心指标。(请参阅指标定义,确定各个指标是否会被视为核心指标。)
YouTube Analytics API
- 文档
-
豁免
- 非核心维度。(要确定单个维度是否会被视为核心维度,请参阅维度定义。)
- 非核心指标。(请参阅指标定义,确定各个指标是否会被视为核心指标。)
已完全弃用的 API 服务
以下 API 服务已完全弃用。它们受原始条款中规定的弃用政策约束,并且弃用期已结束。YouTube 没有义务宣布对这些服务的破坏性更改,也没有义务继续为这些服务提供支持:
YouTube Data API 版本 2
YouTube Flash Player API
YouTube JavaScript 播放器 API
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-21。
[null,null,["最后更新时间 (UTC):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"]]