سرویس‌های API YouTube - سرویس‌های API موضوعی، سرویس‌های API YouTube - سرویس‌های API موضوعی
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
توجه: پیروی از خط‌مشی‌های برنامه‌نویس YouTube راهنمایی‌ها و مثال‌هایی را ارائه می‌دهد تا به شما کمک کند مطمئن شوید که مشتریان API شما از بخش‌های خاصی از شرایط و خط‌مشی‌های خدمات YouTube API (API TOS) پیروی می‌کنند. این راهنما بینشی را در مورد نحوه اجرای برخی جنبه‌های API TOS توسط YouTube ارائه می‌کند، اما جایگزین هیچ سند موجود نمی‌شود.
شرایط خدمات YouTube API Services («شرایط») بیان می‌کند (در بخش 14) که وقتی YouTube قصد دارد تغییرات ناسازگاری را در سرویس‌های YouTube API ایجاد کند، YouTube آن تغییرات را اعلام می‌کند و سعی می‌کند به حفظ کد نرم‌افزار برای مدت شش سال ادامه دهد. ماه ها پس از اعلام
این صفحه خدمات Subject API اشاره شده در بخش 14.3 (شرایط ویژه) شرایط را شناسایی می‌کند و توضیح می‌دهد که چگونه آن بخش از شرایط بر تاریخ‌های منسوخ شدن واقعی تأثیر می‌گذارد. قبل از 10 فوریه 2017، که تاریخ لازم‌الاجرا شدن شرایط فعلی است، «خدمات API موضوع» تحت مجموعه شرایط قبلی مشمول یک خط‌مشی منسوخ یک ساله می‌شدند. برای رعایت این خط‌مشی، سرویس‌های Subject API به‌طور موقت مشمول قوانین لغو متفاوتی نسبت به سایر سرویس‌ها هستند.
آشنایی با تاریخ های منسوخ شدن
در صورت تغییرات ناسازگار با سوژه سرویس‌های API، YouTube از تلاش‌های منطقی برای حفظ کد حداقل تا ۱۰ فوریه ۲۰۱۸، یعنی یک سال پس از اجرایی شدن این شرایط استفاده می‌کند. برای سایر خدمات، یوتیوب سعی خواهد کرد تا شش ماه از تاریخ اعلام تغییرات، کد نرم افزار را حفظ کند.
معافیت ها
برخی از ویژگی‌های Subject API Services مشمول قوانین تعریف‌شده در بخش 14.3 شرایط نیستند، زیرا این ویژگی‌ها نیز مشمول خط‌مشی منسوخ شدن تعریف شده در مجموعه قبلی شرایط نبودند. این ویژگی ها به عنوان معافیت در لیست خدمات موضوعی زیر مشخص شده اند.
هنگامی که یک معافیت برای یک ویژگی object اعمال می شود، برای هر یک از ویژگی های فرزند آن ویژگی نیز اعمال می شود. علاوه بر این، این معافیت در مورد توانایی بازیابی، تنظیم، تغییر یا حذف مقادیر دارایی یا ویژگی های فرزند آن و همچنین برای خود مقادیر دارایی اعمال می شود.
موضوع خدمات API
بخش های زیر سرویس های Subject API را تعریف می کنند. برای کامل بودن، این بخش ها خدمات API کاملاً منسوخ را نیز شناسایی می کنند. این سرویس‌های کاملاً منسوخ شده تحت پوشش شرایط نیستند.
YouTube Data API، نسخه 3
YouTube IFrame Player API
YouTube Reporting API
- مستندات
معافیت ها
- ابعاد غیر هسته ای (برای تعیین اینکه آیا ابعاد فردی به عنوان ابعاد اصلی در نظر گرفته می شوند، به تعاریف ابعاد مراجعه کنید.)
- معیارهای غیر هسته ای (برای تعیین اینکه آیا معیارهای فردی معیارهای اصلی در نظر گرفته می شوند یا خیر، به تعاریف متریک مراجعه کنید.)
YouTube Analytics API
- مستندات
معافیت ها
- ابعاد غیر هسته ای (برای تعیین اینکه آیا ابعاد فردی به عنوان ابعاد اصلی در نظر گرفته می شوند، به تعاریف ابعاد مراجعه کنید.)
- معیارهای غیر هسته ای (برای تعیین اینکه آیا معیارهای فردی معیارهای اصلی در نظر گرفته می شوند یا خیر، به تعاریف متریک مراجعه کنید.)
خدمات API کاملاً منسوخ شده
سرویس های API زیر به طور کامل منسوخ شده اند. آنها مشمول خط مشی انحلال مندرج در شرایط اصلی بودند و دوره انحلال به پایان رسیده است. YouTube نه موظف است تغییرات قطعی در این سرویس‌ها را اعلام کند و نه به پشتیبانی از آنها ادامه دهد:
YouTube Data API، نسخه 2
YouTube Flash Player API
YouTube JavaScript Player API
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خط‌مشی‌های سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-21 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-21 بهوقت ساعت هماهنگ جهانی."],[],["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"]]
