Services d'API YouTube – Services d'API de l'objet
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Remarque:Respecter le Règlement pour les développeurs YouTube fournit des conseils et des exemples qui vous aideront à vous assurer que vos clients API respectent certaines sections spécifiques des Conditions d'utilisation et des Règles (Conditions d'utilisation des API) des services d'API YouTube. Ce guide explique comment YouTube applique certains aspects des conditions d'utilisation des API, mais il ne remplace aucun des documents existants.
Les Conditions d'utilisation des services d'API YouTube (les "Conditions") stipulent (à la section 14) que si YouTube prévoit d'apporter des modifications incompatibles avec les versions antérieures aux services d'API YouTube, YouTube annoncera ces modifications et s'efforcera de conserver le code logiciel pendant six mois à compter de l'annonce.
Cette page identifie les Services d'API Objet référencés dans la section 14.3 (Conditions spéciales) des Conditions d'utilisation et explique en quoi cette section affecte les dates d'abandon effectives. Avant le 10 février 2017, date d'entrée en vigueur des Conditions actuelles, les Services de l'API Sujet étaient soumis à un règlement d'abandon d'un an conformément aux Conditions d'utilisation précédentes. Afin de respecter ce règlement, les Services d'API concernés sont temporairement soumis à des règles d'abandon différentes de celles des autres services.
Comprendre les dates d'abandon
En cas de modifications rétrocompatibles des services de l'API Objet, YouTube déploiera des efforts raisonnables pour conserver le code jusqu'au 10 février 2018 au moins, soit un an après l'entrée en vigueur des présentes Conditions. Pour les autres services, YouTube s'efforcera de conserver le code logiciel pendant six mois à compter de la date de l'annonce de ces changements.
Exceptions
Certaines fonctionnalités des Services de l'API Sujet ne sont pas soumises aux règles définies dans la Section 14.3 des Conditions, car elles n'étaient pas non plus soumises au règlement d'obsolescence défini dans l'ensemble des Conditions d'utilisation précédente. Ces fonctionnalités sont identifiées en tant qu'exceptions dans la liste des services concernés ci-dessous.
Lorsqu'une exception s'applique à une propriété object, elle s'applique également à toutes ses propriétés enfants. En outre, l'exemption s'applique à la possibilité de récupérer, définir, modifier ou supprimer des valeurs de la propriété ou de ses propriétés enfants, ainsi qu'aux valeurs des propriétés elles-mêmes.
Services d'API de l'objet
Les sections suivantes définissent les services de l'API Subject. Par souci d'exhaustivité, ces sections identifient également les services d'API complètement obsolètes. Ces services entièrement obsolètes ne sont pas couverts par les présentes Conditions d'utilisation.
API YouTube Data, version 3
API YouTube IFrame Player
API de création de rapports YouTube
- Documentation
-
Exceptions
- Dimensions secondaires. Consultez les définitions des dimensions pour déterminer si des dimensions individuelles sont considérées comme des dimensions principales.
- Métriques secondaires. Consultez les définitions des métriques pour déterminer si des métriques individuelles sont considérées comme des métriques principales.
L'API YouTube Analytics
- Documentation
-
Exceptions
- Dimensions secondaires. Consultez les définitions des dimensions pour déterminer si des dimensions individuelles sont considérées comme des dimensions principales.
- Métriques secondaires. Consultez les définitions des métriques pour déterminer si des métriques individuelles sont considérées comme des métriques principales.
Services d'API complètement obsolètes
Les services d'API suivants sont entièrement obsolètes. Ils étaient soumis au règlement relatif aux abandons défini dans les Conditions d'utilisation d'origine et la période d'abandon est terminée. YouTube n'est pas tenu d'annoncer les modifications destructives apportées à ces services ni de continuer à les soutenir:
API YouTube Data, version 2
API YouTube Flash Player
API YouTube JavaScript Player
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/21 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 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"]]
