**Note:** [Complying with the YouTube Developer Policies](https://developers.google.com/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](https://developers.google.com/youtube/terms/api-services-terms-of-service) and [Policies](https://developers.google.com/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.

The [YouTube API Services Terms of
Service](https://developers.google.com/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.

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 following list of subject services.

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](https://developers.google.com/youtube/v3)

- Exemptions

  - The following `channel` resource properties:

  - [`brandingSettings.channel.profileColor`](https://developers.google.com/youtube/v3/docs/channels#brandingSettings.channel.profileColor)

  - [`brandingSettings.hints`](https://developers.google.com/youtube/v3/docs/channels#brandingSettings.hints)

  - [`brandingSettings.image.watchIconImageUrl`](https://developers.google.com/youtube/v3/docs/channels#brandingSettings.image.watchIconImageUrl)

  - [`brandingSettings.watch`](https://developers.google.com/youtube/v3/docs/channels#brandingSettings.watch)

  - [`contentDetails.relatedPlaylists`](https://developers.google.com/youtube/v3/docs/channels#contentDetails.relatedPlaylists)

  - [`contentOwnerDetails`](https://developers.google.com/youtube/v3/docs/channels#contentOwnerDetails)

  - [`invideoPromotion`](https://developers.google.com/youtube/v3/docs/channels#invideoPromotion)

  - [`statistics.commentCount`](https://developers.google.com/youtube/v3/docs/channels#statistics.commentCount)

  - The [`guideCategory`](https://developers.google.com/youtube/v3/docs/guideCategories) resource and its
    methods.

  - The `search.list` method's
    [`safeSearch`](https://developers.google.com/youtube/v3/docs/search/list#safeSearch) parameter and its
    values.

  - The `video` resource's
    [`status.publishAt`](https://developers.google.com/youtube/v3/docs/videos#status.publishAt) property.

### YouTube IFrame Player API

- [Documentation](https://developers.google.com/youtube/iframe_api_reference)

### YouTube Reporting API

- [Documentation](https://developers.google.com/youtube/reporting)

- Exemptions

  - Non-core dimensions. (See the [dimension](https://developers.google.com/youtube/reporting/v1/reports/dimensions) definitions to determine whether individual dimensions are considered core dimensions.)
  - Non-core metrics. (See the [metric](https://developers.google.com/youtube/reporting/v1/reports/metrics) definitions to determine whether individual metrics are considered core metrics.)

### YouTube Analytics API

- [Documentation](https://developers.google.com/youtube/analytics)

- Exemptions

  - Non-core dimensions. (See the [dimension](https://developers.google.com/youtube/analytics/v1/dimsmets/dims) definitions to determine whether individual dimensions are considered core dimensions.)
  - Non-core metrics. (See the [metric](https://developers.google.com/youtube/analytics/v1/dimsmets/mets) 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](http://youtube-eng.blogspot.com/2014/03/committing-to-youtube-data-api-v3_4.html) (March 4, 2014)
- [Documentation](https://developers.google.com/youtube/2.0/developers_guide_protocol)
- Migration path: [YouTube Data API, v3](https://developers.google.com/youtube/v3/getting-started)

### YouTube Flash Player API

- [Deprecation
  announcement](http://youtube-eng.blogspot.com/2015/01/youtube-now-defaults-to-html5_27.html) (January 27, 2015)
- Migration path: [IFrame Player API](https://developers.google.com/youtube/iframe_api_reference)

### YouTube JavaScript Player API

- [Deprecation
  announcement](http://youtube-eng.blogspot.com/2015/01/youtube-now-defaults-to-html5_27.html) (January 27, 2015)
- Migration path: [IFrame Player API](https://developers.google.com/youtube/iframe_api_reference)