YouTube API Services - Subject API Services  |  Google for Developers
Skip to main content
YouTube
/
English
Deutsch
Español
Español – América Latina
Français
Indonesia
Italiano
Polski
Português – Brasil
Tiếng Việt
Türkçe
Русский
עברית
العربيّة
فارسی
हिंदी
বাংলা
ภาษาไทย
中文 – 简体
中文 – 繁體
日本語
한국어
Sign in
Home
Guides
Samples
Terms
YouTube
Home
Guides
Samples
Terms
YouTube API Services Terms of Service
Terms of Service (Americas)
Terms of Service (APAC)
Terms of Service (EMEA)
Terms of Service (Russia)
Developer Policies
Required Minimum Functionality
Subject API Services
Branding Guidelines
Revision History
Guides
Complying with the YouTube's Developer Policies
Home
Products
YouTube
Terms
YouTube API Services - Subject API Services
Stay organized with collections
Save and categorize content based on your preferences.
Note: Complying with the YouTube Developer Policies provides guidance and examples to help you ensure that your API clients follow specific portions of the YouTube API Services Terms and 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.
The YouTube 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.
This 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.
Understanding deprecation dates
In 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.
Exemptions
Some 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.
When 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.
Subject API Services
The 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.
YouTube Data API, v3
Documentation
Exemptions
The following channel resource properties:
brandingSettings.channel.profileColor
brandingSettings.hints
brandingSettings.image.watchIconImageUrl
brandingSettings.watch
contentDetails.relatedPlaylists
contentOwnerDetails
invideoPromotion
statistics.commentCount
The guideCategory resource and its methods.
The search.list method's safeSearch parameter and its values.
The video resource's status.publishAt property.
YouTube IFrame Player API
Documentation
YouTube Reporting API
Documentation
Exemptions
Non-core dimensions. (See the dimension definitions to determine whether individual dimensions are considered core dimensions.)
Non-core metrics. (See the metric definitions to determine whether individual metrics are considered core metrics.)
YouTube Analytics API
Documentation
Exemptions
Non-core dimensions. (See the dimension definitions to determine whether individual dimensions are considered core dimensions.)
Non-core metrics. (See the metric definitions to determine whether individual metrics are considered core metrics.)
Fully deprecated API Services
The 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:
YouTube Data API, v2
Deprecation announcement (March 4, 2014)
Documentation
Migration path: YouTube Data API, v3
YouTube Flash Player API
Deprecation announcement (January 27, 2015)
Migration path: IFrame Player API
YouTube JavaScript Player API
Deprecation announcement (January 27, 2015)
Migration path: IFrame Player API
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-04-28 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2026-04-28 UTC."],[],["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"]]
Blog
The latest news on the YouTube blog
GitHub
Find API code samples and other YouTube open-source projects.
Issue Tracker
Something wrong? Send us a bug report!
Stack Overflow
Ask a question under the youtube-api tag
YouTube Researcher Program
For researchers interested in using data from YouTube’s global API
Tools
Google APIs Explorer
YouTube Player Demo
Configure a Subscribe Button
Issue Tracker
File a bug
Request a feature
See open issues
Product Info
Terms of Service
Developer Policies
Required Minimum Functionality
Branding Guidelines
Android
Chrome
Firebase
Google Cloud Platform
Google AI
All products
Terms
Privacy
Manage cookies
English
Deutsch
Español
Español – América Latina
Français
Indonesia
Italiano
Polski
Português – Brasil
Tiếng Việt
Türkçe
Русский
עברית
العربيّة
فارسی
हिंदी
বাংলা
ภาษาไทย
中文 – 简体
中文 – 繁體
日本語
한국어