שירותי YouTube API – שירותי Subject API
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
הערה: בקטע ציות למדיניות למפתחים של YouTube תמצאו הנחיות ודוגמאות שיעזרו לכם לוודא שלקוחות ה-API שלכם פועלים בהתאם לחלקים ספציפיים בתנאים ובמדיניות של שירותי YouTube API (התנאים וההגבלות של ממשקי ה-API). המדריך מספק תובנות לגבי האופן שבו YouTube אוכף היבטים מסוימים של התנאים וההגבלות של ה-API, אבל הוא לא מחליף אף מסמך קיים.
התנאים וההגבלות של שירותי YouTube API (ה "תנאים") קובעים (בסעיף 14) שכאשר הכוונה של YouTube היא לבצע שינויים לא תואמים לאחור בשירותי YouTube API, YouTube יודיע על השינויים האלה וינסה לשמור את קוד התוכנה למשך שישה חודשים לאחר ההכרזה.
בדף זה מצוינים שירותי הנושא של API המוזכרים בסעיף 14.3 (תנאים מיוחדים) של התנאים, והסבר כיצד סעיף זה בתנאים משפיע על תאריכי ההוצאה משימוש בפועל. לפני 10 בפברואר 2017, שהוא מועד הכניסה לתוקף של התנאים הנוכחיים, שירותי Subject API היו כפופים למדיניות הוצאה משימוש למשך שנה אחת בהתאם לקבוצת התנאים הקודמת. כדי לכבד את המדיניות הזו, שירותי Subject API כפופים באופן זמני לכללי הוצאה משימוש שונים מאלה של שירותים אחרים.
הסבר על תאריכי ההוצאה משימוש
במקרה של חוסר תאימות לאחור בשירותי Subject API, הצוות של YouTube ישקיע מאמצים סבירים כדי לשמור על הקוד לפחות עד 10 בפברואר 2018, כלומר שנה אחת אחרי שהתנאים האלה נכנסו לתוקף. בשירותים אחרים, YouTube ינסה לשמור את קוד התוכנה למשך שישה חודשים מהתאריך שבו הודענו על השינויים האלה.
פטורים
חלק מהתכונות של שירותי Subject API לא כפופות לכללים שמוגדרים בסעיף 14.3 של התנאים, מפני שגם התכונות האלה לא היו כפופות למדיניות ההוצאה משימוש שהוגדרה במסגרת קבוצת התנאים הקודמת. התכונות האלה מזוהות כפטורים ברשימת השירותים בנושאים הבאים.
כשפטור חל על נכס object, הוא חל גם על כל נכסי הצאצא של הנכס. בנוסף, הפטור חל על היכולת לאחזר, להגדיר, לשנות או למחוק ערכים של הנכס או של נכסי הצאצא שלו, וכן על ערכי הנכס עצמם.
שירותי Subject API
בקטעים הבאים מוגדרים שירותי Subject API. למען שלמות האפליקציה, הקטעים האלה מזהים גם שירותי API שהוצאו משימוש באופן מלא. השירותים האלה שהוצאו משימוש באופן מלא אינם מכוסים במסגרת התנאים.
YouTube Data API, גרסה 3
ממשק API של YouTube IFrame Player
ממשק API לדיווח של YouTube
- מסמכי תיעוד
-
פטורים
- מאפיינים שאינם מאפייני ליבה. (אפשר לעיין בהגדרות המאפיינים כדי לקבוע אם מאפיינים ספציפיים נחשבים למאפייני ליבה).
- מדדים שאינם ערכי ליבה. (אפשר לעיין בהגדרות המדד כדי לקבוע אם מדדים נפרדים נחשבים למדדי ליבה.)
ממשק API של YouTube Analytics
- מסמכי תיעוד
-
פטורים
- מאפיינים שאינם מאפייני ליבה. (אפשר לעיין בהגדרות המאפיינים כדי לקבוע אם מאפיינים ספציפיים נחשבים למאפייני ליבה).
- מדדים שאינם ערכי ליבה. (אפשר לעיין בהגדרות המדד כדי לקבוע אם מדדים נפרדים נחשבים למדדי ליבה.)
שירותי API שהוצאו משימוש באופן מלא
שירותי ה-API הבאים הוצאו משימוש לחלוטין. הם היו כפופים למדיניות ההוצאה משימוש שהוגדרה בתנאים המקוריים, ותקופת ההוצאה משימוש הסתיימה. YouTube לא מחויב להודיע על שינויים שעלולים לגרום לכשלים בשירותים האלה, או להמשיך לתמוך בהם:
YouTube Data API, גרסה 2
ממשק API של YouTube Flash Player
ממשק ה-API של נגן JavaScript ב-YouTube
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. 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"]]
