CINXE.COM

YouTube API Services - Subject API Services  |  Google Developers

<!doctype html> <html lang="en" dir="ltr"> <head><script type="text/javascript" src="https://web-static.archive.org/_static/js/bundle-playback.js?v=7YQSqjSh" charset="utf-8"></script> <script type="text/javascript" src="https://web-static.archive.org/_static/js/wombat.js?v=txqj7nKC" charset="utf-8"></script> <script>window.RufflePlayer=window.RufflePlayer||{};window.RufflePlayer.config={"autoplay":"on","unmuteOverlay":"hidden"};</script> <script type="text/javascript" src="https://web-static.archive.org/_static/js/ruffle/ruffle.js"></script> <script type="text/javascript"> __wm.init("https://web.archive.org/web"); __wm.wombat("https://developers.google.com/youtube/terms/subject-api-services","20210520144438","https://web.archive.org/","web","https://web-static.archive.org/_static/", "1621521878"); </script> <link rel="stylesheet" type="text/css" href="https://web-static.archive.org/_static/css/banner-styles.css?v=p7PEIJWi" /> <link rel="stylesheet" type="text/css" href="https://web-static.archive.org/_static/css/iconochive.css?v=3PDvdIFv" /> <!-- End Wayback Rewrite JS Include --> <meta name="google-signin-client-id" content="721724668570-nbkv1cfusk7kk4eni4pjvepaus73b13t.apps.googleusercontent.com"> <meta name="google-signin-scope" content="profile email https://www.googleapis.com/auth/developerprofiles https://www.googleapis.com/auth/developerprofiles.award"> <meta property="og:site_name" content="Google Developers"> <meta property="og:type" content="website"><meta name="theme-color" content="#ff0000"><meta charset="utf-8"> <meta content="IE=Edge" http-equiv="X-UA-Compatible"> <meta name="viewport" content="width=device-width, initial-scale=1"> <link rel="manifest" href="/web/20210520144438/https://developers.google.com/_pwa/developers/manifest.json" crossorigin="use-credentials"> <link rel="preconnect" href="//web.archive.org/web/20210520144438/https://www.gstatic.com/" crossorigin> <link rel="preconnect" href="//web.archive.org/web/20210520144438/https://fonts.gstatic.com/" crossorigin> <link rel="preconnect" href="//web.archive.org/web/20210520144438/https://fonts.googleapis.com/" crossorigin> <link rel="preconnect" href="//web.archive.org/web/20210520144438/https://apis.google.com/" crossorigin> <link rel="preconnect" href="//web.archive.org/web/20210520144438/https://www.google-analytics.com/" crossorigin><link rel="stylesheet" href="//web.archive.org/web/20210520144438cs_/https://fonts.googleapis.com/css?family=Google+Sans:400,500|Roboto:400,400italic,500,500italic,700,700italic|Roboto+Mono:400,500,700|Material+Icons&amp;display=swap"><link rel="stylesheet" href="https://web.archive.org/web/20210520144438cs_/https://www.gstatic.com/devrel-devsite/prod/v1674d466be3b1154327dd11cf186e748303b1e92ae31ff35df0f5192fbd777ea/developers/css/app.css"><link rel="shortcut icon" href="https://web.archive.org/web/20210520144438im_/https://www.gstatic.com/devrel-devsite/prod/v1674d466be3b1154327dd11cf186e748303b1e92ae31ff35df0f5192fbd777ea/developers/images/favicon.png"> <link rel="apple-touch-icon" href="https://web.archive.org/web/20210520144438im_/https://www.gstatic.com/devrel-devsite/prod/v1674d466be3b1154327dd11cf186e748303b1e92ae31ff35df0f5192fbd777ea/developers/images/touchicon-180.png"><link rel="canonical" href="https://web.archive.org/web/20210520144438/https://developers.google.com/youtube/terms/subject-api-services"><link rel="search" type="application/opensearchdescription+xml" title="Google Developers" href="https://web.archive.org/web/20210520144438/https://developers.google.com/s/opensearch.xml"> <title>YouTube API Services - Subject API Services &nbsp;|&nbsp; Google Developers</title> <meta property="og:title" content="YouTube API Services - Subject API Services  |  Google Developers"><meta property="og:url" content="https://web.archive.org/web/20210520144438/https://developers.google.com/youtube/terms/subject-api-services"><meta property="og:image" content="https://web.archive.org/web/20210520144438im_/https://www.gstatic.com/devrel-devsite/prod/v1674d466be3b1154327dd11cf186e748303b1e92ae31ff35df0f5192fbd777ea/developers/images/opengraph/youtube-theme.png"> <meta property="og:image:width" content="1200"> <meta property="og:image:height" content="675"><meta property="og:locale" content="en"><meta name="twitter:card" content="summary_large_image"><script type="application/ld+json"> { "@context": "https://web.archive.org/web/20210520144438/https://schema.org", "@type": "BreadcrumbList", "itemListElement": [{ "@type": "ListItem", "position": 1, "name": "YouTube", "item": "https://web.archive.org/web/20210520144438/https://developers.google.com/youtube" },{ "@type": "ListItem", "position": 2, "name": "YouTube API Services - Subject API Services", "item": "https://web.archive.org/web/20210520144438/https://developers.google.com/youtube/terms/subject-api-services" }] } </script> </head> <body class="" template="page" theme="youtube-theme" type="article" layout="docs" pending> <devsite-progress type="indeterminate" id="app-progress"></devsite-progress> <section class="devsite-wrapper"><devsite-header> <div class="devsite-header--inner nocontent"> <div class="devsite-top-logo-row-wrapper-wrapper"> <div class="devsite-top-logo-row-wrapper"> <div class="devsite-top-logo-row"> <button type="button" id="devsite-hamburger-menu" class="devsite-header-icon-button button-flat material-icons gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Navigation menu button" visually-hidden aria-label="Open menu"> </button> <div class="devsite-product-name-wrapper"> <a href="https://web.archive.org/web/20210520144438/https://developers.google.com/youtube"> <div class="devsite-product-logo-container" size="medium"> <img class="devsite-product-logo" alt="YouTube" src="https://web.archive.org/web/20210520144438im_/https://developers.google.com/site-assets/logo-youtube.svg" srcset="" sizes="64px" loading="lazy"> </div> </a> <span class="devsite-product-name"> <ul class="devsite-breadcrumb-list"> <li class="devsite-breadcrumb-item "> <a href="https://web.archive.org/web/20210520144438/https://developers.google.com/youtube" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Upper Header" data-value="1" track-type="globalNav" track-name="breadcrumb" track-metadata-position="1" track-metadata-eventdetail="YouTube"> YouTube </a> </li> </ul> </span> </div> <div class="devsite-top-logo-row-middle"> <div class="devsite-header-upper-tabs"> </div> <devsite-search aria-expanded="false" aria-haspopup="listbox" enable-signin enable-search enable-suggestions enable-query-completion project-name="YouTube" tenant-name="Google Developers" project-scope="/youtube" url-scoped="https://developers.google.com/s/results/youtube" role="combobox"> <form class="devsite-search-form" action="https://web.archive.org/web/20210520144438/https://developers.google.com/s/results" method="GET"> <div class="devsite-search-container"> <div class="devsite-searchbox"> <input aria-activedescendant="" aria-autocomplete="list" aria-label="Search" aria-haspopup="false" aria-multiline="false" aria-label="Search box" autocomplete="off" class="devsite-search-field devsite-search-query" name="q" placeholder="Search" role="combobox" type="text" value=""> <div class="devsite-search-image material-icons" aria-hidden="true"></div> </div> <button type="button" search-open class="devsite-search-button devsite-header-icon-button button-flat material-icons" aria-label="Open search"></button> </div> </form> <button type="button" search-close class="devsite-search-button devsite-header-icon-button button-flat material-icons" aria-label="Close search"></button> </devsite-search> </div> <devsite-language-selector> <devsite-select class="devsite-language-selector-menu"> <select aria-label="Select your language preference." class="devsite-language-selector-select" name="language" track-name="click" track-type="languageSelector"> <option>Language</option> <option value="en" lang="en" track-metadata-original-language="en" track-metadata-selected-language="en" track-name="changed" track-type="languageSelector"> English </option> <option value="id" lang="id" track-metadata-original-language="en" track-metadata-selected-language="id" track-name="changed" track-type="languageSelector"> Bahasa Indonesia </option> <option value="de" lang="de" track-metadata-original-language="en" track-metadata-selected-language="de" track-name="changed" track-type="languageSelector"> Deutsch </option> <option value="es" lang="es" track-metadata-original-language="en" track-metadata-selected-language="es" track-name="changed" track-type="languageSelector"> Español </option> <option value="fr" lang="fr" track-metadata-original-language="en" track-metadata-selected-language="fr" track-name="changed" track-type="languageSelector"> Français </option> <option value="pt_br" lang="pt_br" track-metadata-original-language="en" track-metadata-selected-language="pt_br" track-name="changed" track-type="languageSelector"> Português – Brasil </option> <option value="ru" lang="ru" track-metadata-original-language="en" track-metadata-selected-language="ru" track-name="changed" track-type="languageSelector"> Русский </option> <option value="zh_cn" lang="zh_cn" track-metadata-original-language="en" track-metadata-selected-language="zh_cn" track-name="changed" track-type="languageSelector"> 中文 – 简体 </option> <option value="ja" lang="ja" track-metadata-original-language="en" track-metadata-selected-language="ja" track-name="changed" track-type="languageSelector"> 日本語 </option> <option value="ko" lang="ko" track-metadata-original-language="en" track-metadata-selected-language="ko" track-name="changed" track-type="languageSelector"> 한국어 </option> </select> </devsite-select> </devsite-language-selector> <devsite-user enable-profiles fp-auth id="devsite-user"></devsite-user> </div> </div> </div> <div class="devsite-collapsible-section "> <div class="devsite-header-background"> <div class="devsite-doc-set-nav-row"> <devsite-tabs class="lower-tabs"> <nav class="devsite-tabs-wrapper" aria-label="Lower tabs"> <tab> <a href="https://web.archive.org/web/20210520144438/https://developers.google.com/youtube" class="gc-analytics-event " track-type="globalNav" track-metadata-position="nav" track-metadata-eventdetail="nav" track-name="home" data-category="Site-Wide Custom Events" data-label="Tab: Home"> Home </a> </tab> <tab> <a href="https://web.archive.org/web/20210520144438/https://developers.google.com/youtube/documentation" class="gc-analytics-event " track-type="globalNav" track-metadata-position="nav" track-metadata-eventdetail="nav" track-name="guides" data-category="Site-Wide Custom Events" data-label="Tab: Guides"> Guides </a> </tab> <tab> <a href="https://web.archive.org/web/20210520144438/https://developers.google.com/youtube/code_samples" class="gc-analytics-event " track-type="globalNav" track-metadata-position="nav" track-metadata-eventdetail="nav" track-name="samples" data-category="Site-Wide Custom Events" data-label="Tab: Samples"> Samples </a> </tab> <tab active> <a href="https://web.archive.org/web/20210520144438/https://developers.google.com/youtube/terms/api-services-terms-of-service" class="gc-analytics-event " track-type="globalNav" track-metadata-position="nav" track-metadata-eventdetail="nav" track-name="terms" aria-label="Terms, selected" data-category="Site-Wide Custom Events" data-label="Tab: Terms"> Terms </a> </tab> </nav> </devsite-tabs> </div> </div> </div> </div> </devsite-header> <devsite-book-nav scrollbars> <nav class="devsite-book-nav devsite-nav nocontent" aria-label="Side menu"> <div class="devsite-mobile-header"> <button type="button" id="devsite-close-nav" class="devsite-header-icon-button button-flat material-icons gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Close navigation" aria-label="Close navigation"> </button> <div class="devsite-product-name-wrapper"> <a href="https://web.archive.org/web/20210520144438/https://developers.google.com/youtube"> <div class="devsite-product-logo-container" size="medium"> <img class="devsite-product-logo" alt="YouTube" src="https://web.archive.org/web/20210520144438im_/https://developers.google.com/site-assets/logo-youtube.svg" srcset="" sizes="64px" loading="lazy"> </div> </a> <span class="devsite-product-name"> <ul class="devsite-breadcrumb-list"> <li class="devsite-breadcrumb-item "> <a href="https://web.archive.org/web/20210520144438/https://developers.google.com/youtube" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Upper Header" data-value="1" track-type="globalNav" track-name="breadcrumb" track-metadata-position="1" track-metadata-eventdetail="YouTube"> YouTube </a> </li> </ul> </span> </div> </div> <div class="devsite-book-nav-wrapper"> <div class="devsite-mobile-nav-top"> <ul class="devsite-nav-list"> <li class="devsite-nav-item"> <a href="/web/20210520144438/https://developers.google.com/youtube" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Home" track-type="navMenu" track-metadata-eventdetail="globalMenu" track-metadata-position="nav" track-name="home"> <span class="devsite-nav-text" tooltip> Home </span> </a> </li> <li class="devsite-nav-item"> <a href="/web/20210520144438/https://developers.google.com/youtube/documentation" class="devsite-nav-title gc-analytics-event devsite-nav-has-children " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Guides" track-type="navMenu" track-metadata-eventdetail="globalMenu" track-metadata-position="nav" track-name="guides"> <span class="devsite-nav-text" tooltip> Guides </span> <span class="devsite-nav-icon material-icons" data-icon="forward"> </span> </a> </li> <li class="devsite-nav-item"> <a href="/web/20210520144438/https://developers.google.com/youtube/code_samples" class="devsite-nav-title gc-analytics-event devsite-nav-has-children " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Samples" track-type="navMenu" track-metadata-eventdetail="globalMenu" track-metadata-position="nav" track-name="samples"> <span class="devsite-nav-text" tooltip> Samples </span> <span class="devsite-nav-icon material-icons" data-icon="forward"> </span> </a> </li> <li class="devsite-nav-item"> <a href="/web/20210520144438/https://developers.google.com/youtube/terms/api-services-terms-of-service" class="devsite-nav-title gc-analytics-event devsite-nav-has-children devsite-nav-active" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Terms" track-type="navMenu" track-metadata-eventdetail="globalMenu" track-metadata-position="nav" track-name="terms"> <span class="devsite-nav-text" tooltip> Terms </span> <span class="devsite-nav-icon material-icons" data-icon="forward"> </span> </a> </li> </ul> </div> <div class="devsite-mobile-nav-bottom" role="navigation"> <ul class="devsite-nav-list" menu="_book"> <li class="devsite-nav-item devsite-nav-heading"><div class="devsite-nav-title devsite-nav-title-no-path"><span class="devsite-nav-text" tooltip>YouTube API Services Terms of Service</span></div></li> <li class="devsite-nav-item"><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"><span class="devsite-nav-text" tooltip></span></div></li> <li class="devsite-nav-item"><a href="/web/20210520144438/https://developers.google.com/youtube/terms/api-services-terms-of-service" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Terms of Service (Americas)</span></a></li> <li class="devsite-nav-item"><a href="/web/20210520144438/https://developers.google.com/youtube/terms/api-services-terms-of-service-apac" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Terms of Service (APAC)</span></a></li> <li class="devsite-nav-item"><a href="/web/20210520144438/https://developers.google.com/youtube/terms/api-services-terms-of-service-emea" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Terms of Service (EMEA)</span></a></li> <li class="devsite-nav-item"><a href="/web/20210520144438/https://developers.google.com/youtube/terms/api-services-terms-of-service-ru" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Terms of Service (Russia)</span></a></li> <li class="devsite-nav-item"><a href="/web/20210520144438/https://developers.google.com/youtube/terms/developer-policies" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Developer Policies</span></a></li> <li class="devsite-nav-item"><a href="/web/20210520144438/https://developers.google.com/youtube/terms/required-minimum-functionality" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Required Minimum Functionality</span></a></li> <li class="devsite-nav-item"><a href="/web/20210520144438/https://developers.google.com/youtube/terms/subject-api-services" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Subject API Services</span></a></li> <li class="devsite-nav-item"><a href="/web/20210520144438/https://developers.google.com/youtube/terms/branding-guidelines" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Branding Guidelines</span></a></li> <li class="devsite-nav-item"><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"><span class="devsite-nav-text" tooltip></span></div></li> <li class="devsite-nav-item"><a href="/web/20210520144438/https://developers.google.com/youtube/terms/revision-history" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Revision History</span></a></li> <li class="devsite-nav-item devsite-nav-heading"><div class="devsite-nav-title devsite-nav-title-no-path"><span class="devsite-nav-text" tooltip>Guides</span></div></li> <li class="devsite-nav-item"><a href="/web/20210520144438/https://developers.google.com/youtube/terms/developer-policies-guide" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Complying with the YouTube Developer Policies</span></a></li> </ul> </div> </div> </nav> </devsite-book-nav> <section id="gc-wrapper"> <main role="main" class="devsite-main-content" has-book-nav has-toc> <devsite-toc class="devsite-nav"></devsite-toc> <devsite-content> <article class="devsite-article"> <div class="devsite-banner devsite-banner-announcement"> <div class="devsite-banner-message"> <div class="devsite-banner-message-text"> <style> .devsite-banner-announcement:not(.devsite-banner-tenant) { background: #202124; color: white; font-weight: 500; } .devsite-banner-announcement a { color: white; font-weight: 700; } .devsite-banner-announcement a:link, .devsite-banner-announcement a:visited { background: 0; } .devsite-banner-announcement a:hover, .devsite-banner-announcement a:focus { text-decoration: none; } .devsite-banner-announcement .devsite-banner-message-text { margin: 0 auto; } </style> Google is committed to advancing racial equity for Black communities. <a href="https://web.archive.org/web/20210520144438/https://google.com/racialequity" class="gc-analytics-event" data-category="Announcement" data-label="Racial Equity">See how.</a> </div> </div> </div> <div class="devsite-article-meta nocontent" role="navigation"> <ul class="devsite-breadcrumb-list" aria-label="Breadcrumb"> <li class="devsite-breadcrumb-item "> <a href="https://web.archive.org/web/20210520144438/https://developers.google.com/" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="1" track-type="globalNav" track-name="breadcrumb" track-metadata-position="1" track-metadata-eventdetail=""> Home </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://web.archive.org/web/20210520144438/https://developers.google.com/products" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="2" track-type="globalNav" track-name="breadcrumb" track-metadata-position="2" track-metadata-eventdetail=""> Products </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://web.archive.org/web/20210520144438/https://developers.google.com/youtube" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="3" track-type="globalNav" track-name="breadcrumb" track-metadata-position="3" track-metadata-eventdetail="YouTube"> YouTube </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://web.archive.org/web/20210520144438/https://developers.google.com/youtube/terms/api-services-terms-of-service" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="4" track-type="globalNav" track-name="breadcrumb" track-metadata-position="4" track-metadata-eventdetail=""> Terms </a> </li> </ul> <devsite-thumb-rating position="header"> <template class="thumb-down-categories"> [{ "type": "thumb-down", "id": "missingTheInformationINeed", "label":"Missing the information I need" },{ "type": "thumb-down", "id": "tooComplicatedTooManySteps", "label":"Too complicated / too many steps" },{ "type": "thumb-down", "id": "outOfDate", "label":"Out of date" },{ "type": "thumb-down", "id": "samplesCodeIssue", "label":"Samples/Code issue" },{ "type": "thumb-down", "id": "otherDown", "label":"Other" }] </template> <template class="thumb-up-categories"> [{ "type": "thumb-up", "id": "easyToUnderstand", "label":"Easy to understand" },{ "type": "thumb-up", "id": "solvedMyProblem", "label":"Solved my problem" },{ "type": "thumb-up", "id": "otherUp", "label":"Other" }] </template> </devsite-thumb-rating> </div> <h1 class="devsite-page-title">YouTube API Services - Subject API Services<devsite-bookmark></devsite-bookmark></h1> <devsite-toc class="devsite-nav" devsite-toc-embedded> </devsite-toc> <div class="devsite-article-body clearfix "> <style> .deprecated { color: red; } </style> <p class="note"><b>Note:</b> The new <a href="/web/20210520144438/https://developers.google.com/youtube/terms/developer-policies-guide">Complying with the YouTube Developer Policies</a> guide provides guidance and examples to help you ensure that your API clients adhere to specific portions of the YouTube API Services <a href="/web/20210520144438/https://developers.google.com/youtube/terms/api-services-terms-of-service">Terms</a> and <a href="/web/20210520144438/https://developers.google.com/youtube/terms/developer-policies">Policies</a> (API TOS). This guidance offers insight into how YouTube enforces certain aspects of the API TOS but does not replace any existing documents.</p> <p>The <a href="/web/20210520144438/https://developers.google.com/youtube/terms/api-services-terms-of-service">YouTube API Services Terms of Service</a> (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.</p> <p>This page identifies the <b>Subject API Services</b> 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.</p> <h2 id="understanding-deprecation-dates" data-text="Understanding deprecation dates">Understanding deprecation dates</h2> <p>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.</p> <h3 id="exemptions" data-text="Exemptions">Exemptions</h3> <p>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 <b>exemptions</b> in the list of subject services below.</p> <p>When an exemption applies to an <code translate="no" dir="ltr">object</code> 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.</p> <h2 id="subject-api-services" data-text="Subject API Services">Subject API Services</h2> <p>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.</p> <h3 id="youtube-data-api,-v3" data-text="YouTube Data API, v3">YouTube Data API, v3</h3> <p><ul> <li><a href="/web/20210520144438/https://developers.google.com/youtube/v3">Documentation</a></li> <li> <p>Exemptions</p> <ul> <li>The following <code translate="no" dir="ltr">channel</code> resource properties: <ul> <li><code translate="no" dir="ltr"><a href="/web/20210520144438/https://developers.google.com/youtube/v3/docs/channels#brandingSettings.channel.moderateComments">brandingSettings.channel.moderateComments</a></code></li> <li><code translate="no" dir="ltr"><a href="/web/20210520144438/https://developers.google.com/youtube/v3/docs/channels#brandingSettings.channel.profileColor">brandingSettings.channel.profileColor</a></code></li> <li><code translate="no" dir="ltr"><a href="/web/20210520144438/https://developers.google.com/youtube/v3/docs/channels#brandingSettings.hints">brandingSettings.hints</a></code></li> <li><code translate="no" dir="ltr"><a href="/web/20210520144438/https://developers.google.com/youtube/v3/docs/channels#brandingSettings.image.watchIconImageUrl">brandingSettings.image.watchIconImageUrl</a></code></li> <li><code translate="no" dir="ltr"><a href="/web/20210520144438/https://developers.google.com/youtube/v3/docs/channels#brandingSettings.watch">brandingSettings.watch</a></code></li> <li><code translate="no" dir="ltr"><a href="/web/20210520144438/https://developers.google.com/youtube/v3/docs/channels#contentDetails.relatedPlaylists">contentDetails.relatedPlaylists</a></code></li> <li><code translate="no" dir="ltr"><a href="/web/20210520144438/https://developers.google.com/youtube/v3/docs/channels#contentOwnerDetails">contentOwnerDetails</a></code></li> <li><code translate="no" dir="ltr"><a href="/web/20210520144438/https://developers.google.com/youtube/v3/docs/channels#invideoPromotion">invideoPromotion</a></code></li> <li><code translate="no" dir="ltr"><a href="/web/20210520144438/https://developers.google.com/youtube/v3/docs/channels#statistics.commentCount">statistics.commentCount</a></code></li> </ul> </li> <li>The <code translate="no" dir="ltr"><a href="/web/20210520144438/https://developers.google.com/youtube/v3/docs/guideCategories">guideCategory</a></code> resource and its methods.</li> <li>The <code translate="no" dir="ltr">search.list</code> method's <code translate="no" dir="ltr"><a href="/web/20210520144438/https://developers.google.com/youtube/v3/docs/search/list#safeSearch">safeSearch</a></code> parameter and its values.</li> <li>The <code translate="no" dir="ltr">video</code> resource's <code translate="no" dir="ltr"><a href="/web/20210520144438/https://developers.google.com/youtube/v3/docs/videos#status.publishAt">status.publishAt</a></code> property.</li> </ul> </li> </ul></p> <h3 id="youtube-iframe-player-api" data-text="YouTube IFrame Player API">YouTube IFrame Player API</h3> <p><ul> <li><a href="/web/20210520144438/https://developers.google.com/youtube/iframe_api_reference">Documentation</a></li> </ul></p> <h3 id="youtube-reporting-api" data-text="YouTube Reporting API">YouTube Reporting API</h3> <p><ul> <li><a href="/web/20210520144438/https://developers.google.com/youtube/reporting">Documentation</a></li> <li> <p>Exemptions</p> <ul> <li>Non-core dimensions. (See the <a href="/web/20210520144438/https://developers.google.com/youtube/reporting/v1/reports/dimensions">dimension</a> definitions to determine whether individual dimensions are considered core dimensions.)</li> <li>Non-core metrics. (See the <a href="/web/20210520144438/https://developers.google.com/youtube/reporting/v1/reports/metrics">metric</a> definitions to determine whether individual metrics are considered core metrics.)</li> </ul> </li> </ul></p> <h3 id="youtube-analytics-api" data-text="YouTube Analytics API">YouTube Analytics API</h3> <p><ul> <li><a href="/web/20210520144438/https://developers.google.com/youtube/analytics">Documentation</a></li> <li> <p>Exemptions</p> <ul> <li>Non-core dimensions. (See the <a href="/web/20210520144438/https://developers.google.com/youtube/analytics/v1/dimsmets/dims">dimension</a> definitions to determine whether individual dimensions are considered core dimensions.)</li> <li>Non-core metrics. (See the <a href="/web/20210520144438/https://developers.google.com/youtube/analytics/v1/dimsmets/mets">metric</a> definitions to determine whether individual metrics are considered core metrics.)</li> </ul> </li> </ul></p> <h2 id="fully-deprecated-api-services" data-text="Fully deprecated API Services">Fully deprecated API Services</h2> <p>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:</p> <h3 id="youtube-data-api,-v2" data-text="YouTube Data API, v2">YouTube Data API, v2</h3> <p><ul> <li><a href="https://web.archive.org/web/20210520144438/http://youtube-eng.blogspot.com/2014/03/committing-to-youtube-data-api-v3_4.html">Deprecation announcement</a> (March 4, 2014)</li> <li><a href="/web/20210520144438/https://developers.google.com/youtube/2.0/developers_guide_protocol">Documentation</a></li> <li>Migration path: <a href="/web/20210520144438/https://developers.google.com/youtube/v3/getting-started">YouTube Data API, v3</a></li> </ul></p> <h3 id="youtube-flash-player-api" data-text="YouTube Flash Player API">YouTube Flash Player API</h3> <p><ul> <li><a href="https://web.archive.org/web/20210520144438/http://youtube-eng.blogspot.com/2015/01/youtube-now-defaults-to-html5_27.html">Deprecation announcement</a> (January 27, 2015)</li> <li>Migration path: <a href="/web/20210520144438/https://developers.google.com/youtube/iframe_api_reference">IFrame Player API</a></li> </ul></p> <h3 id="youtube-javascript-player-api" data-text="YouTube JavaScript Player API">YouTube JavaScript Player API</h3> <p><ul> <li><a href="https://web.archive.org/web/20210520144438/http://youtube-eng.blogspot.com/2015/01/youtube-now-defaults-to-html5_27.html">Deprecation announcement</a> (January 27, 2015)</li> <li>Migration path: <a href="/web/20210520144438/https://developers.google.com/youtube/iframe_api_reference">IFrame Player API</a></li> </ul></p> </div> <devsite-thumb-rating position="footer"> <template class="thumb-down-categories"> [{ "type": "thumb-down", "id": "missingTheInformationINeed", "label":"Missing the information I need" },{ "type": "thumb-down", "id": "tooComplicatedTooManySteps", "label":"Too complicated / too many steps" },{ "type": "thumb-down", "id": "outOfDate", "label":"Out of date" },{ "type": "thumb-down", "id": "samplesCodeIssue", "label":"Samples/Code issue" },{ "type": "thumb-down", "id": "otherDown", "label":"Other" }] </template> <template class="thumb-up-categories"> [{ "type": "thumb-up", "id": "easyToUnderstand", "label":"Easy to understand" },{ "type": "thumb-up", "id": "solvedMyProblem", "label":"Solved my problem" },{ "type": "thumb-up", "id": "otherUp", "label":"Other" }] </template> </devsite-thumb-rating> </article> <devsite-content-footer class="nocontent"> <p>Except as otherwise noted, the content of this page is licensed under the <a href="https://web.archive.org/web/20210520144438/https://creativecommons.org/licenses/by/4.0/">Creative Commons Attribution 4.0 License</a>, and code samples are licensed under the <a href="https://web.archive.org/web/20210520144438/https://www.apache.org/licenses/LICENSE-2.0">Apache 2.0 License</a>. For details, see the <a href="https://web.archive.org/web/20210520144438/https://developers.google.com/site-policies">Google Developers Site Policies</a>. Java is a registered trademark of Oracle and/or its affiliates.</p> <p>Last updated 2020-06-15 UTC.</p> </devsite-content-footer> </devsite-content> </main> <devsite-footer-promos class="devsite-footer"> <nav class="devsite-footer-promos nocontent" aria-label="Promotions"> <ul class="devsite-footer-promos-list"> <li class="devsite-footer-promo"> <a href="https://web.archive.org/web/20210520144438/http://apiblog.youtube.com/" class="devsite-footer-promo-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Promo Link (index 1)"> <img class="devsite-footer-promo-icon" src="https://web.archive.org/web/20210520144438im_/https://www.gstatic.com/images/icons/material/product/2x/blogger_64dp.png" loading="lazy" alt="Blog"> Blog </a> <div class="devsite-footer-promo-description">The latest news on the YouTube API blog</div> </li> <li class="devsite-footer-promo"> <a href="https://web.archive.org/web/20210520144438/https://github.com/youtube/api-samples" class="devsite-footer-promo-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Promo Link (index 2)"> <img class="devsite-footer-promo-icon" src="/web/20210520144438im_/https://developers.google.com/site-assets/logo-github.svg" loading="lazy" alt="GitHub"> GitHub </a> <div class="devsite-footer-promo-description">Find API code samples and other YouTube open-source projects.</div> </li> <li class="devsite-footer-promo"> <a href="https://web.archive.org/web/20210520144438/https://issuetracker.google.com/issues/new?component=186600&amp;template=874803" class="devsite-footer-promo-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Promo Link (index 3)"> <img class="devsite-footer-promo-icon" src="/web/20210520144438im_/https://developers.google.com/site-assets/developers_64dp.png" loading="lazy" alt="Issue Tracker"> Issue Tracker </a> <div class="devsite-footer-promo-description">Something wrong? Send us a bug report!</div> </li> <li class="devsite-footer-promo"> <a href="https://web.archive.org/web/20210520144438/http://stackoverflow.com/questions/ask?tags=youtube-api" class="devsite-footer-promo-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Promo Link (index 4)"> <img class="devsite-footer-promo-icon" src="/web/20210520144438im_/https://developers.google.com/site-assets/logo-stack-overflow.svg" loading="lazy" alt="Stack Overflow"> Stack Overflow </a> <div class="devsite-footer-promo-description">Ask a question under the youtube-api tag</div> </li> <li class="devsite-footer-promo"> <a href="https://web.archive.org/web/20210520144438/https://www.youtube.com/user/YouTubeDev" class="devsite-footer-promo-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Promo Link (index 5)"> <img class="devsite-footer-promo-icon" src="/web/20210520144438im_/https://developers.google.com/site-assets/logo-youtube.svg" loading="lazy" alt="Videos"> Videos </a> <div class="devsite-footer-promo-description">Check out the YouTube Developer Relations team&#39;s YouTube channel</div> </li> </ul> </nav> </devsite-footer-promos> <devsite-footer-linkboxes class="devsite-footer"> <nav class="devsite-footer-linkboxes nocontent" aria-label="Footer links"> <ul class="devsite-footer-linkboxes-list"> <li class="devsite-footer-linkbox "> <h3 class="devsite-footer-linkbox-heading no-link">Tools</h3> <ul class="devsite-footer-linkbox-list"> <li class="devsite-footer-linkbox-item"> <a href="https://web.archive.org/web/20210520144438/https://developers.google.com/apis-explorer/#p/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 1)"> Google APIs Explorer </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/web/20210520144438/https://developers.google.com/youtube/youtube_player_demo" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 2)"> YouTube Player Demo </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/web/20210520144438/https://developers.google.com/youtube/youtube_subscribe_button" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 3)"> Configure a Subscribe Button </a> </li> </ul> </li> <li class="devsite-footer-linkbox "> <h3 class="devsite-footer-linkbox-heading no-link">Issue Tracker</h3> <ul class="devsite-footer-linkbox-list"> <li class="devsite-footer-linkbox-item"> <a href="https://web.archive.org/web/20210520144438/https://issuetracker.google.com/issues/new?component=186600&amp;template=874803" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 1)"> File a bug </a> </li> <li class="devsite-footer-linkbox-item"> <a href="https://web.archive.org/web/20210520144438/https://issuetracker.google.com/issues/new?component=186600&amp;template=874803" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 2)"> Request a feature </a> </li> <li class="devsite-footer-linkbox-item"> <a href="https://web.archive.org/web/20210520144438/https://issuetracker.google.com/issues?q=componentid:186600" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 3)"> See open issues </a> </li> </ul> </li> <li class="devsite-footer-linkbox "> <h3 class="devsite-footer-linkbox-heading no-link">Product Info</h3> <ul class="devsite-footer-linkbox-list"> <li class="devsite-footer-linkbox-item"> <a href="/web/20210520144438/https://developers.google.com/youtube/terms/api-services-terms-of-service" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 1)"> Terms of Service </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/web/20210520144438/https://developers.google.com/youtube/terms/developer-policies" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 2)"> Developer Policies </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/web/20210520144438/https://developers.google.com/youtube/terms/required-minimum-functionality" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 3)"> Required Minimum Functionality </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/web/20210520144438/https://developers.google.com/youtube/terms/branding-guidelines" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 4)"> Branding Guidelines </a> </li> </ul> </li> </ul> </nav> </devsite-footer-linkboxes> <devsite-footer-utility class="devsite-footer"> <div class="devsite-footer-utility nocontent"> <nav class="devsite-footer-sites" aria-label="Other Google Developers websites"> <a href="https://web.archive.org/web/20210520144438/https://developers.google.com/" class="devsite-footer-sites-logo-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Google Developers Link"> <img class="devsite-footer-sites-logo" src="https://web.archive.org/web/20210520144438im_/https://www.gstatic.com/devrel-devsite/prod/v1674d466be3b1154327dd11cf186e748303b1e92ae31ff35df0f5192fbd777ea/developers/images/lockup-developers.svg" loading="lazy" alt="Google Developers"> </a> <ul class="devsite-footer-sites-list"> <li class="devsite-footer-sites-item"> <a href="//web.archive.org/web/20210520144438/https://developer.android.com/" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Android Link"> Android </a> </li> <li class="devsite-footer-sites-item"> <a href="//web.archive.org/web/20210520144438/https://developer.chrome.com/home" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Chrome Link"> Chrome </a> </li> <li class="devsite-footer-sites-item"> <a href="//web.archive.org/web/20210520144438/https://firebase.google.com/" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Firebase Link"> Firebase </a> </li> <li class="devsite-footer-sites-item"> <a href="//web.archive.org/web/20210520144438/https://cloud.google.com/" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Google Cloud Platform Link"> Google Cloud Platform </a> </li> <li class="devsite-footer-sites-item"> <a href="/web/20210520144438/https://developers.google.com/products" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer All products Link"> All products </a> </li> </ul> </nav> <nav class="devsite-footer-utility-links" aria-label="Utility links"> <ul class="devsite-footer-utility-list"> <li class="devsite-footer-utility-item "> <a class="devsite-footer-utility-link gc-analytics-event" href="/web/20210520144438/https://developers.google.com/terms/site-terms" data-category="Site-Wide Custom Events" data-label="Footer Terms link"> Terms </a> </li> <li class="devsite-footer-utility-item "> <a class="devsite-footer-utility-link gc-analytics-event" href="//web.archive.org/web/20210520144438/https://policies.google.com/privacy" data-category="Site-Wide Custom Events" data-label="Footer Privacy link"> Privacy </a> </li> <li class="devsite-footer-utility-item devsite-footer-utility-button"> <span class="devsite-footer-utility-description">Sign up for the Google Developers newsletter</span> <a class="devsite-footer-utility-link gc-analytics-event" href="//web.archive.org/web/20210520144438/https://services.google.com/fb/forms/googledevelopersnewsletter/?utm_medium=referral&amp;utm_source=google-products&amp;utm_team=googledevs&amp;utm_campaign=201611-newsletter-launch" data-category="Site-Wide Custom Events" data-label="Footer Subscribe link"> Subscribe </a> </li> </ul> <devsite-language-selector> <devsite-select class="devsite-language-selector-menu"> <select aria-label="Select your language preference." class="devsite-language-selector-select" name="language" track-name="click" track-type="languageSelector"> <option>Language</option> <option value="en" lang="en" track-metadata-original-language="en" track-metadata-selected-language="en" track-name="changed" track-type="languageSelector"> English </option> <option value="id" lang="id" track-metadata-original-language="en" track-metadata-selected-language="id" track-name="changed" track-type="languageSelector"> Bahasa Indonesia </option> <option value="de" lang="de" track-metadata-original-language="en" track-metadata-selected-language="de" track-name="changed" track-type="languageSelector"> Deutsch </option> <option value="es" lang="es" track-metadata-original-language="en" track-metadata-selected-language="es" track-name="changed" track-type="languageSelector"> Español </option> <option value="fr" lang="fr" track-metadata-original-language="en" track-metadata-selected-language="fr" track-name="changed" track-type="languageSelector"> Français </option> <option value="pt_br" lang="pt_br" track-metadata-original-language="en" track-metadata-selected-language="pt_br" track-name="changed" track-type="languageSelector"> Português – Brasil </option> <option value="ru" lang="ru" track-metadata-original-language="en" track-metadata-selected-language="ru" track-name="changed" track-type="languageSelector"> Русский </option> <option value="zh_cn" lang="zh_cn" track-metadata-original-language="en" track-metadata-selected-language="zh_cn" track-name="changed" track-type="languageSelector"> 中文 – 简体 </option> <option value="ja" lang="ja" track-metadata-original-language="en" track-metadata-selected-language="ja" track-name="changed" track-type="languageSelector"> 日本語 </option> <option value="ko" lang="ko" track-metadata-original-language="en" track-metadata-selected-language="ko" track-name="changed" track-type="languageSelector"> 한국어 </option> </select> </devsite-select> </devsite-language-selector> </nav> </div> </devsite-footer-utility> </section></section> <devsite-sitemask></devsite-sitemask> <devsite-snackbar></devsite-snackbar> <devsite-tooltip></devsite-tooltip> <devsite-heading-link></devsite-heading-link> <devsite-analytics enable-analytics-iframe> <script type="application/json" analytics>[{"gaid": "UA-24532603-1", "dimensions": {"dimension1": "Signed out", "dimension11": false, "dimension4": "YouTube", "dimension3": false, "dimension6": "en", "dimension5": "en", "dimension8": null}, "metrics": {"ratings_count": "metric2", "ratings_value": "metric1"}}]</script> <script type="application/json" gtm>{"parameters": {"freeTrialEligibleUser": "False", "internalUser": "False", "language": {"machineTranslated": "False", "requested": "en", "served": "en"}, "pageType": "article", "projectName": "YouTube", "scriptsafe": null, "signedIn": "False", "tenant": "developers", "recommendations": {"sourcePage": "", "sourceType": 0, "sourceRank": 0, "sourceIdenticalDescriptions": 0, "sourceTitleWords": 0, "sourceDescriptionWords": 0, "experiment": ""}}}</script> </devsite-analytics> <devsite-badger></devsite-badger> <script nonce="IU55gsbzxvSydNvKU0sSq838SK5CyN"> (function(d,e,v,s,i,t,E){d['GoogleDevelopersObject']=i; t=e.createElement(v);t.async=1;t.src=s;E=e.getElementsByTagName(v)[0]; E.parentNode.insertBefore(t,E);})(window, document, 'script', 'https://web.archive.org/web/20210520144438/https://www.gstatic.com/devrel-devsite/prod/v1674d466be3b1154327dd11cf186e748303b1e92ae31ff35df0f5192fbd777ea/developers/js/app_loader.js', '[1,"en",null,"/js/devsite_app_module.js","https://web.archive.org/web/20210520144438/https://www.gstatic.com/devrel-devsite/prod/v1674d466be3b1154327dd11cf186e748303b1e92ae31ff35df0f5192fbd777ea","https://web.archive.org/web/20210520144438/https://www.gstatic.com/devrel-devsite/prod/v1674d466be3b1154327dd11cf186e748303b1e92ae31ff35df0f5192fbd777ea/developers","https://web.archive.org/web/20210520144438/https://developers-dot-devsite-v2-prod.appspot.com",null,null,["/_pwa/developers/manifest.json","https://web.archive.org/web/20210520144438/https://www.gstatic.com/devrel-devsite/prod/v1674d466be3b1154327dd11cf186e748303b1e92ae31ff35df0f5192fbd777ea/images/video-placeholder.svg","https://web.archive.org/web/20210520144438/https://www.gstatic.com/devrel-devsite/prod/v1674d466be3b1154327dd11cf186e748303b1e92ae31ff35df0f5192fbd777ea/developers/images/favicon.png","https://web.archive.org/web/20210520144438/https://fonts.googleapis.com/css?family=Google+Sans:400,500|Roboto:400,400italic,500,500italic,700,700italic|Roboto+Mono:400,500,700|Material+Icons"],1,null,[1,6,8,12,14,17,21,25,40,45,50,63,70,75,76,80,87,88,91,92,93,97,98,100,101,102,103,105,107,108,111,112,113,115,116,117,118,120,122,123,124,125,127,129,131,132,133,134,135,136],"AIzaSyAP-jjEJBzmIyKR4F-3XITp8yM9T1gEEI8","AIzaSyB6xiKGDR5O3Ak2okS4rLkauxGUG7XP0hg"]') </script> <devsite-a11y-announce></devsite-a11y-announce> </body> </html><!-- FILE ARCHIVED ON 14:44:38 May 20, 2021 AND RETRIEVED FROM THE INTERNET ARCHIVE ON 14:04:40 Feb 26, 2025. JAVASCRIPT APPENDED BY WAYBACK MACHINE, COPYRIGHT INTERNET ARCHIVE. ALL OTHER CONTENT MAY ALSO BE PROTECTED BY COPYRIGHT (17 U.S.C. SECTION 108(a)(3)). --> <!-- playback timings (ms): captures_list: 0.806 exclusion.robots: 0.026 exclusion.robots.policy: 0.016 esindex: 0.007 cdx.remote: 445.439 LoadShardBlock: 1560.445 (3) PetaboxLoader3.datanode: 1056.513 (4) load_resource: 152.226 PetaboxLoader3.resolve: 52.657 -->

Pages: 1 2 3 4 5 6 7 8 9 10