API-сервисы YouTube — API-сервисы субъекта
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Примечание. В разделе «Политики разработчиков YouTube» представлены рекомендации и примеры, которые помогут вам убедиться, что ваши клиенты API следуют определенным частям Условий и правил использования API-сервисов YouTube (API TOS). Руководство дает представление о том, как YouTube обеспечивает соблюдение определенных аспектов API TOS, но не заменяет какие-либо существующие документы.
В Условиях обслуживания API-сервисов YouTube («Условия») говорится (в разделе 14), что, когда YouTube намерен внести обратно несовместимые изменения в API-сервисы YouTube, YouTube объявит об этих изменениях и попытается продолжать поддерживать программный код в течение шести месяцев после объявления.
На этой странице указаны Тематические API-сервисы, упомянутые в разделе 14.3 (Особые условия) Условий, и объясняется, как этот раздел Условий влияет на фактические даты прекращения поддержки. До 10 февраля 2017 г., даты вступления в силу текущих Условий, в отношении Субъектных API-сервисов действовала политика прекращения поддержки сроком на один год в соответствии с предыдущим набором Условий. В целях соблюдения этой политики к Субъектным API-службам временно применяются иные правила прекращения поддержки, чем к другим службам.
Даты прекращения поддержки
В случае внесения обратно несовместимых изменений в тематические API-сервисы YouTube приложит разумные усилия для поддержания кода как минимум до 10 февраля 2018 г., то есть через год после вступления в силу настоящих Условий. Что касается других сервисов, YouTube постарается продолжать поддерживать код программного обеспечения в течение шести месяцев с даты объявления об этих изменениях.
Исключения
Некоторые функции Субъектных API-сервисов не подпадают под действие правил, определенных в разделе 14.3 Условий, поскольку на эти функции также не распространяется политика прекращения поддержки, определенная в предыдущем наборе Условий. Эти функции обозначены как исключения в списке подлежащих услуг ниже.
Когда исключение применяется к свойству object
, оно также применяется к любому из дочерних свойств этого свойства. Кроме того, исключение распространяется на возможность получать, устанавливать, изменять или удалять значения свойства или его дочерних свойств, а также на сами значения свойств.
Тематические API-сервисы
В следующих разделах определяются субъектные службы API. Для полноты информации в этих разделах также указаны полностью устаревшие службы API. Эти полностью устаревшие услуги не подпадают под действие Условий.
API данных YouTube, версия 3
API проигрывателя IFrame YouTube
API отчетов YouTube
- Документация
Исключения
- Неосновные размеры. (См. определения размеров , чтобы определить, считаются ли отдельные измерения основными измерениями.)
- Непрофильные метрики. (См. определения метрик , чтобы определить, считаются ли отдельные метрики основными метриками.)
API YouTube Аналитики
- Документация
Исключения
- Неосновные размеры. (См. определения размеров , чтобы определить, считаются ли отдельные измерения основными измерениями.)
- Непрофильные метрики. (См. определения метрик , чтобы определить, считаются ли отдельные метрики основными метриками.)
Полностью устаревшие службы API
Следующие службы API полностью устарели. На них распространяется политика прекращения поддержки, изложенная в Исходных условиях, и период прекращения поддержки закончился. YouTube не обязан объявлять о критических изменениях в этих сервисах или продолжать их поддерживать:
API данных YouTube, версия 2
API YouTube Flash Player
API YouTube JavaScript-плеера
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-08-21 UTC.
[[["Прост для понимания","easyToUnderstand","thumb-up"],["Помог мне решить мою проблему","solvedMyProblem","thumb-up"],["Другое","otherUp","thumb-up"]],[["Отсутствует нужная мне информация","missingTheInformationINeed","thumb-down"],["Слишком сложен/слишком много шагов","tooComplicatedTooManySteps","thumb-down"],["Устарел","outOfDate","thumb-down"],["Проблема с переводом текста","translationIssue","thumb-down"],["Проблемы образцов/кода","samplesCodeIssue","thumb-down"],["Другое","otherDown","thumb-down"]],["Последнее обновление: 2025-08-21 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"],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"]]