Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

היסטוריית תיקונים

בדף הזה מפורטים השינויים ב-YouTube Data API (גרסה 3) ועדכונים במסמכי התיעוד. הרשמה ליומן השינויים הזה.

‫1 ביוני 2026

מערכת YouTube Data API עוברת למערכת מכסות מפורטת יותר, שכוללת קבוצות קטנות יותר של שיטות, החל מ-videos.insert ו-search.list.

העדכון הזה מפשט את הדרך להגדלת המכסה, כי הוא מאפשר ל-YouTube לאמת ולאשר בקשות בקלות רבה יותר על סמך שימוש בשיטה ספציפית. המעבר הזה הוא גם חלק חשוב מהמחויבות שלנו ליציבות ולאבטחה של הפלטפורמה. אנחנו רוצים לוודא שכל מפתח יוכל לפעול בסביבה מוגנת, תוך שמירה על רמות הגישה שדרושות לו לתרחישי השימוש שאושרו.

קריאות ל-API לשיטות videos.insert ו-search.list יחויבו בדלי המכסה המתאים שלהן. קריאות ל-API לכל השיטות האחרות יחויבו במסגרת מכסת הקטגוריה הקיימת. מפתחים יכולים לראות את מגבלות המכסות במסוף Google Cloud, ולבקש מכסה נוספת באמצעות טופס בקשה להגדלת מכסה.

‫4 בדצמבר 2025

עדכנו את התיעוד של YouTube Data API ואת מחשבון המכסות כדי לשקף שינוי בעלות המכסה של העלאת סרטון, מכ-1,600 יחידות לכ-100 יחידות.

‫10 ביולי 2025

החל מ-21 ביולי 2025, מערכת YouTube תבצע שינויים בתוכן שמוחזר על ידי התרשים mostPopular של השיטה video.list. בעבר, במצעד mostPopular הוצגו הסרטונים שהופיעו ברשימה 'הטרנדים המובילים כרגע'. מעכשיו, במצעד mostPopular יופיעו סרטונים מהמצעדים של מוזיקה, סרטים וגיימינג בטרנד. השינוי הזה ב-API מתבצע במקביל להוצאה משימוש של דף התכנים הפופולריים ב-YouTube.

‫26 במרץ 2025

החל מ-31 במרץ 2025, נשנה ב-YouTube את האופן שבו הצפיות בסרטוני Shorts נספרות. בעבר, צפייה בסרטון Shorts נספרה אחרי שהסרטון הופעל למשך מספר מסוים של שניות. מספר הצפיות משקף עכשיו את מספר הפעמים שסרטון Shorts התחיל לפעול או הופעל מחדש, לא משנה לכמה זמן. מידע נוסף

החל מ-31 במרץ 2025, השדות הבאים ב-Data API יחזירו את מספר הצפיות ב-Shorts בהתאם לשינוי הזה:

channels.statistics.viewCount
videos.statistics.viewCount

‫30 באוקטובר 2024

ממשק ה-API תומך עכשיו ביכולת לזהות סרטונים שמכילים תוכן ריאליסטי שעבר שינוי או תוכן סינתטי (A/S). מידע נוסף על כללי המדיניות של YouTube בנושא תוכן שקשור לניצול מיני או להתעללות בילדים

דוגמאות לתוכן A/S כוללות סרטונים שבהם:

בתוכן נראה אדם אמיתי שאומר משהו שלא אמר או עושה משהו שלא עשה.
שינוי חומר מצולם של אירוע או מקום אמיתיים
יצירת סצנה שנראית אמיתית אבל שלא התרחשה באמת

כדי לציין אם סרטון מכיל תוכן שקשור לאלכוהול או לטבק, צריך להגדיר את המאפיין status.containsSyntheticMedia. אפשר להגדיר את המאפיין הזה כשמפעילים את השיטות videos.insert או videos.update. אם המאפיין מוגדר, הוא מוחזר במשאב video.

‫30 באפריל 2024

הערה: זוהי הודעה על הוצאה משימוש.

העדכון הזה כולל את השינויים הבאים:

ה-API כבר לא תומך בהוספה או באחזור של דיונים בערוץ. השינוי הזה תואם לפונקציונליות שנתמכת באתר YouTube, שבו אי אפשר לפרסם תגובות בערוצים.

‫13 במרץ 2024

הערה: זוהי הודעה על הוצאה משימוש.

העדכון הזה כולל את השינויים הבאים:

הפרמטר sync של השיטות captions.insert ו-captions.update הוצא משימוש. החל מ-12 באפריל 2024, מערכת YouTube תפסיק לתמוך בפרמטר.

בעקבות השינוי הזה, מפתחים צריכים לכלול מידע על תזמון כשהם מוסיפים או מעדכנים קובצי כתוביות, אחרת ההעלאה תיכשל.

‫12 במרץ 2024

העדכון הזה כולל את השינויים הבאים:

עדכנו את התיעוד של המשאב captions כדי לציין שהאורך המקסימלי המותר בשדה snippet.name הוא 150 תווים. אם שם הטראק ארוך יותר, ה-API מחזיר שגיאה nameTooLong.

‫7 במרץ 2024

הערה: זוהי הודעה על הוצאה משימוש.

המאפיין channel של משאב brandingSettings.channel.moderateComments יצא משימוש. התמיכה בפרמטר הזה ב-YouTube תופסק ב-7 במרץ 2024.

‫31 בינואר 2024

העדכון הזה כולל את השינויים הבאים:

הפרמטר החדש forHandle של שיטת channels.list מאפשר לכם לאחזר מידע על ערוץ על ידי ציון הכינוי שלו ב-YouTube.

‫9 בנובמבר 2023

כל ההפניות למשאב videoId בקטע Comments הוסרו כי המשאב videoId לא מוחזר באמצעות קריאה ל-API.

‫12 בספטמבר 2023

הערה: זוהי הודעה על הוצאה משימוש.

השיטה comments.markAsSpam הוצאה משימוש לפני כמה שנים. השיטה הזו כבר לא נתמכת ב-YouTube, ועכשיו היא גם לא נתמכת יותר דרך ה-API.

הודעת הוצאה משימוש נוספה לכל המסמכים שמתייחסים לשיטה comments.markAsSpam.

‫22 באוגוסט 2023

ה-method‏ search.list תומך עכשיו בפרמטר videoPaidProductPlacement. הפרמטר הזה מאפשר לסנן את תוצאות החיפוש כך שיכללו רק סרטונים שהיוצר סימן כסרטונים עם קידום מכירות בתשלום.

‫18 באוגוסט 2023

ההגדרה של video resource's liveStreamingDetails.concurrentViewers עודכנה. עכשיו מצוין בה שספירת הצופים בו-זמנית שמוחזרת על ידי YouTube Data API עשויה להיות שונה מספירת הצופים בו-זמנית שעברה עיבוד והוסרו ממנה ספאם, שזמינה דרך YouTube Analytics. במרכז העזרה של YouTube יש מידע נוסף על מדדים של שידורים חיים.

‫7 באוגוסט 2023

כפי שפורסם ב-12 ביוני 2023, הפרמטר relatedToVideoId של השיטה search.list הוצא משימוש. הפרמטר הזה לא נתמך יותר, וההפניות אליו הוסרו ממאמרי העזרה של ה-API.

‫28 ביוני 2023

השיטה thumbnails.set תומכת עכשיו בשגיאה uploadRateLimitExceeded, שמציינת שהועלו לערוץ יותר מדי תמונות ממוזערות ב-24 השעות האחרונות, וצריך לנסות שוב מאוחר יותר.

‫12 ביוני 2023

הערה: זוהי הודעה על הוצאה משימוש.

הפרמטר relatedToVideoId של השיטה search.list הוצא משימוש. מ-7 באוגוסט 2023, מערכת YouTube תפסיק לתמוך בפרמטר.

בשלב הזה, הודעה על הוצאה משימוש נוספה לתיעוד של שיטת search.list. הפרמטר הזה יוסר לחלוטין מהsearch.listמסמכי התיעוד ב-7 באוגוסט 2023 או אחריו.

בנוסף, הסרנו מהמדריך ההטמעה של ה-API דוגמה שמראה איך לאחזר סרטונים קשורים.

‫22 באוגוסט 2022

תיקנו את הערות הסוג לשדות video.statistics מ-unsigned long ל-string.

5 באוגוסט 2022

שינינו ב-YouTube את האופן שבו נוצרים מזהי כתוביות, וכחלק מהשינוי הזה אנחנו מקצים מזהי כתוביות חדשים לכל רצועות הכתוביות. השינוי הזה עשוי להיות שינוי שאינו תואם לאחור באפליקציות שמאחסנות ערכים של caption_id, אבל הוא לא ישפיע על אפליקציות שלא מאחסנות ערכים של caption_id.

מעכשיו ועד 1 בדצמבר 2022, השיטות captions.list, captions.update, captions.download, captions.delete יתמכו במזהי רצועות הכתוביות הישנים והחדשים. עם זאת, החל מ-1 בדצמבר 2022, YouTube יפסיק לתמוך במזהי רצועות הכתוביות הישנים. בשלב הזה, קריאה לכל אחת משיטות ה-API האלה עם מזהה ישן של רצועת כתוביות תגרום לשגיאת captionNotFound.

כדי להתכונן לשינוי הזה, מומלץ לתכנן להחליף באופן מלא את כל נתוני רצועות הכתוביות המאוחסנים עד 1 בדצמבר 2022. כלומר, לכל סרטון שבו אתם מאחסנים נתונים של רצועת כתוביות, אתם צריכים למחוק את הנתונים שמאוחסנים כרגע, ואז להפעיל את captions.list השיטה כדי לאחזר את קבוצת רצועות הכתוביות הנוכחית של הסרטון ולאחסן את הנתונים בתגובת ה-API כמו שאתם עושים בדרך כלל.

12 ביולי 2022

התנאים וההגבלות של שירותי ה-API של YouTube עודכנו. מידע נוסף מופיע בהיסטוריית הגרסאות של התנאים וההגבלות של שירותי ה-API של YouTube.

27 באפריל 2022

תיארנו את השיטה videos.insert וציינו שגודל הקובץ המקסימלי של סרטונים שהועלו גדל מ-128GB ל-256GB.

‫8 באפריל 2022

העדכנו את ההגדרות של הפרמטרים myRecentSubscribers ו-mySubscribers של השיטה subscriptions.list כדי לציין שמספר המנויים המקסימלי שמוחזר על ידי ה-API עשוי להיות מוגבל. השינוי הזה הוא תיקון בתיעוד ולא שינוי בהתנהגות של ה-API.

15 בדצמבר 2021

כפי שפורסם ב-18 בנובמבר 2021, במסגרת השינויים שבוצעו כדי להסתיר את מספר הלייקים לסרטונים בכל פלטפורמת YouTube, המאפיין statistics.dislikeCount של רכיב video הוא עכשיו פרטי.

מידע נוסף על השינוי הזה זמין בבלוג הרשמי של YouTube.

‫18 בנובמבר 2021

בנוסף לשינויים שבוצעו כדי להגדיר את מספר הדיסלייקים בסרטונים כפרטי בכל פלטפורמת YouTube, מאפיין statistics.dislikeCount של משאב video יוגדר כפרטי החל מ-13 בדצמבר 2021. כלומר, המאפיין ייכלל בתשובת API מנקודת הקצה videos.list רק אם בקשת ה-API אומתה על ידי בעל הסרטון.

נקודת הקצה videos.rate לא מושפעת מהשינוי הזה.

מפתחים שלא מציגים את מספר הלייקים באופן ציבורי ועדיין צריכים את מספר הלייקים בשביל לקוח ה-API שלהם יכולים להגיש בקשה להוספה לרשימת ההיתרים לצורך קבלת פטור. כדי להגיש בקשה לפטור, צריך למלא את טופס הבקשה הזה.

מידע נוסף על השינוי הזה זמין בבלוג הרשמי של YouTube.

‫2 ביולי 2021

הערה: זוהי הודעה על הוצאה משימוש.

נקודת הקצה (endpoint) commentThreads.update הוצאה משימוש ולא נתמכת יותר. נקודת הקצה הזו שכפלה פונקציונליות שזמינה דרך נקודות קצה אחרות של API. במקום זאת, אפשר להתקשר אל comments.update

‫method ואם הקוד שלכם דורש משאב commentThreads, מבצעים קריאה משנית ל-method ‏commentThreads.list.

1 ביולי 2021

כל המפתחים שמשתמשים בשירותי ה-API של YouTube נדרשים לעבור ביקורת להבטחת תאימות ל-API כדי לקבל מכסה גדולה יותר ממכסת ברירת המחדל של 10,000 יחידות. עד עכשיו, תהליך ביקורת התאימות ובקשות להקצאת יחידות מכסה נוספות בוצעו על ידי מפתחים שמילאו את הטופס של שירותי ה-API של YouTube – ביקורת והגדלת מכסה ושלחו אותו.

כדי להבהיר את התהליכים האלה ולענות טוב יותר על הצרכים של מפתחים שמשתמשים בשירותי ה-API שלנו, אנחנו מוסיפים שלושה טפסים חדשים ומדריך למילוי הטפסים האלה:

טופס בקשות למפתחים שעברו ביקורת: מפתחים שכבר עברו ביקורת להבטחת תאימות לממשק ה-API יכולים למלא את הטופס הקצר הזה ולשלוח אותו כדי לבקש הרחבה של מכסת השאילתות שהוקצתה להם.
טופס ערעור: מפתחים שפרויקטים של ממשקי API שלהם לא עברו ביקורת תאימות (או שבקשתם להגדלת מכסת יחידות נדחתה) יכולים למלא את הטופס הזה ולשלוח אותו.
טופס שינוי בשליטה: מפתחים או כל צד שמפעיל לקוח API מטעם מפתח, שחווים שינוי בשליטה (למשל, בעקבות רכישה או מכירה של מניות, מיזוג או כל צורה אחרת של עסקה תאגידית) שקשור לפרויקט API, חייבים למלא את הטופס הזה ולשלוח אותו. כך צוות ה-API של YouTube יכול לעדכן את הרשומות שלנו, לבדוק את התאימות של תרחיש השימוש בפרויקט ה-API החדש ולבדוק את הקצאת המכסה הנוכחית של המפתח.

כל טופס חדש יספק לנו מידע על השימוש המיועד שלך ב-API של YouTube, ויאפשר לנו לסייע לך בצורה טובה יותר.

פרטים נוספים זמינים במדריך החדש שלנו בנושא ביקורות תאימות ל-API.

‫12 במאי 2021

הערה: זוהי הודעה על הוצאה משימוש.

העדכון הזה כולל את השינויים הבאים ב-API:

המאפיין contentDetails.relatedPlaylists.favorites של המשאב channel יצא משימוש. הפסקנו את התמיכה בתכונה 'סרטונים מועדפים' כבר לפני כמה שנים, כפי שצוין בערך בהיסטוריית הגרסאות מ-28 באפריל 2016.

לפני העדכון הזה, ה-API עדיין היה יוצר פלייליסט חדש אם לקוח API ניסה להוסיף סרטון לפלייליסט מועדפים שלא קיים. מעכשיו, הפלייליסט לא ייווצר במקרה הזה וה-API יחזיר שגיאה. בנוסף, ניסיונות לשנות את רשימות ההשמעה של המועדפים על ידי הוספה, שינוי או מחיקה של פריטים הוצאו משימוש בהתאם להודעות קודמות, ויכול להיות שיתחילו להחזיר שגיאות בכל שלב.
המאפיינים הבאים של משאב channel הוצאו משימוש. הנכסים האלה כבר לא נתמכים בממשק המשתמש של YouTube Studio וב-YouTube. לכן, אין יותר תמיכה בהן דרך ה-API.
- brandingSettings.channel.defaultTab
- brandingSettings.channel.featuredChannelsTitle
- brandingSettings.channel.featuredChannelsUrls[]
- brandingSettings.channel.profileColor
- brandingSettings.channel.showBrowseView
- brandingSettings.channel.showRelatedChannels
כל הנכסים הוסרו מchannel ייצוג המשאב, וההגדרות שלהם הוסרו מרשימת הנכסים של המשאב. בנוסף, שגיאות שמשויכות למאפיינים האלה הוסרו מהמסמכים שמתייחסים לשיטות ספציפיות.
המאפיינים הבאים של משאב channelSection הוצאו משימוש. הנכסים האלה כבר לא נתמכים בממשק המשתמש של YouTube Studio וב-YouTube. לכן, אין יותר תמיכה בהן דרך ה-API.
- snippet.style
- snippet.defaultLanguage
- snippet.localized.title
- localizations
- localizations.(key)
- localizations.(key).title
- targeting
- targeting.languages[]
- targeting.regions[]
- targeting.countries[]
בנוסף לשינוי הזה, הוצא משימוש הפרמטר hl של השיטה channelSection.list, כי התכונות שהוא תומך בהן לא אפשריות.

כל הנכסים הוסרו מchannelSection ייצוג המשאב, וההגדרות שלהם הוסרו מרשימת הנכסים של המשאב. בנוסף, שגיאות שמשויכות למאפיינים האלה הוסרו מהמסמכים שמתייחסים לשיטות ספציפיות.
הערכים הבאים של המאפיין snippet.type במשאב channelSection הוצאו משימוש. הערכים האלה כבר לא נתמכים בדפי הערוצים ב-YouTube, ולכן הם גם לא נתמכים יותר דרך ה-API.
- likedPlaylists
- likes
- postedPlaylists
- postedVideos
- recentActivity
- recentPosts
המאפיין snippet.tags[] של המשאב playlist יצא משימוש. הנכס הזה כבר לא נתמך ב-YouTube, ולכן הוא כבר לא נתמך דרך ה-API.

‫9 בפברואר 2021

במשאב playlistItem יש תמיכה בשני מאפיינים חדשים:

snippet.videoOwnerChannelId המאפיין מזהה את מזהה הערוץ שהעלה את הסרטון לפלייליסט.
snippet.videoOwnerChannelTitle המאפיין מזהה את שם הערוץ שהעלה את הסרטון לפלייליסט.

‫28 בינואר 2021

העדכון הזה כולל את השינויים הבאים:

השיטות playlistItems.delete, playlistItems.insert, playlistItems.list, playlistItems.update, playlists.delete, playlists.list ו-playlists.update תומכות כולן בשגיאה חדשה playlistOperationUnsupported. השגיאה מתרחשת כשבקשה מנסה לבצע פעולה שלא מותרת לרשימת השמעה מסוימת. לדוגמה, משתמש לא יכול למחוק סרטון מהפלייליסט של הסרטונים שהוא העלה או למחוק את הפלייליסט עצמו.

בכל המקרים, השגיאה הזו מחזירה קוד תגובת HTTP 400 (בקשה שגויה).
השגיאות watchHistoryNotAccessible ו-watchLaterNotAccessible של השיטה playlistItems.list הוסרו מהתיעוד. אמנם אי אפשר לגשת להיסטוריית הצפייה ולרשימת הצפייה בהמשך של המשתמשים דרך ה-API, אבל ה-API לא מחזיר את השגיאות הספציפיות האלה.

‫15 באוקטובר 2020

הוספנו שני קטעים חדשים לכללי המדיניות למפתחים:

בסעיף III.E.4.i החדש מפורט מידע נוסף על הנתונים שנאספים ונשלחים דרך נגן YouTube המוטמע. אתם אחראים לכל נתוני משתמשים שאתם שולחים לנו דרך נגן מוטמע של YouTube לפני שהמשתמש יצר אינטראקציה עם הנגן כדי לציין כוונה להפעיל את התוכן. כדי להגביל את הנתונים שמשותפים עם YouTube לפני שהמשתמש יוצר אינטראקציה עם הנגן, צריך להגדיר את ההפעלה האוטומטית כ-false.
הסעיף החדש III.E.4.j מתייחס לבדיקת הסטטוס של תוכן שסומן כ'במיוחד לילדים' (MFK) לפני הטמעתו באתרים ובאפליקציות שלכם. אתם אחראים לדעת מתי סרטונים שמוטמעים בלקוח ה-API שלכם מיועדים לילדים, ולטפל בנתונים שנאספים מהנגן המוטמע בהתאם. לכן, לפני שמטמיעים תוכן בלקוח API באמצעות נגנים מוטמעים של YouTube, צריך לבדוק את סטטוס התוכן באמצעות YouTube Data API Service.

במדריך החדש איך בודקים את הסטטוס 'נוצר לילדים' של סרטון מוסבר איך לחפש את הסטטוס MFK של סרטון באמצעות YouTube Data API Service.

בנוסף לשינויים האלה, הוספנו תזכורת למסמכי התיעוד של פרמטרים של נגן מוטמע שמסבירה שאם מפעילים הפעלה אוטומטית, ההפעלה תתרחש ללא אינטראקציה של המשתמש עם הנגן. לכן, איסוף ושיתוף של נתוני הפעלה יתרחשו עם טעינת הדף.

‫8 באוקטובר 2020

העדכון הזה כולל שלושה שינויים קטנים שקשורים למשאב channel:

האובייקט snippet.thumbnails שמזהה את התמונות הממוזערות של הערוץ, עשוי להיות ריק בערוצים חדשים, ואכלוס שלו יכול להימשך עד יום אחד.
statistics.videoCount המאפיין הזה משקף את מספר הסרטונים הגלויים לכולם בערוץ בלבד, גם לבעלים. ההתנהגות הזו עקבית עם המספרים שמוצגים באתר YouTube.
יכול להיות שמילות מפתח של ערוץ, שמזוהות במאפיין brandingSettings.channel.keywords, ייחתכו אם הן חורגות מהאורך המקסימלי המותר של 500 תווים, או אם הן מכילות מרכאות לא מוצפנות ("). שימו לב שמגבלת 500 התווים היא לא מגבלה לכל מילת מפתח, אלא מגבלה על האורך הכולל של כל מילות המפתח. ההתנהגות הזו זהה לזו באתר YouTube.

9 בספטמבר 2020

הערה: זוהי הודעה על הוצאה משימוש.

העדכון הזה כולל את השינויים הבאים ב-API. כל השינויים ייכנסו לתוקף ב-9 בספטמבר 2020 או אחריו, שהוא התאריך של ההודעה הזו. לכן, מפתחים לא צריכים יותר להסתמך על אף אחת מהתכונות של ה-API שמפורטות בהמשך.

המשאבים, השיטות, הפרמטרים ומאפייני המשאבים הבאים של ה-API הוצאו משימוש באופן מיידי, ויפסיקו לפעול בתאריך ההודעה הזו או אחריו:
- המאפיינים הבאים של משאב channel:
  - הנכס statistics.commentCount
  - האובייקט brandingSettings.image וכל הנכסים המשניים שלו
  - brandingSettings.hintsהרשימה וכל נכסי הצאצאים שלה
- הפרמטר categoryId של המסנן של השיטה channels.list
- המקור guideCategories והשיטה guideCategories.list
תשובות ה-API לשיטה channels.list לא מכילות יותר את המאפיין prevPageToken אם הפרמטר managedByMe מוגדר בבקשת ה-API עם הערך true. השינוי הזה לא משפיע על המאפיין prevPageToken בבקשות אחרות של channels.list, והוא לא משפיע על המאפיין nextPageToken בבקשות כלשהן.
המאפיינים contentDetails.relatedPlaylists.watchLater ו-contentDetails.relatedPlaylists.watchHistory של המשאב channel הוכרזו כמאפיינים שיצאו משימוש ב-11 באוגוסט 2016. התמיכה בשיטות playlistItems.insert ו-playlistItems.delete עבור רשימות ההשמעה האלה הוצאה משימוש באופן מלא, ושני המאפיינים הוסרו מהמסמכים.
הפרמטר mySubscribers של השיטה channels.list, שהודענו על הוצאתו משימוש ב-30 ביולי 2013, הוסר מהתיעוד. משתמשים בשיטה subscriptions.list ובפרמטר mySubscribers שלה כדי לאחזר רשימה של מנויים לערוץ של המשתמש המאומת.
הוסר מהתיעוד האובייקט invideoPromotion של המשאב channel וכל מאפייני הצאצא שלו, שהודענו על הוצאתם משימוש ב-27 בנובמבר 2017.

‫29 ביולי 2020

פישטנו את התהליך שלנו לחיוב מכסה עבור בקשות API, והסרנו את העלות הנוספת שמשויכת לפרמטר part. החל מרגע זה, נחייב רק את העלות הבסיסית של השיטה שמופעלת. כאן אפשר למצוא מידע נוסף על המכסה הפשוטה.

המשמעות של השינוי הזה היא שרוב הקריאות ל-API יחויבו בעלות מכסה נמוכה יותר, בעוד שחלק מהקריאות ל-API עדיין יחויבו באותה עלות. השינוי הזה לא מגדיל את העלות של אף קריאה ל-API. בסך הכול, ההשפעה הסבירה היא שהמכסה שהוקצה לכם, שמופיע ב-מסוף Google Cloud, יספיק ליותר זמן.

מומלץ מאוד שכל המפתחים ישלימו ביקורת תאימות לפרויקטים שלהם כדי להבטיח גישה רציפה לשירותי ה-API של YouTube.

הערך הזה בהיסטוריית הגרסאות פורסם במקור ב-20 ביולי 2020.

28 ביולי 2020

כל הסרטונים שיועלו דרך נקודת הקצה videos.insert מפרויקטים לא מאומתים של API שנוצרו אחרי 28 ביולי 2020 יהיו מוגבלים למצב צפייה פרטי. כדי להסיר את ההגבלה הזו, כל פרויקט צריך לעבור ביקורת לאימות התאימות לתנאים ולהגבלות.

יוצרים שמשתמשים בלקוח API לא מאומת כדי להעלות סרטון יקבלו אימייל עם הסבר שהסרטון שלהם ננעל בסטטוס 'פרטי', ושהם יכולים להימנע מההגבלה אם ישתמשו בלקוח רשמי או בלקוח שעבר ביקורת.

פרויקטים של API שנוצרו לפני 28 ביולי 2020 לא מושפעים מהשינוי הזה בשלב הזה. עם זאת, מומלץ מאוד שכל המפתחים יעברו ביקורת תאימות בפרויקטים שלהם כדי להבטיח גישה רציפה לשירותי ה-API של YouTube.

21 ביולי 2020

[עודכן ב-28 ביולי 2020] העדכון של התיעוד שאליו מתייחסת הרשומה הזו בהיסטוריית הגרסאות פורסם מחדש ב-28 ביולי 2020.

אתמול פרסמנו עדכון במסמכי התיעוד שקשור לתהליך החיוב על מכסת האחסון. עם זאת, בגלל נסיבות בלתי צפויות, שינוי המכסה עדיין לא נכנס לתוקף. לכן, כדי לשמור על דיוק, ביטלנו את השינוי במסמכים. כדי למנוע בלבול, רשומת היסטוריית הגרסאות שמסבירה את השינוי הוסרה ותפורסם מחדש בעתיד הקרוב.

7 ביולי 2020

הערה: זוהי הודעה על הוצאה משימוש.

הפרמטרים autoLevels ו-stabilize של השיטה videos.insert הוצאו משימוש, ושני הפרמטרים הוסרו מהתיעוד. המערכת מתעלמת מהערכים שלהם, והם לא משפיעים על אופן העיבוד של סרטונים חדשים שמועלים.

‫15 ביוני 2020

המדריך החדש עמידה בדרישות המדיניות למפתחים של YouTube כולל הנחיות ודוגמאות שיעזרו לכם לוודא שלקוחות ה-API שלכם עומדים בחלקים ספציפיים של התנאים ודרישות המדיניות של שירותי ה-API של YouTube (התנאים וההגבלות של ה-API).

ההנחיות האלה מספקות תובנות לגבי האופן שבו YouTube אוכפת היבטים מסוימים של התנאים וההגבלות של ה-API, אבל הן לא מחליפות מסמכים קיימים. במדריך הזה ריכזנו תשובות לכמה מהשאלות הנפוצות ביותר שמפתחים שואלים במהלך ביקורות תאימות ל-API. אנחנו מקווים שהמידע הזה יפשט את תהליך פיתוח התכונות שלכם, כי הוא יעזור לכם להבין איך אנחנו מפרשים את המדיניות שלנו ואוכפים אותה.

4 ביוני 2020

הערה: זהו עדכון להודעה קודמת על הוצאה משימוש.

התכונה 'לוח מודעות של הערוץ' הוצאה משימוש באופן מלא. השינוי הזה הוכרז לראשונה ב-17 באפריל 2020, ועכשיו הוא נכנס לתוקף. לכן, השיטה activities.insert לא נתמכת יותר, והשיטה activities.list לא מחזירה יותר הודעות לערוץ. פרטים נוספים זמינים במרכז העזרה של YouTube.

17 באפריל 2020

הערה: זוהי הודעה על הוצאה משימוש.

אנחנו מוציאים משימוש את התכונה 'לוח מודעות של הערוץ' ב-YouTube. לכן השיטה activities.insert תוצא משימוש, והשיטה activities.list תפסיק להחזיר הודעות בערוץ. השינויים האלה ייכנסו לתוקף ב-API ב-18 במאי 2020 או לאחר מכן. פרטים נוספים זמינים במרכז העזרה של YouTube.

31 במרץ 2020

העדכון הזה כולל את השינויים הבאים:

משאבים ושיטות חדשים
- המשאב החדש member מייצג חבר במועדון של ערוץ ב-YouTube. חברי המועדון תומכים ביוצרים באופן קבוע ומקבלים הטבות מיוחדות. לדוגמה, חברי המועדון יכולים לשוחח בצ'אט כשהיוצר מפעיל את המצב 'צ'אט לחברי מועדון בלבד'.
  
  המשאב הזה מחליף את המשאב sponsor שמתועד כחלק מ-YouTube Live Streaming API. המשאב sponsor הוצא משימוש, ולקוחות API צריכים לעדכן את הקריאות ל-method ‏sponsors.list כדי להשתמש במקום זאת ב-method ‏members.list.
- המשאב החדש membershipsLevel מזהה רמת תמחור שמנוהלת על ידי היוצר שאישר את בקשת ה-API. ה-method‏ membershipsLevels.list מאחזר רשימה של כל רמות החברות של היוצר.

‫10 בינואר 2020

ה-API תומך עכשיו באפשרות לזהות תוכן שמיועד לילדים, שנקרא ב-YouTube "במיוחד לילדים". מידע נוסף על תוכן עם הסיווג 'במיוחד לילדים' זמין במרכז העזרה של YouTube.

המשאבים channel ו-video תומכים בשני מאפיינים חדשים שמאפשרים ליוצרי תוכן ולצופים לזהות תוכן שנוצר במיוחד לילדים:

המאפיין selfDeclaredMadeForKids מאפשר ליוצרי תוכן לציין אם ערוץ או סרטון מיועדים לילדים.

לגבי ערוצים, אפשר להגדיר את המאפיין הזה כשמפעילים את השיטה channels.update. בסרטונים, אפשר להגדיר את המאפיין הזה כשקוראים לשיטות videos.insert או videos.update.

שימו לב: המאפיין הזה נכלל רק בתגובות של API שמכילות משאבי channel או video אם בעלי הערוץ אישרו את בקשת ה-API.
המאפיין madeForKids מאפשר לכל משתמש לאחזר את הסטטוס 'במיוחד לילדים' של ערוץ או של סרטון. לדוגמה, יכול להיות שהסטטוס ייקבע על סמך הערך של המאפיין selfDeclaredMadeForKids. מידע נוסף על הגדרת הקהל של הערוץ, הסרטונים או השידורים זמין במרכז העזרה של YouTube.

עדכנו גם את התנאים וההגבלות של שירותי ה-API של YouTube ואת כללי המדיניות למפתחים. מידע נוסף מופיע בהיסטוריית הגרסאות של התנאים וההגבלות של שירותי ה-API של YouTube. השינויים בתנאים ובהגבלות של שירותי YouTube API ובמדיניות למפתחים ייכנסו לתוקף ב-10 בינואר 2020, שעון החוף הפסיפי.

‫10 בספטמבר 2019

עדכנו את מסמכי העזר של ה-API כדי לשקף שינוי באופן שבו מדווחים על מספר המנויים ב-YouTube, וכתוצאה מכך בתגובות של ה-API. בעקבות השינוי, מספר המנויים שמוחזר על ידי YouTube Data API Service מעוגל כלפי מטה לשלוש ספרות משמעותיות, אם מספר המנויים גדול מ-1,000. השינוי הזה משפיע על המאפיין statistics.subscriberCount של המשאב channel.

הערה: השינוי הזה משפיע על ערך המאפיין הזה גם במקרים שבהם משתמש שולח בקשה מורשית לנתונים על הערוץ שלו. בעלי ערוצים עדיין יכולים לראות את מספר המנויים המדויק ב-YouTube Studio.

לדוגמה, אם לערוץ יש 123,456 מנויים, המאפיין statistics.subscriberCount יכיל את הערך 123000. בטבלה הבאה מופיעות דוגמאות לאופן העיגול של מספר המנויים בתגובות של API, ולאופן הקיצור שלו בממשקי משתמש אחרים של YouTube שגלויים לכולם:

דוגמה למספר מנויים	YouTube Data API	ממשקי משתמש של YouTube שגלויים לכולם
1,234	1230	1.23K
12,345	12300	12.3K
123,456	123000	123K
1,234,567	1230000	1.23M
12,345,678	12300000	12.3M
123,456,789	123000000	123M

4 באפריל 2019

העדכון הזה כולל את השינויים הבאים:

עדכנו את מסמכי התיעוד של הפניית ה-API כדי להסביר טוב יותר תרחישי שימוש נפוצים לכל שיטה, וכדי לספק דוגמאות קוד דינמיות ואיכותיות באמצעות הווידג'ט APIs Explorer. דוגמה מופיעה במסמכי העזרה של השיטה channels.list. נוספו שני רכיבים חדשים לדפים שמתארים שיטות API:
- בעזרת הווידג'ט של APIs Explorer אפשר לבחור היקפי הרשאה, להזין ערכים לדוגמה של פרמטרים ומאפיינים, ואז לשלוח בקשות API בפועל ולראות תגובות API בפועל. בנוסף, הווידג'ט מציע תצוגה במסך מלא שבה מוצגות דוגמאות קוד מלאות, שמתעדכנות באופן דינמי בהתאם להיקפי ההרשאות ולערכים שהזנתם.
- בקטע תרחישים נפוצים לדוגמה מתואר תרחיש נפוץ אחד או יותר לשימוש בשיטה שמוסברת בדף. לדוגמה, אפשר להפעיל את השיטה channels.list כדי לאחזר נתונים על ערוץ ספציפי או על הערוץ של המשתמש הנוכחי.
  
  אפשר להשתמש בקישורים שבקטע הזה כדי לאכלס את API Explorer בערכים לדוגמה לתרחיש השימוש שלכם, או כדי לפתוח את API Explorer במסך מלא כשהערכים האלה כבר מאוכלסים. המטרה של השינויים האלה היא להקל עליכם לראות דוגמאות לקוד שרלוונטיות ישירות לתרחיש השימוש שאתם מנסים להטמיע באפליקציה שלכם.
דוגמאות קוד נתמכות כרגע בשפות Java,‏ JavaScript,‏ PHP,‏ Python ו-curl.
גם הכלי דוגמאות קוד עודכן עם ממשק משתמש חדש שמציע את כל התכונות שמתוארות למעלה. באמצעות הכלי הזה, אפשר לבחון תרחישי שימוש לשיטות שונות, לטעון ערכים ל-APIs Explorer ולפתוח את APIs Explorer במסך מלא כדי לקבל דוגמאות קוד ב-Java,‏ JavaScript,‏ PHP ו-Python.

בנוסף לשינוי הזה, הסרנו את הדפים שבהם הופיעו בעבר דוגמאות קוד זמינות ל-Java,‏ JavaScript,‏ PHP ו-Python.
המדריכים למתחילים בנושא Java,‏ JavaScript,‏ PHP ו-Python עודכנו. במדריכים המעודכנים מוסבר איך להריץ דוגמה אחת עם מפתח API ודוגמה אחרת עם מזהה לקוח OAuth 2.0 באמצעות דוגמאות קוד מ-APIs Explorer.

שימו לב שהשינויים שמתוארים למעלה מחליפים כלי אינטראקטיבי שנוסף למאמרי העזרה של ה-API בשנת 2017.

9 ביולי 2018

העדכון הזה כולל את השינויים הבאים:

העדפנו את ההגדרה של מאפיין snippet.thumbnails של משאב channel כדי לציין שכאשר מציגים תמונות ממוזערות באפליקציה, הקוד צריך להשתמש בכתובות ה-URL של התמונות בדיוק כפי שהן מוחזרות בתגובות של ה-API. לדוגמה, האפליקציה לא צריכה להשתמש בדומיין http במקום בדומיין https בכתובת URL שמוחזרת בתגובת API.

החל מיולי 2018, כתובות ה-URL של התמונות הממוזערות של הערוצים יהיו זמינות רק בדומיין https, שבו כתובות ה-URL מופיעות בתגובות של ה-API. אחרי פרק הזמן הזה, יכול להיות שיוצגו תמונות פגומות באפליקציה אם היא תנסה לטעון תמונות מ-YouTube מהדומיין http.
הערה: זוהי הודעה על הוצאה משימוש.

המאפיין recordingDetails.location.altitude של המשאב video יצא משימוש. אין הבטחה לכך שיוחזרו ערכים של סרטונים במאפיין הזה. באופן דומה, גם אם בקשות API ינסו להגדיר ערך לנכס הזה, יכול להיות שהנתונים הנכנסים לא יישמרו.

‫22 ביוני 2018

מדריך ההטמעה, שנקרא בעבר מדריך ההטמעה והמעבר, עודכן והוסרו ממנו ההוראות למעבר מ-v2 API ל-v3 API. בנוסף, הוסרו הוראות לתכונות שיצאו משימוש ב-v3 API, כמו סרטונים מועדפים.

‫27 בנובמבר 2017

העדכון הזה כולל את השינויים הבאים:

הערה: זוהי הודעה על הוצאה משימוש.

‫YouTube מפסיקה את התמיכה בתכונות סרטון מוצג ואתר מוצג, שנתמכות ב-API באמצעות אובייקט invideoPromotion של משאב channel. כתוצאה מכך, האובייקט הזה, כולל כל נכסי הצאצאים שלו, יוצא משימוש.

עדיין אפשר לאחזר ולהגדיר נתונים של invideoPromotion עד 14 בדצמבר 2017. אחרי התאריך הזה:
- ניסיונות לאחזר את החלק invideoPromotion כשמפעילים את channels.list יחזירו invideoPromotion ריק או לא יחזירו נתוני invideoPromotion בכלל.
- ניסיונות לעדכן נתוני invideoPromotion כשמבצעים קריאה ל-channels.update יחזירו תגובה של הצלחה עד 27 במאי 2018 לפחות, אבל הם יטופלו כבלי תפעול (no-ops), כלומר הם לא יבצעו עדכון בפועל.
אחרי 27 במאי 2018, יכול להיות שהבקשות האלה יחזירו הודעות שגיאה כדי לציין, לדוגמה, ש-invalidPromotion הוא חלק לא תקין.

‫16 בנובמבר 2017

העדכון הזה כולל את השינויים הבאים:

כלי קטע הקוד האינטראקטיבי תומך עכשיו בדוגמאות קוד של Node.js. הדוגמאות מופיעות גם במסמכי התיעוד של כמעט כל ה-methods של ה-API, כמו ה-method channels.list.

הדוגמאות שניתנות להתאמה אישית נועדו לספק לכם נקודת התחלה ספציפית לתרחיש שימוש עבור אפליקציית Node.js. הפונקציונליות דומה לקוד שבמדריך למתחילים בנושא Node.js. עם זאת, הדוגמאות מכילות כמה פונקציות עזר שלא מופיעות בהפעלה המהירה:
- הפונקציה removeEmptyParameters מקבלת רשימה של צמדי מפתח-ערך שמתאימים לפרמטרים של בקשת API, ומסירה את הפרמטרים שלא הוגדרו להם ערכים.
- הפונקציה createResource מקבלת רשימה של צמדי מפתח/ערך שמתאימים למאפיינים במשאב API. לאחר מכן, המערכת ממירה את המאפיינים לאובייקט JSON שאפשר להשתמש בו בפעולות insert ו-update. בדוגמה הבאה מוצגת קבוצה של שמות מאפיינים וערכים, ואובייקט ה-JSON שהקוד ייצור עבורם:
```
# Key-value pairs:
{'id': 'ABC123',
 'snippet.title': 'Resource title',
 'snippet.description': 'Resource description',
 'status.privacyStatus': 'private'}

# JSON object:
{
 'id': 'ABC123',
 'snippet': {
   'title': 'Resource title',
   'description': 'Resource description',
 },
 'status': {
   'privacyStatus': 'private'
 }
}
```
כל הדוגמאות האלה מיועדות להורדה ולהרצה מקומית. מידע נוסף זמין במאמר בנושא דרישות מוקדמות להפעלת דוגמאות קוד מלאות באופן מקומי בהוראות לשימוש בכלי קטע קוד.

‫25 באוקטובר 2017

העדכון הזה כולל את השינויים הבאים:

דוגמאות הקוד ב-Python בכלי האינטראקטיבי לקטעי קוד עודכנו כך שישתמשו בספריות google-auth ו-google-auth-oauthlib במקום בספרייה oauth2client, שהוצאה משימוש.

בנוסף לשינוי הזה, הכלי מספק עכשיו דוגמאות מלאות של קוד לאפליקציות Python מותקנות ולאפליקציות שרת אינטרנט של Python, שמשתמשות בתהליכי הרשאה שונים במקצת. כדי לראות את הדוגמאות המלאות (ואת השינוי הזה):
1. עוברים אל כלי קטעי הקוד האינטראקטיביים או אל מאמרי העזרה של כל method ב-API, כמו method‏ channels.list.
2. לוחצים על הכרטיסייה Python שמעל לדוגמאות הקוד.
3. כדי לעבור מתצוגת קטע לתצוגת דוגמה מלאה, לוחצים על המתג שמעל הכרטיסיות.
4. בכרטיסייה אמורה להופיע עכשיו דוגמת קוד מלאה שמשתמשת בתהליך ההרשאה של InstalledAppFlow. התיאור שמעל הדוגמה מסביר את זה, וכולל גם קישור לדוגמה של אפליקציית שרת אינטרנט.
5. לוחצים על הקישור כדי לעבור לדוגמה של שרת האינטרנט. בדוגמה הזו נעשה שימוש ב-Flask, מסגרת של אפליקציית אינטרנט, ובתהליך הרשאה שונה.
כל הדוגמאות האלה מיועדות להורדה ולהרצה מקומית. אם רוצים להריץ את הדוגמאות, אפשר לעיין בהוראות להפעלת דוגמאות קוד מלאות באופן מקומי בהוראות של הכלי 'קטעי קוד'.

‫29 באוגוסט 2017

העדכון הזה כולל את השינויים הבאים:

העדפנו את ההגדרה של הפרמטר forContentOwner של השיטה search.list, והוספנו הערה שאם הפרמטר הזה מוגדר ל-true, הפרמטר type חייב להיות מוגדר ל-video.
העדפנו את ההגדרה של הפרמטר regionCode של השיטה search.list כדי להבהיר שהפרמטר מגביל את תוצאות החיפוש לסרטונים שאפשר לצפות בהם באזור שצוין.
הלוגו והסמלים של המיתוג של YouTube עודכנו. אפשר להוריד את הלוגו החדש 'פותח באמצעות YouTube' מדף הנחיות המיתוג. בדף הזה מוצגים גם סמלי לוגו וסמלים חדשים אחרים של YouTube, שאפשר להוריד מאתר המותג של YouTube.

‫24 ביולי 2017

העדכון הזה כולל את השינויים הבאים:

מדריך חדש למתחילים ב-YouTube Data API זמין ל-iOS. במדריך הזה מוסבר איך להשתמש ב-YouTube Data API באפליקציית iOS פשוטה שנכתבה ב-Objective-C או ב-Swift.
כלי קטעי הקוד האינטראקטיביים ל-YouTube Data API כולל עכשיו תיעוד שמסביר חלק מהתכונות של הכלי:
- ביצוע בקשות API
- מעבר בין קטעי קוד לבין דוגמאות קוד מלאות
- שימוש בפונקציות מוכנות מראש
- טעינה של משאבים קיימים (לשיטות עדכון)
הערה: הכלי מוטמע גם במאמרי העזרה של ה-API ל-methods של API (דוגמה).

‫1 ביוני 2017

העדכון הזה כולל את השינויים הבאים:

הערה: זוהי הודעה על הוצאה משימוש.

מאפייני המשאבים הבאים של video יוצאים משימוש. המאפיינים ייתמכו עד 1 בדצמבר 2017, אבל אין ערובה לכך שהסרטונים ימשיכו להחזיר ערכים למאפיינים האלה עד אז. באופן דומה, בקשות videos.insert ו-videos.update שמגדירות את ערכי הנכס האלה לא יגרמו לשגיאות לפני התאריך הזה, אבל יכול להיות שהנתונים הנכנסים לא יישמרו.

‫17 במאי 2017

העדכון הזה כולל את השינויים הבאים:

עדכנו את מאמרי העזרה של ה-API כדי להוסיף קטעי קוד אינטראקטיביים בכל מקום. בדפים שמסבירים על שיטות API, כמו channels.list או videos.rate, יש עכשיו כלי אינטראקטיבי שמאפשר לכם לראות ולהתאים אישית קטעי קוד ב-Java,‏ JavaScript,‏ PHP,‏ Python,‏ Ruby,‏ Apps Script ו-Go.

לכל שיטה, הכלי מציג קטעי קוד לתרחיש שימוש אחד או יותר, וכל תרחיש שימוש מתאר דרך נפוצה לקריאה לשיטה הזו. לדוגמה, אפשר לקרוא לשיטה channels.list כדי לאחזר נתונים על ערוץ ספציפי או על הערוץ של המשתמש הנוכחי.

אפשר גם לבצע פעולות בדוגמאות קוד:
- משנים את ערכי הפרמטרים והמאפיינים, וקטעי הקוד מתעדכנים באופן דינמי כדי לשקף את הערכים שסיפקתם.
- אפשר לעבור בין קטעי קוד לבין דוגמאות מלאות. קטע קוד שמציג את החלק בקוד שקורא לשיטת ה-API. דוגמה מלאה מכילה את קטע הקוד הזה וגם קוד boilerplate לאישור ולשליחת בקשות. אפשר להעתיק דוגמאות מלאות ולהריץ אותן משורת הפקודה או משרת אינטרנט מקומי.
- הפעלת בקשות בלחיצה על לחצן. (כדי להריץ בקשות, צריך לאשר לכלי לקרוא ל-API בשמכם).
שימו לב: הכלי הזה החליף את APIs Explorer בדפים שבהם הוא זמין. (בכל דף מוצג קישור, כך שיש לכם גם אפשרות לטעון את הבקשה שאתם עובדים עליה בכלי APIs Explorer).
גם הכלי Data API Code Snippets עודכן עם ממשק משתמש חדש שמציע את כל התכונות שמתוארות למעלה. התכונות החדשות העיקריות שזמינות בדף הזה הן:
- תמיכה בבקשות API שכותבות נתונים.
- תמיכה בדוגמאות של Java.
- קוד boilerplate גמיש ומקיף יותר לאישור משתמשים ולבניית בקשות API.

‫27 באפריל 2017

העדכון הזה כולל את השינויים הבאים:

במדריכים החדשים למתחילים מוסבר איך להגדיר אפליקציה פשוטה ששולחת בקשות ל-YouTube Data API. מדריכים זמינים כרגע עבור Android,‏ Apps Script,‏ Go,‏ Java,‏ JavaScript,‏ Node.js,‏ PHP,‏ Python ו-Ruby.

‫30 במרץ 2017

העדכון הזה כולל את השינויים הבאים:

המאפיין החדש topicDetails.topicCategories[] של רכיב channel מכיל רשימה של כתובות URL בוויקיפדיה שמתארות את התוכן של הערוץ. כתובות ה-URL תואמות למזהי הנושאים שמוחזרים במאפיין topicDetails.topicIds[] של המשאב.
המאפיין החדש playlistItem של משאב playlistItem מציין את השעה שבה הסרטון פורסם ב-YouTube.contentDetails.videoPublishedAt המשאב כבר מכיל את המאפיין snippet.publishedAt שמציין את הזמן שבו הפריט נוסף לפלייליסט.
בדומה למשאב channel, המשאב video מחזיר עכשיו את המאפיין topicDetails.topicCategories[], שמכיל רשימה של כתובות URL בוויקיפדיה שמתארות את התוכן של הסרטון. במשאבי video, כתובות ה-URL תואמות למזהי הנושאים שמוחזרים במאפיין topicDetails.relevantTopicIds[] של המשאב.
המאפיין החדש contentDetails.contentRating.mpaatRating של רכיב video מזהה את הדירוג שאיגוד Motion Picture Association of America (‏MPAA) העניק לטריילר או לתצוגה מקדימה של סרט.

‫27 בפברואר 2017

כפי שהודענו במקור ב-11 באוגוסט 2016, ב-YouTube עברנו מרשימה נתמכת של מזהי נושאים לרשימה שנבחרה בקפידה. הרשימה המלאה של מזהי הנושאים הנתמכים כלולה במאפיינים topicDetails של משאבי channel ו-video, וגם בפרמטר topicId של השיטה search.list.

שימו לב שבוצעו כמה שינויים ברשימה שנבחרה:

הנושאים הבאים נוספו כנושאי משנה של Society:

שם מזהה הנושא

עסקי /m/09s1f

בריאות /m/0kt51

צבא /m/01h6rj

פוליטיקה /m/05qt0

דת /m/06bvp
הנושא Animated cartoon, שהיה בעבר נושא צאצא של Entertainment, הוסר.
הנושא Children's music, שהיה בעבר נושא צאצא של Music, הוסר.

שם	מזהה הנושא
עסקי	`/m/09s1f`
בריאות	`/m/0kt51`
צבא	`/m/01h6rj`
פוליטיקה	`/m/05qt0`
דת	`/m/06bvp`

בעקבות השינוי הזה, נושאים שקשורים לסרטון תמיד מוחזרים בערך המאפיין topicDetails.relevantTopicIds[] של משאב video.

‫29 בנובמבר 2016

העדכון הזה כולל את השינויים הבאים:

ב-10 בפברואר 2017 יחולו שלושה שינויים קלים ברשימת מזהי הנושאים הנתמכים:
- הקטגוריה Professional wrestling, שהייתה בעבר קטגוריית צאצא של הקטגוריה Sports, היא עכשיו קטגוריית צאצא של Entertainment.
- הקטגוריה TV shows, שהיא צאצא של Entertainment, היא חדשה.
- הקטגוריה Health, שהייתה בעבר קטגוריית צאצא של Lifestyle, הוסרה.
חשוב גם לציין שיש כמה קטגוריות ראשיות (Entertainment,‏ Gaming,‏ Lifestyle,‏ Music ו-Sports). כל סרטון שמשויך לקטגוריית משנה, כמו Tennis, ישויך גם לקטגוריה הראשית (Sports).

‫10 בנובמבר 2016

העדכון הזה כולל את השינויים הבאים:

כפי שהודענו לראשונה ב-11 באוגוסט 2016, הוצאת Freebase ו-Freebase API משימוש מחייבת כמה שינויים שקשורים למזהי נושאים. מזהי הנושאים מזהים נושאים שמשויכים למשאבי channel ו-video, ואפשר גם להשתמש בפרמטר החיפוש topicId כדי למצוא ערוצים או סרטונים שקשורים לנושא מסוים.

ב-10 בפברואר 2017, YouTube יתחיל להחזיר קבוצה קטנה של מזהי נושאים במקום קבוצה גדולה יותר של מזהים שהוחזרה עד עכשיו. בנוסף, חשוב לזכור שאין ערוצים וסרטונים שמשויכים באופן אוטומטי לנושאים, וזה עולה בקנה אחד עם ההתנהגות הנוכחית של ה-API.

כדי שתוכלו להכין את לקוחות ה-API לשינויים האלה, עדכנו את ההגדרות של הפרמטרים והמאפיינים הבאים של ה-API, כך שיופיעו בהם מזהי הנושאים שיתמכו בהם אחרי התאריך הזה. שימו לב: רשימת הקטגוריות זהה לכל הנכסים.
- המאפיין topicDetails.topicIds[] של המשאב channel.
- המאפיין topicDetails.relevantTopicIds[] של המשאב video.
- הפרמטר topicId של השיטה search.list.
הערה: זוהי הודעה על הוצאה משימוש.

המאפיינים הבאים יוצאו משימוש:
- המאפיין topicDetails.topicIds[] של המשאב channel. הנכס הזה ייתמך עד 10 בנובמבר 2017.
- המאפיין topicDetails.relevantTopicIds[] של המשאב video. הנכס הזה ייתמך עד 10 בנובמבר 2017.
- המאפיין topicDetails.topicIds[] של המשאב video. המאפיין הזה לא יכיל ערכים אחרי 10 בפברואר 2017. (אחרי התאריך הזה, ערך המאפיין topicDetails.relevantTopicIds[] יזהה את כל הנושאים שמשויכים לסרטון).
מאחר ש-Freebase כבר הוצא משימוש, הסרנו את המדריך חיפוש באמצעות נושאי Freebase מהתיעוד. במדריך הזה סיפקנו דוגמאות קוד כדי להראות איך אפליקציה תפעל עם Freebase API.

בנוסף, הסרנו מהתיעוד של השיטה search.list כמה דוגמאות לקוד שקשורות למזהי נושאים.

‫2 בנובמבר 2016

העדכון הזה כולל את השינויים הבאים:

מאפיינים ופרמטרים חדשים
- במשאב video יש כמה מאפיינים חדשים:
  - המאפיין player.embedHtml מכיל תג <iframe> שאפשר להשתמש בו כדי להטמיע נגן שמפעיל את הסרטון. המאפיינים החדשים player.embedHeight ו-player.embedWidth מזהים את הממדים של נגן מוטמע. המאפיינים האלה מוחזרים רק אם בבקשת ה-API מצוין ערך לפחות לאחד מהפרמטרים maxHeight או maxWidth. בהמשך הרשומה הזו בהיסטוריית גרסאות מוסבר על שני הפרמטרים החדשים האלה.
  - המאפיין החדש hasCustomThumbnail מציין אם מעלה הסרטון סיפק תמונה ממוזערת מותאמת אישית לסרטון. הערה: המאפיין הזה גלוי רק למי שהעלה את הסרטון.
  - התג החדש fpbRatingReasons[] מציין את הסיבות לכך שהסרטון קיבל את הסיווג של FPB (דרום אפריקה).
  - התג החדש mcstRating מציין את הסיווג שהסרטון קיבל בווייטנאם.
- השיטה videos.list תומכת בשני פרמטרים חדשים: maxHeight ו-maxWidth. אפשר להשתמש בפרמטר אחד או בשני הפרמטרים כשמאחזרים את החלק player במשאבי video.
  
  כברירת מחדל, הגובה של <iframe> שמוחזר במאפיין player.embedHtml הוא 360px. הרוחב מותאם ליחס הגובה-רוחב של הסרטון, וכך מוודאים שבנגן המוטמע לא יופיעו פסים שחורים מסביב לסרטון. לדוגמה, אם יחס הגובה-רוחב של סרטון הוא 16:9, הרוחב של הנגן יהיה 640px.
  
  בעזרת הפרמטרים החדשים, אתם יכולים לציין שבמקום המידות שמוגדרות כברירת מחדל, קוד ההטמעה צריך להשתמש בגובה או ברוחב שמתאימים לפריסת האפליקציה שלכם. שרת ה-API משנה את מידות הנגן בהתאם כדי לוודא שלא יהיו פסים שחורים מסביב לסרטון בנגן המוטמע. שימו לב ששני הפרמטרים מציינים את הממדים המקסימליים של הנגן המוטמע. לכן, אם שני הפרמטרים מצוינים, יכול להיות שעדיין יהיה מימד אחד שקטן מהכמות המקסימלית שמותרת למימד הזה.
  
  לדוגמה, נניח שיחס הגובה-רוחב של סרטון הוא 16:9. לכן, התג player.embedHtml יכיל נגן בגודל 640x360 אם הפרמטר maxHeight או maxWidth לא מוגדר.
  - אם הפרמטר maxHeight מוגדר ל-720, והפרמטר maxWidth לא מוגדר, ממשק ה-API יחזיר נגן בגודל 1280x720.
  - אם הפרמטר maxWidth מוגדר לערך 960, והפרמטר maxHeight לא מוגדר, ממשק ה-API יחזיר נגן בגודל 960x540.
  - אם הפרמטר maxWidth מוגדר לערך 960, והפרמטר maxHeight מוגדר לערך 450, ממשק ה-API יחזיר נגן בגודל 800x450.
  המאפיינים החדשים player.embedHeight ו-player.embedWidth, שמתוארים למעלה, מזהים את המידות של נגן המדיה.
עדכונים לשיטות, לנכסים ולפרמטרים קיימים
- תיאור המשאב channelSection עודכן, ועכשיו מצוין בו שאפשר ליצור בערוץ עד 10 מדפים בלי להגדיר נתוני טירגוט, ועד 100 מדפים עם נתוני טירגוט.
  
  בנוסף, הנכס targeting של משאב channelSection עודכן כדי לשקף את העובדה שאפשר להגדיר אפשרויות מיקוד רק באמצעות ה-API. אפשרויות הטירגוט נמחקות אם משנים את קטע הערוץ באמצעות ממשק המשתמש באתר YouTube.
- ההגדרה של המאפיין i18nLanguage של משאב snippet.name תוקנה כדי לשקף שהערך מייצג את שם השפה כפי שהוא נכתב בשפה שצוינה בפרמטר hl של שיטת i18nLanguage.list.
- המאפיין contentDetails.note של המשאב playlistItem עודכן כדי לציין שהאורך המקסימלי של ערך המאפיין הוא 280 תווים.
- המאפיינים contentDetails.startAt ו-contentDetails.endAt של המשאב playlistItem יצאו משימוש. המערכת מתעלמת מהשדות האלה אם הם מוגדרים בבקשות playlistItems.insert או playlistItems.update.
- השיטות playlistItems.delete ו-playlistItems.update תומכות עכשיו בפרמטר onBehalfOfContentOwner, שכבר נתמך בכמה שיטות אחרות. גם בקשות שמשתמשות בשיטה הזו צריכות להיות מאושרות באמצעות אסימון שמעניק גישה להיקף https://www.googleapis.com/auth/youtubepartner.
- הפרמטרים publishedBefore ו-publishedAfter של השיטה search.list עודכנו כדי לציין שהערכים של הפרמטרים כוללים את הקצוות. לכן, לדוגמה, אם הפרמטר publishedBefore מוגדר, ה-API מחזיר משאבים שנוצרו לפני או בזמן שצוין.
- המאפיין contentDetails.contentRating.grfilmRating של משאב video תומך בשלושה ערכים נוספים: grfilmK12,‏ grfilmK15 ו-grfilmK18.
- תיארנו את השיטה videos.insert וציינו שגודל הקובץ המקסימלי של סרטונים שמועלים גדל מ-64GB ל-128GB.

שגיאות חדשות ומעודכנות

ה-API תומך בשגיאות החדשות הבאות:

סוג השגיאה	פרטי השגיאה	תיאור
`forbidden (403)`	`homeParameterDeprecated`	השגיאה הזו מוחזרת על ידי ה-method ‏`activities.list` כדי לציין שנתוני הפעילות בדף הבית של המשתמש לא זמינים דרך ה-API הזה. השגיאה הזו עשויה להתרחש אם הגדרתם את הפרמטר `home` לערך `true` בבקשה לא מורשית.
`invalidValue (400)`	`invalidContentDetails`	השיטה `playlistItems.insert` מחזירה את השגיאה הזו כדי לציין שהאובייקט `contentDetails` בבקשה לא תקין. אחת הסיבות להופעת השגיאה הזו היא שהשדה `contentDetails.note` ארוך מ-280 תווים.
`forbidden (403)`	`watchHistoryNotAccessible`	השיטה `playlistItems.list` מחזירה את השגיאה הזו כדי לציין שהבקשה ניסתה לאחזר פריטים מרשימת ההשמעה 'היסטוריית הצפייה', אבל אי אפשר לאחזר אותם באמצעות ה-API.
`forbidden (403)`	`watchLaterNotAccessible`	השגיאה הזו מוחזרת על ידי ה-method ‏`playlistItems.list` כדי לציין שהבקשה ניסתה לאחזר פריטים מהפלייליסט 'לצפייה בהמשך', אבל אי אפשר לאחזר אותם באמצעות ה-API.
`badRequest (400)`	`uploadLimitExceeded`	השגיאה הזו מוחזרת על ידי השיטה `videos.insert` כדי לציין שהערוץ חרג ממספר הסרטונים שהוא יכול להעלות.
`forbidden (403)`	`forbiddenEmbedSetting`	השגיאה הזו מוחזרת על ידי השיטה `videos.update` כדי לציין שבבקשת ה-API נעשה ניסיון להגדיר הגדרת הטמעה לא חוקית לסרטון. שימו לב: יכול להיות שבערוצים מסוימים לא תהיה הרשאה להציע נגנים מוטמעים לשידורים חיים. מידע נוסף זמין במרכז העזרה של YouTube.

השיטה playlistItems.insert כבר לא מחזירה שגיאה אם מוסיפים סרטון כפול לפלייליסט. בעבר, השגיאה הזו הופיעה בחלק מהפלייליסטים, כמו 'סרטונים מועדפים', שלא הייתה בהם אפשרות להוסיף סרטונים כפולים, אבל עכשיו אין יותר תמיכה בפלייליסטים האלה. באופן כללי, אפשר להוסיף סרטונים כפולים לפלייליסטים.

עדכונים אחרים
- עדכנו את הערך בהיסטוריית גרסאות מ-15 בספטמבר 2016 כדי להבהיר שבכל פעם שהמאפיינים contentDetails.relatedPlaylists.watchHistory ו-contentDetails.relatedPlaylists.watchLater של המשאב channel נכללים בתגובה, הם תמיד מכילים את הערכים HL ו-WL, בהתאמה. בנוסף, הנכסים האלה נכללים רק אם משתמש מורשה מאחזר נתונים על הערוץ שלו.

‫15 בספטמבר 2016

העדכון הזה כולל את השינויים הבאים:

בעדכון של היסטוריית הגרסאות מ-11 באוגוסט 2016, ציינו כמה שינויים שקשורים למזהי נושאים, כולל העובדה שקבוצת מזהי הנושאים הנתמכים תשתנה החל מ-10 בפברואר 2017. רשימת הנושאים שיתמכו בהם תפורסם עד 10 בנובמבר 2016.
השינויים הבאים נכנסו לתוקף. הודעה על השינויים האלה נמסרה בעדכון של היסטוריית הגרסאות ב-11 באוגוסט 2016:
- אם קוראים לשיטה activities.list כשהפרמטר home מוגדר לערך true, תגובת ה-API מכילה עכשיו פריטים דומים לאלה שמשתמש לא מחובר ב-YouTube רואה בדף הבית.
  
  זהו שינוי קל שמטרתו לספק חוויית משתמש טובה יותר מההתנהגות שתוארה בעדכון של היסטוריית הגרסאות מ-11 באוגוסט 2016. בעדכון הזה צוין שבקשות שמשתמשות בפרמטר home יחזירו רשימה ריקה.
- המאפיינים channel ו-contentDetails.relatedPlaylists.watchHistory של משאב contentDetails.relatedPlaylists.watchLater מכילים עכשיו את הערכים HL ו-WL, בהתאמה, לכל הערוצים.
  
  חשוב להבהיר שהמאפיינים האלה גלויים רק למשתמש מורשה שמקבל נתונים על הערוץ שלו. המאפיינים תמיד מכילים את הערכים HL ו-WL, גם אם מדובר במשתמש מורשה שמאחזר נתונים על הערוץ שלו. לכן, אי אפשר לאחזר את מזהי היסטוריית הצפייה והפלייליסט לצפייה בהמשך באמצעות ה-API.
  
  בנוסף, בקשות לאחזור פרטים של פלייליסט (playlists.list) או פריטים בפלייליסט (playlistItems.list) עבור היסטוריית הצפייה או הפלייליסט 'לצפייה בהמשך' של ערוץ מחזירות עכשיו רשימות ריקות. ההתנהגות הזו נכונה לגבי הערכים החדשים, HL ו-WL, וגם לגבי מזהים של היסטוריית צפייה או של רשימות השמעה של צפייה בהמשך, שאולי כבר אוחסנו על ידי לקוח ה-API.
האובייקט fileDetails.recordingLocation של המשאב video ומאפייני הצאצא שלו לא מוחזרים יותר. בעבר, רק הבעלים של הסרטון יכלו לאחזר את הנתונים האלה (למשל, אובייקט האב fileDetails).

‫11 באוגוסט 2016

העדכון הזה כולל את השינויים הבאים:

התנאים וההגבלות החדשים של שירותי ה-API של YouTube (להלן 'התנאים המעודכנים'), שמפורטים בבלוג של צוות ההנדסה והמפתחים של YouTube, כוללים מגוון רחב של עדכונים לתנאים ולהגבלות הנוכחיים. בנוסף לתנאים המעודכנים, שייכנסו לתוקף ב-10 בפברואר 2017, העדכון הזה כולל כמה מסמכים תומכים שמסבירים את המדיניות שמפתחים צריכים לפעול לפיה.

התיאור המלא של המסמכים החדשים מופיע בהיסטוריית הגרסאות של התנאים המעודכנים. בנוסף, היסטוריית הגרסאות תכלול הסברים על שינויים עתידיים בתנאים המעודכנים או במסמכים התומכים. אפשר להירשם לעדכונים בפיד RSS שכולל את השינויים בהיסטוריית הגרסאות באמצעות קישור במסמך.
הוצאה משימוש של Freebase ושל Freebase API גורמת לכמה שינויים שקשורים למזהי נושאים. מזהי הנושאים משמשים במשאבים ובשיטות הבאים של ה-API:
- החלק topicDetails של המשאב channel מזהה נושאים שמשויכים לערוץ.
- החלק video של המשאב topicDetails מזהה את הנושאים שמשויכים לסרטון.
- הפרמטר topicId של השיטה search.list מאפשר לחפש סרטונים או ערוצים שקשורים לנושא מסוים.
השינויים בתכונות האלה הם:
- החל מ-10 בפברואר 2017, מערכת YouTube תתחיל להחזיר קבוצה קטנה של מזהי נושאים במקום קבוצה מפורטת הרבה יותר של מזהים שהוחזרה עד עכשיו. הקבוצה הזו של נושאים נתמכים תזהה סיווגים ברמה גבוהה כמו ספורט או כדורסל, אבל היא לא תזהה קבוצות או שחקנים ספציפיים, למשל. אנחנו נפרסם את רשימת הנושאים הנתמכים כדי שיהיה לך זמן להכין את האפליקציה לשינוי הזה.
- אפשר להשתמש במזהי נושאים של Freebase שכבר אחזרתם כדי לחפש תוכן עד 10 בפברואר 2017. אבל אחרי התקופה הזו, תוכלו להשתמש רק בקבוצה הקטנה יותר של נושאים שזוהו בפריט הקודם כדי לאחזר תוצאות חיפוש לפי נושא.
- אחרי 10 בפברואר 2017, אם תנסו לחפש תוצאות באמצעות מזהה נושא שלא נמצא בקבוצה הקטנה יותר של מזהי נושאים נתמכים, ה-API יחזיר קבוצת תוצאות ריקה.
ב-12 בספטמבר 2016 יצאו משימוש כמה שדות ופרמטרים של API:
- הפרמטר home של השיטה home אפשר למשתמש מורשה לאחזר את עדכון הפעילות שיוצג בדף הבית של YouTube עבור אותו משתמש.activities.list בקשות שמשתמשות בפרמטר הזה אחרי 12 בספטמבר 2016 יחזירו רשימה ריקה.
- המאפיינים contentDetails.relatedPlaylists.watchHistory ו-contentDetails.relatedPlaylists.watchLater של רכיב channel גלויים רק למשתמש מורשה שמחלץ נתונים על הערוץ שלו. אחרי 12 בספטמבר 2016, הפונקציה contentDetails.relatedPlaylists.watchHistory תחזיר את הערך HL והמאפיין contentDetails.relatedPlaylists.watchLater יחזיר את הערך WL לכל הערוצים.
  
  בקשות לאחזור פרטים של פלייליסט (playlists.list) לגבי היסטוריית הצפייה או הפלייליסט 'לצפייה בהמשך' של ערוץ יחזירו רשימה ריקה אחרי 12 בספטמבר 2016. גם בקשות לאחזור פריטים בפלייליסט (playlistItems.list) באחד מהפלייליסטים האלה יחזירו רשימה ריקה אחרי הזמן הזה. זה נכון לגבי הערכים החדשים, HL ו-WL, וגם לגבי מזהים של היסטוריית צפייה או של פלייליסטים של 'לצפייה בהמשך' שאולי כבר נשמרו בלקוח ה-API שלכם.
- האובייקט fileDetails.recordingLocation או כל מאפיין צאצא שלו לא יוחזרו יותר אחרי 12 בספטמבר 2016.video רק הבעלים של הסרטון יכולים לאחזר את הנתונים האלה, כי רק הם יכולים לאחזר את אובייקט האב fileDetails.

‫13 ביוני 2016

העדכון הזה כולל את השינויים הבאים:

המאפיין contentDetails.googlePlusUserId של המשאב channel יצא משימוש. בעבר, המאפיין הזה היה קיים רק אם הערוץ היה משויך לפרופיל ב-Google+‎. אחרי ההוצאה משימוש, הנכס לא ייכלל יותר באף אחד מהמקורות של channel.
המאפיין snippet.authorGoogleplusProfileUrl של המשאב comment יצא משימוש. בעבר, המאפיין הזה היה קיים רק אם הערוץ היה משויך לפרופיל ב-Google+‎. אחרי ההוצאה משימוש, הנכס לא ייכלל יותר באף אחד מהמקורות של comment.

אף אחד מהנכסים האלה לא יוחזר אחרי הוצאתם משימוש, ולכן הסרנו את שניהם מהתיעוד של המשאב המתאים.

‫31 במאי 2016

העדכון הזה כולל את השינויים הבאים:

הפרמטר החדש myRecentSubscribers של השיטה subscriptions.list מאחזר רשימה של המנויים של הערוץ של המשתמש המאומת, בסדר כרונולוגי הפוך של הזמן שבו הם נרשמו כמנויים לערוץ.

שימו לב שהפרמטר החדש תומך רק באחזור של 1,000 המנויים האחרונים לערוץ של המשתמש המאומת. כדי לאחזר רשימה מלאה של מנויים, משתמשים בפרמטר mySubscribers. הפרמטר הזה לא מחזיר מנויים בסדר מסוים, והוא לא מגביל את מספר המנויים שאפשר לאחזר.
העדפנו את ההגדרה של המאפיין snippet.thumbnails.(key) במשאבים activity,‏ playlistItem,‏ playlist,‏ search result,‏ thumbnail ו-video כדי לציין שיש סרטונים שזמינים עבורם גדלים נוספים של תמונות ממוזערות.
- הרוחב של התמונה standard הוא 640 פיקסלים והגובה הוא 480 פיקסלים.
- התמונה maxres היא ברוחב של 1,280 פיקסלים ובגובה של 720 פיקסלים.
העדכנו את ההגדרה של הפרמטר part של השיטה channelSection.list כדי לציין שאפשר לאחזר את החלק targeting בעלות של 2 יחידות מכסה.
השיטה videos.list מחזירה עכשיו שגיאת forbidden (403) כשבקשה לא מורשית מנסה לאחזר את החלקים fileDetails, processingDetails או suggestions של משאב video. החלקים האלה זמינים רק לבעלים של הסרטון.

‫17 במאי 2016

הכלי החדש Data API Code Snippets מספק קטעי קוד קצרים לתרחישי שימוש נפוצים ב-YouTube Data API. כרגע, קטעי קוד זמינים לכל שיטות ה-API לקריאה בלבד ב-Apps Script, ‏ Go, ‏ JavaScript, ‏ PHP, ‏ Python ו-Ruby.

לכל שיטה, הכלי מציג דוגמאות קוד לתרחיש שימוש אחד או יותר. לדוגמה, הוא מספק חמישה קטעי קוד לשיטה search.list:

רשימת סרטונים לפי מילת מפתח
רשימת סרטונים לפי מיקום
רשימת אירועים בשידור חי
חיפוש סרטונים של המשתמש המאומת
רשימת סרטונים קשורים

לכל תרחיש שימוש, הכלי מציג את הפרמטרים שבהם נעשה שימוש בבקשת ה-API. אפשר לשנות את ערכי הפרמטרים, ובמקרה כזה הכלי מעדכן את קטעי הקוד כך שישקפו את ערכי הפרמטרים שסיפקתם.

לבסוף, הכלי מציג את תגובת ה-API לכל בקשה. אם שיניתם את פרמטרי הבקשה, תגובת ה-API תתבסס על ערכי הפרמטרים שסיפקתם. שימו לב: כדי שהתשובות של ה-API יוצגו, צריך לאשר לכלי לשלוח בקשות בשמכם.

‫28 באפריל 2016

העדכון הזה כולל את השינויים הבאים:

המאפיין החדש contentDetails.projection של רכיב video מציין את פורמט ההקרנה של הסרטון. ערכי המאפיין התקינים הם 360 ו-rectangular.
המאפיינים recordingDetails.location ו-fileDetails.recordingLocation במשאב video עודכנו כדי להסביר את ההבדל בין שני המאפיינים:
- המאפיין recordingDetails.location מזהה את המיקום שבעלי הסרטון רוצים לשייך לסרטון. אפשר לערוך את המיקום הזה, לחפש אותו בסרטונים שגלויים לכולם, והוא עשוי להיות מוצג למשתמשים בסרטונים שגלויים לכולם.
- ערך המאפיין fileDetails.recordingLocation הוא קבוע ומייצג את המיקום שמשויך לקובץ המקורי של הסרטון שהועלה. הערך הזה גלוי רק לבעלי הסרטון.
ההגדרה של מאפיין contentDetails.relatedPlaylists.favorites במשאב channel עודכנה. עכשיו מצוין בה שערך המאפיין עשוי להכיל מזהה של פלייליסט שמפנה לפלייליסט ריק, ושלא ניתן לאחזר אותו. הסיבה לכך היא שהפסקנו את התמיכה בפונקציונליות של סרטונים מועדפים. הערה: המאפיין הזה לא כפוף למדיניות הוצאת API משימוש.
ההגדרה של השגיאה ineligibleAccount, שיכולה להיות מוחזרת על ידי השיטה comments.insert, comments.update, commentThreads.insert או commentThreads.update, עודכנה כדי לשקף שהשגיאה מתרחשת כשחשבון YouTube שמשמש לאישור בקשת ה-API לא מוזג עם חשבון Google של המשתמש.

‫20 באפריל 2016

העדכון הזה כולל את השינויים הבאים:

העדפנו את ההגדרה של הפרמטר part של השיטה channels.update כדי לציין ש-localizations הוא גם ערך תקין של הפרמטר הזה.
הקטע Quota Usage במדריך Getting Started עודכן, ועכשיו יש בו קישור אל Google Developer's Console, שבו אפשר לראות את המכסה בפועל ואת השימוש במכסה.

‫16 במרץ 2016

העדכון הזה כולל את השינויים הבאים:

עדכונים למשאבים ולשיטות קיימים
- עדכנו את מסמכי המשאבים של channelBanner והוספנו בהם את הגודל המומלץ לתמונת הבאנר של הערוץ שמועלת: 2,560 פיקסלים על 1,440 פיקסלים. הגודל המינימלי (‎2,048px על ‎1,152px) לא השתנה.
- המאפיין החדש snippet.customUrl של משאב channel מזהה את כתובת ה-URL המותאמת אישית שמשויכת לערוץ. (לא לכל הערוצים יש כתובות URL מותאמות אישית). במרכז העזרה של YouTube מוסברות דרישות הסף לקבלת כתובת URL מותאמת אישית וגם איך להגדיר את כתובת ה-URL.
- הוצאנו משימוש את אובייקט brandingSettings.watch של המשאב channel ואת כל נכסי הצאצא שלו.
- תגובת ה-API לבקשת search.list מכילה עכשיו מאפיין regionCode. המאפיין מזהה את קוד האזור ששימש לשאילתת החיפוש. קוד האזור מורה ל-API להחזיר תוצאות חיפוש עבור המדינה שצוינה.
  ערך המאפיין הוא קוד מדינה בן שתי אותיות לפי תקן ISO שמזהה את האזור. השיטה i18nRegions.list מחזירה רשימה של אזורים נתמכים. ערך ברירת המחדל הוא US. אם מציינים אזור שלא נתמך, יכול להיות ש-YouTube עדיין יבחר אזור אחר, במקום ערך ברירת המחדל, כדי לטפל בשאילתה.
- הגדרות המאפיינים snippet.label ו-snippet.secondaryReasons[].label במשאב videoAbuseReportReason עודכנו, ועכשיו מצוין בהן שהמאפיינים מכילים טקסט של תווית מותאמת לשפה המקומית של הסיבות לדיווח על התנהלות פוגעת.
  
  בנוסף, השיטה videoAbuseReportReasons.list תומכת עכשיו בפרמטר hl, שמציין את השפה שבה צריך להשתמש בטקסט של התווית בתגובת ה-API. ערך ברירת המחדל של הפרמטר הוא en_US.
- המאפיין החדש contentDetails.contentRating.ecbmctRating של רכיב video מזהה את סיווג הסרטון מטעם מועצת ההערכה והסיווג של משרד התרבות והתיירות בטורקיה.
  
  בנוסף, מאפייני API של מערכות סיווג אחרות תומכים בערכי המאפיינים החדשים הבאים:
  - ‫contentDetails.contentRating.fpbRating (דרום אפריקה)
    סיווג: 10; ערך המאפיין: fpb10
  - contentDetails.contentRating.moctwRating (טייוואן)
    סיווג: R-12; ערך המאפיין: moctwR12
  - contentDetails.contentRating.moctwRating (טייוואן)
    סיווג: R-15; ערך מאפיין: moctwR15
- המאפיין liveStreamingDetails.activeLiveChatId של משאב video מכיל את המזהה של הצ'אט הפעיל בשידור חי שמשויך לסרטון. ערך המאפיין מופיע רק אם הסרטון הוא שידור חי נוכחי שהצ'אט בשידור חי מופעל בו. אחרי שהשידור מסתיים והצ'אט בשידור חי נסגר, המאפיין לא מוחזר יותר עבור הסרטון.
- המאפיין status.rejectionReason במשאב video תומך בערך המאפיין החדש legal.

ה-API תומך בשגיאות החדשות הבאות:

סוג השגיאה	פרטי השגיאה	תיאור
`badRequest (400)`	`notEditable`	השיטות `channelSections.insert`,‏ `channelSections.update` ו-`channelSections.delete` מחזירות את השגיאה הזו כדי לציין שלא ניתן ליצור, לעדכן או למחוק את קטע הערוץ שצוין.
`badRequest (400)`	`styleRequired`	השיטות `channelSections.insert` ו-`channelSections.update` מחזירות את השגיאה הזו כדי לציין שבמשאב `channelSection` שנשלח בבקשת ה-API צריך לציין ערך למאפיין `snippet.style`.
`badRequest (400)`	`typeRequired`	השיטות `channelSections.insert` ו-`channelSections.update` מחזירות את השגיאה הזו כדי לציין שבמשאב `channelSection` שנשלח בבקשת ה-API צריך לציין ערך למאפיין `snippet.type`.
`badRequest (400)`	`processingFailure`	השגיאה הזו מוחזרת על ידי השיטה `commentThreads.list` כדי לציין ששרת ה-API לא הצליח לעבד את הבקשה. יכול להיות שמדובר בשגיאה זמנית, אבל בדרך כלל היא מציינת שהקלט של הבקשה לא תקין. בודקים את המבנה של משאב `commentThread` בגוף הבקשה כדי לוודא שהוא תקין.
`forbidden (403)`	`commentsDisabled`	השגיאה הזו מוחזרת על ידי ה-method‏ `commentThreads.list` כדי לציין שהתגובות לסרטון שמוגדר על ידי הפרמטר `videoId` מושבתות.
`badRequest (400)`	`commentTextTooLong`	השיטה `commentThreads.insert` מחזירה את השגיאה הזו כדי לציין שבמשאב `comment` שמוסיפים יש יותר מדי תווים במאפיין `snippet.topLevelComment.snippet.textOriginal`.
`invalidValue (400)`	`videoAlreadyInAnotherSeriesPlaylist`	השיטה `playlistItems.insert` מחזירה את השגיאה הזו כדי לציין שהסרטון שאתם מנסים להוסיף לפלייליסט כבר נמצא בפלייליסט אחר של סדרה. מידע נוסף על פלייליסטים של סדרות זמין במרכז העזרה של YouTube.
`badRequest (400)`	`subscriptionForbidden`	השיטה `subscriptions.insert` מחזירה את השגיאה הזו כדי לציין שהגעתם למספר המינויים המקסימלי או שיצרתם יותר מדי מינויים לאחרונה. במקרה האחרון, אפשר לנסות לשלוח את הבקשה שוב אחרי כמה שעות.
`badRequest (400)`	`invalidCategoryId`	השיטה `videos.update` מחזירה את השגיאה הזו כדי לציין שמאפיין `snippet.categoryId` במשאב `video` שהועלה ציין מזהה קטגוריה לא תקין. אפשר להשתמש בשיטה `videoCategories.list` כדי לאחזר את הקטגוריות הנתמכות.
`badRequest (400)`	`invalidDescription`	השיטה `videos.update` מחזירה את השגיאה הזו כדי לציין שהמאפיין `snippet.description` במשאב `video` שהועלה ציין ערך לא חוקי.
`badRequest (400)`	`invalidPublishAt`	השיטה `videos.update` מחזירה את השגיאה הזו כדי לציין שהמאפיין `status.publishAt` במשאב `video` שהועלה מציין זמן פרסום מתוזמן לא חוקי.
`badRequest (400)`	`invalidRecordingDetails`	השיטה `videos.update` מחזירה את השגיאה הזו כדי לציין שאובייקט `recordingDetails` במשאב `video` שהועלה כולל פרטי הקלטה לא תקינים.
`badRequest (400)`	`invalidTags`	השיטה `videos.update` מחזירה את השגיאה הזו כדי לציין שהמאפיין `snippet.tags` במשאב `video` שהועלה ציין ערך לא חוקי.
`badRequest (400)`	`invalidTitle`	השיטה `videos.update` מחזירה את השגיאה הזו כדי לציין שהמאפיין `snippet.title` במשאב `video` שהועלה ציין שם סרטון לא תקין או ריק.
`badRequest (400)`	`invalidVideoMetadata`	השיטה `videos.update` מחזירה את השגיאה הזו כדי לציין שהמטא-נתונים של הבקשה לא תקינים. השגיאה הזו מתרחשת אם הבקשה מעדכנת את החלק `snippet` במשאב `video`, אבל לא מגדירה ערך למאפיינים `snippet.title` ו-`snippet.categoryId`.

‫18 בדצמבר 2015

חוקי האיחוד האירופי (EU) מחייבים להציג גילוי נאות מסוים למשתמשי קצה באיחוד האירופי ולקבל מהם הסכמה. לכן, אם אתם מציגים מודעות למשתמשי קצה באיחוד האירופי, אתם צריכים לפעול בהתאם למדיניות Google בנושא הסכמת משתמשים באיחוד האירופי. הוספנו הודעה על הדרישה הזו בתנאים ובהגבלות של ממשק ה-API של YouTube.

‫19 בנובמבר 2015

ה-API תומך עכשיו באפשרות להגדיר ולאחזר טקסט מותאם לשוק המקומי עבור המאפיינים snippet.title ו-snippet.description של המשאבים playlist ו-video, המאפיין snippet.title של המשאב channelSection והמאפיין snippet.description של המשאב channel.

הגדרת שמות ותיאורים מותאמים לשוק המקומי

אפשר להגדיר ערכים מותאמים לשפה ולמיקום של משאב כשמפעילים את השיטה insert או update עבור המשאב הזה. כדי להגדיר ערכים מותאמים לשפה ולמיקום של משאב, מבצעים את שתי הפעולות הבאות:
- מוודאים שמוגדר ערך למאפיין snippet.defaultLanguage של המשאב. המאפיין הזה מציין את השפה של המאפיינים snippet.title ו-snippet.description של המשאב. הערך שלו יכול להיות כל שפה נתמכת באפליקציה או רוב קודי השפה האחרים לפי תקן ISO 639-1:2002. לדוגמה, אם מעלים סרטון עם שם ותיאור באנגלית, צריך להגדיר את המאפיין snippet.defaultLanguage כ-en.
  
  הערה לגבי עדכון משאבי channel: כדי להגדיר את המאפיין snippet.defaultLanguage למשאב channel, צריך לעדכן את המאפיין brandingSettings.channel.defaultLanguage.
- מוסיפים את האובייקט localizations למקור המידע שרוצים לעדכן. כל מפתח אובייקט הוא מחרוזת שמזהה שפה של אפליקציה או קוד שפה לפי תקן ISO 639-1:2002, וכל מפתח ממופה לאובייקט שמכיל את השם המקומי (והתיאור) של המשאב.
  
  בדוגמה הבאה של קטע קוד, שפת ברירת המחדל של המשאב מוגדרת לאנגלית. הוא גם מוסיף לסרטון שמות ותיאורים שעברו לוקליזציה לגרמנית ולספרדית:
```
{
  "kind": "youtube#video",
  ...
  "snippet": {
    "title": "Playing soccer",
    "description": "We play soccer in the park on Sundays.",
    "defaultLanguage": "en",
    ...
  },
  "localizations":
    "de": {
      "title": "Fußball spielen",
      "description": "Wir spielen Fußball im Park am Sonntag"
    },
    "es": {
      "title": "Jugar al fútbol",
      "description": "Nosotros jugamos fútbol en el parque los domingos",
    }
  }
}
```
אחזור ערכים מותאמים לשוק המקומי

ה-API תומך בשתי דרכים לאחזור ערכים שמותאמים לשוק המקומי של משאב:
- מוסיפים את הפרמטר hl לבקשת channels.list, channelSections.list, playlists.list או videos.list כדי לאחזר נתונים מותאמים לשפה מסוימת של האפליקציה שאתר YouTube תומך בה (application language). אם פרטי משאב מקומיים זמינים בשפה הזו, אובייקט snippet.localized של המשאב יכיל את הערכים המקומיים. עם זאת, אם פרטים מותאמים לשוק המקומי לא זמינים, אובייקט snippet.localized יכיל פרטים על המשאב בשפת ברירת המחדל של המשאב.
  
  לדוגמה, נניח שבקשת videos.list אחזרה נתונים עבור הסרטון שמתואר למעלה עם נתונים שעברו לוקליזציה לגרמנית ולספרדית. אם הפרמטר hl מוגדר לערך de, המשאב יכיל את הנתונים הבאים:
```
{
  "kind": "youtube#video",
  ...
  "snippet": {
    "title": "Playing soccer",
    "description": "We play soccer in the park on Sundays.",
    "defaultLanguage": "en",
    "localized": {
      "title": "Fußball spielen",
      "description": "Wir spielen Fußball im Park am Sonntag"
    }
    ...
  }
}
```
  עם זאת, אם הפרמטר hl היה מוגדר ל-fr, האובייקט snippet.localized היה מכיל את השם והתיאור באנגלית, כי אנגלית היא שפת ברירת המחדל של המשאב, ופרטים מותאמים לצרפתית לא זמינים.
  
  חשוב: הפרמטר hl תומך רק בערכים שמזהים שפות של אפליקציות שאתר YouTube תומך בהן. כדי לבדוק אם יש טקסטים מותאמים לשפות אחרות, צריך לאחזר את החלק localizations של המשאב ולסנן כדי לראות אם יש טקסטים מותאמים.
  
  לדוגמה, צריך לאחזר את הרשימה המלאה של הלוקליזציות כדי לראות אם יש טקסטים מותאמים באנגלית אפלצ'ית.
- כשמאחזרים משאב, צריך לכלול את localizations בערך הפרמטר part כדי לאחזר את כל הפרטים המותאמים לשפה של המשאב הזה. אם אתם מאחזרים נתונים מותאמים לשפה מסוימת שאינה השפה הנוכחית של אפליקציית YouTube, אתם צריכים להשתמש בגישה הזו כדי לאחזר את כל הלוקליזציות ואז לסנן כדי לקבוע אם קיימים הנתונים המותאמים לשפה הרצויה.

שגיאות שקשורות לערכי טקסט מותאמים לשפה ולמיקום

ה-API תומך גם בשגיאות החדשות הבאות לגבי ערכי טקסט מותאמים לשפה ולמיקום:

סוג השגיאה	פרטי השגיאה	תיאור
`badRequest (400)`	`defaultLanguageNotSetError`	השגיאה הזו מציינת שבקשה שמנסה להוסיף או לעדכן את האובייקט `localizations` של משאב נכשלת כי המאפיין `snippet.defaultLanguage` לא מוגדר למשאב הזה. השגיאה הזו נתמכת בשיטות `channels.update`, `channelSections.insert`, `channelSections.update`, `playlists.insert`, `playlists.update`, `videos.insert` ו-`videos.update`.
`badRequest (400)`	`localizationValidationError`	השגיאה הזו מציינת שאחד מהערכים באובייקט `localizations` של משאב לא עבר אימות. לדוגמה, השגיאה הזו עשויה להתרחש אם האובייקט מכיל קוד שפה לא תקין. השגיאה הזו נתמכת בשיטות `channels.update`, `channelSections.insert`, `channelSections.update`, `playlists.insert` ו-`playlists.update`.

‫4 בנובמבר 2015

העדכון הזה כולל את השינויים הבאים:

עדכונים למשאבים ולשיטות קיימים
- הפרמטר order של השיטה search.list עודכן כדי לציין שאם ממיינים שידורים חיים לפי viewCount, תוצאות ה-API ממוינות לפי מספר הצופים בו-זמנית בשידורים בזמן שהם עדיין מתבצעים.
- הפרמטר relatedToVideoId של השיטה search.list עודכן. עכשיו מצוין שאם הפרמטר מוגדר, הפרמטרים האחרים היחידים שנתמכים הם part,‏ maxResults,‏ pageToken,‏ regionCode,‏ relevanceLanguage,‏ safeSearch,‏ type (שחייב להיות מוגדר כ-video) ו-fields. העדכון הזה לא משקף שינוי בהתנהגות של ה-API.
- העדפנו את ההגדרה של המאפיין snippet.publishedAt של משאב video כדי לציין שערך המאפיין, שמציין את התאריך והשעה שבהם הסרטון פורסם, עשוי להיות שונה מהשעה שבה הסרטון הועלה. לדוגמה, אם סרטון מועלה כסרטון פרטי ואז הופך לגלוי לכולם בשלב מאוחר יותר, ערך המאפיין מציין את השעה שבה הסרטון הפך לגלוי לכולם. ההגדרה המעודכנת מסבירה גם איך הערך מאוכלס עבור סרטונים פרטיים ולא רשומים.
  
  השינוי הזה לא משקף שינוי בהתנהגות של ה-API.
- ההגדרה של המאפיין status.publishAt במשאב video עודכנה, ועכשיו מצוין בה:
  - אם מגדירים את הערך של המאפיין הזה כשקוראים לשיטה videos.update, צריך להגדיר גם את הערך של המאפיין status.privacyStatus ל-private, גם אם הסרטון כבר פרטי.
  - אם הבקשה מתזמנת פרסום של סרטון למועד כלשהו בעבר, הסרטון יפורסם מיד. לכן, ההשפעה של הגדרת המאפיין status.publishAt לתאריך ולשעה בעבר זהה להשפעה של שינוי המאפיין privacyStatus של הסרטון מ-private ל-public.
- המאפיין contentDetails.contentRating.cncRating של רכיב video מציין את דירוג הסרטון מטעם הוועדה לסיווג סרטים בצרפת (Commission de classification cinematographique). המאפיין הזה מחליף את המאפיין contentDetails.contentRating.fmocRating, שיצא משימוש.
- ההגדרה של channel המשאב brandingSettings.channel.keywords עודכנה כדי לשקף בצורה נכונה שערך המאפיין מכיל רשימה של מחרוזות שמופרדות ברווחים, ולא רשימה שמופרדת בפסיקים, כפי שצוין במסמכים קודמים. העדכון הזה לא משקף שינוי בהתנהגות של ה-API.
- המסמכים של שיטת thumbnails.set עודכנו כדי לשקף בצורה מדויקת שגוף הבקשה מכיל את תמונת המיניאטורה שאתם מעלים ומשייכים לסרטון. גוף הבקשה לא מכיל משאב thumbnail. בעבר, במסמכים היה כתוב שאסור לספק גוף בקשה כשקוראים לשיטה הזו. העדכון הזה לא משקף שינוי בהתנהגות של ה-API.
- התיאור של משאב activity עודכן כדי לשקף את העובדה ששיטת activities.list לא כוללת כרגע משאבים שקשורים לתגובות חדשות לסרטונים. גם הערכים של snippet.type ו-contentDetails.comment במשאב עודכנו.

שגיאות חדשות ומעודכנות

ה-API תומך עכשיו בשגיאות הבאות:

פרטי השגיאה

activities.insert

קוד תגובת HTTP	`badRequest (400)`
סיבה	`invalidMetadata`
תיאור	הנכס `kind` לא תואם לסוג המזהה שצוין.

commentThreads.update
comments.insert
comments.update

קוד תגובת HTTP	`badRequest (400)`
סיבה	`commentTextTooLong`
תיאור	המאפיין `snippet.topLevelComment.snippet.textOriginal` במשאב `comment` שמוסיפים או מעדכנים מכיל יותר מדי תווים.

playlistItems.insert
playlistItems.update

קוד תגובת HTTP	`forbidden (403)`
סיבה	`playlistItemsNotAccessible`
תיאור	אין הרשאה מתאימה בבקשה להוספה, לעדכון או למחיקה של פריט הפלייליסט שצוין.

playlists.delete
playlists.insert
playlists.update

קוד תגובת HTTP	`badRequest (400)`
סיבה	`playlistForbidden`
תיאור	הפעולה הזו אסורה או שהבקשה לא אושרה כמו שצריך.

search.list

קוד תגובת HTTP	`badRequest (400)`
סיבה	`invalidLocation`
תיאור	הפורמט של ערך הפרמטר `location` או `locationRadius` שגוי.

search.list

קוד תגובת HTTP	`badRequest (400)`
סיבה	`invalidRelevanceLanguage`
תיאור	הפורמט של ערך הפרמטר `relevanceLanguage` שגוי.

subscriptions.insert

קוד תגובת HTTP	`badRequest (400)`
סיבה	`subscriptionForbidden`
תיאור	השגיאה הזו מתרחשת אם מתקיים אחד מהתנאים הבאים: המינוי שניסית ליצור כבר קיים כבר הגעת למספר המינויים המקסימלי ניסית להירשם לערוץ שלך, וזה לא אפשרי. יצרת יותר מדי מינויים לאחרונה, ולכן צריך להמתין כמה שעות לפני שמנסים שוב לשלוח את הבקשה.

videos.update

קוד תגובת HTTP	`badRequest (400)`
סיבה	`invalidDefaultBroadcastPrivacySetting`
תיאור	הבקשה מנסה להגדיר הגדרת פרטיות לא חוקית לשידור ברירת המחדל.

‫28 באוגוסט 2015

העדכון הזה כולל את השינויים הבאים:

עדכונים למשאבים ולשיטות קיימים
- המאפיין statistics.favoriteCount של המשאב video יצא משימוש.
  
  בהתאם למדיניות שלנו בנושא הוצאה משימוש, המאפיין הזה ימשיך להיכלל במשאבי video למשך שנה אחת לפחות אחרי ההודעה הזו. עם זאת, ערך המאפיין תמיד מוגדר עכשיו ל-0.

‫7 באוגוסט 2015

העדכון הזה כולל את השינויים הבאים:

עדכונים למשאבים ולשיטות קיימים
- העדכנו את ההגדרה של מאפיין video snippet.tags[] המשאב כדי לספק מידע נוסף על האופן שבו שרת ה-API מחשב את אורך הערך של המאפיין. הערה: העדכון הזה לא משקף שינוי בהתנהגות של ה-API.
  
  באופן ספציפי, ההגדרה מסבירה עכשיו שאם תג מכיל רווח, שרת ה-API מטפל בערך התג כאילו הוא תחום במירכאות, והמירכאות נספרות במגבלת התווים. לכן, לצורך מגבלות התווים, התג Foo-Baz מכיל שבעה תווים, אבל התג Foo Baz מכיל תשעה תווים.
- השיטה commentThreads.insert כבר לא תומכת בפרמטר shareOnGooglePlus, שבעבר ציין אם תגובה ותשובות לתגובה הזו צריכות להתפרסם גם בפרופיל Google+ של המחבר. אם הפרמטר נשלח בבקשה, שרת ה-API מתעלם מהפרמטר אבל מטפל בבקשה.

‫18 ביוני 2015

העדכון הזה כולל את השינויים הבאים:

עדכונים למשאבים ולשיטות קיימים
- הפרמטר החדש order של השיטה commentThreads.list מציין את הסדר שבו שרשורי התגובות צריכים להופיע בתגובת ה-API. אפשר למיין את השרשורים לפי זמן או רלוונטיות. ברירת המחדל היא לסדר אותם לפי זמן.
- המאפיין החדש snippet.defaultAudioLanguage של רכיב video מציין את השפה שמדוברת בטראק האודיו שמוגדר כברירת מחדל בסרטון.
- הגדרנו מחדש את המאפיין video של משאב contentDetails.licensedContent כדי להבהיר שהתוכן חייב להיות תוכן שהועלה במקור לערוץ שמקושר לשותף תוכן של YouTube, ושעליו הוגשה תלונה על ידי אותו שותף. השינוי הזה לא משקף שינוי בהתנהגות בפועל של ה-API.
- השיטות captions.delete,‏ captions.download,‏ captions.insert,‏ captions.list ו-captions.update תומכות עכשיו בפרמטר onBehalfOfContentOwner, שכבר נתמך בכמה שיטות אחרות. גם בקשות שמשתמשות בשיטה הזו צריכות להיות מאושרות באמצעות אסימון שמעניק גישה להיקף https://www.googleapis.com/auth/youtubepartner.

שגיאות חדשות ומעודכנות

ה-API תומך עכשיו בשגיאות הבאות:

פרטי השגיאה

videos.rate

קוד תגובת HTTP	`badRequest (400)`
סיבה	`emailNotVerified`
תיאור	המשתמשת צריכה לאמת את כתובת האימייל שלה לפני שהיא מדרגת את הסרטון.

videos.rate

קוד תגובת HTTP	`badRequest (400)`
סיבה	`videoPurchaseRequired`
תיאור	רק משתמשים ששכרו סרטונים יכולים לדרג אותם.

השיטות subscriptions.delete ו-subscriptions.insert כבר לא תומכות בשגיאות accountClosed ו-accountSuspended.

‫27 באפריל 2015

העדכון הזה כולל את השינויים הבאים:

משאבים ושיטות חדשים
- המשאב החדש videoAbuseReportReason מכיל מידע על הסיבה לסימון סרטון בגלל תוכן פוגעני. ה-method‏ videoAbuseReportReasons.list מאפשרת לאחזר רשימה של כל הסיבות האפשריות לסימון סרטונים.
- השיטה החדשה videos.reportAbuse מאפשרת לדווח על סרטון שמכיל תוכן פוגעני. גוף הבקשה מכיל אובייקט JSON שמציין את הסרטון שסומן ואת הסיבה לכך שהסרטון נחשב כתוכן פוגע. אפשר לקבל סיבות תקפות באמצעות השיטה videoAbuseReportReason.list שמתוארת למעלה.
  
  בנוסף, עדכנו את מדריך המיגרציה והוספנו דוגמה לדיווח על סרטון פוגע. בעקבות השינוי הזה, גרסה 3 של ה-API תומכת עכשיו בכל התכונות של גרסה 2 של ה-API שאמורות להיות נתמכות. במדריך להעברה מוסברות גם כל התכונות האלה.
עדכונים למשאבים ולשיטות קיימים
- פרמטר הסינון forDeveloper החדש של השיטה search.list מגביל את החיפוש כך שיוחזרו רק סרטונים שהועלו דרך האפליקציה או האתר של המפתח. אפשר להשתמש בפרמטר forDeveloper בשילוב עם פרמטרים אופציונליים לחיפוש, כמו הפרמטר q.
  
  במסגרת התכונה הזו, כל סרטון שמועלה מתויג באופן אוטומטי במספר הפרויקט שמשויך לאפליקציה של המפתח ב-Google Developers Console.
  
  כשבקשת חיפוש מגדירה בהמשך את הפרמטר forDeveloper לערך true, שרת ה-API משתמש בפרטי ההרשאה של הבקשה כדי לזהות את המפתח. לכן, מפתח יכול להגביל את התוצאות לסרטונים שהועלו דרך האפליקציה או האתר שלו, אבל לא לסרטונים שהועלו דרך אפליקציות או אתרים אחרים.
  
  התכונה החדשה מציעה פונקציונליות דומה, אבל לא זהה, לזו של תגי מפתח שנתמכו ב-API בגרסה 2.
- המאפיין החדש snippet.country של משאב channel מאפשר לבעלי ערוצים לשייך את הערוצים שלהם למדינה מסוימת.
  
  הערה: כדי להגדיר את המאפיין snippet.country למשאב channel, צריך לעדכן את המאפיין brandingSettings.channel.country.
- ה-API תומך עכשיו בטירגוט של משאבי channelSection. טירגוט לפי קטעים בערוץ מאפשר להגביל את החשיפה של קטע תוכן למשתמשים שעומדים בקריטריונים מסוימים.
  
  ה-API חושף שלוש אפשרויות טירגוט. כדי שקטע בערוץ יהיה גלוי, המשתמש צריך לעמוד בכל הגדרות הטירגוט.
  - ‫targeting.languages[]: רשימה של שפות באפליקציית YouTube. משתמשים שבחרו באחת מהשפות האלה יכולים לראות את הקטע המתאים בערוץ.
  - ‫targeting.regions[]: רשימה של אזורי תוכן מועדפים ב-YouTube. הקטע בערוץ גלוי למשתמשים שבחרו באחד מהאזורים האלה, וגם למשתמשים שאחד מהאזורים האלה נבחר עבורם באופן אוטומטי.
  - ‫targeting.countries[]: רשימה של מדינות שבהן קטע הערוצים גלוי. כל ערך ברשימה הוא קוד מדינה בן שתי אותיות לפי תקן ISO 3166-1 alpha-2.
- ההגדרה של המאפיין contentDetails.duration של המשאב video תוקנה כדי לשקף שהערך יכול לשקף שעות, ימים וכן הלאה.
- תיקנו את התיעוד של השיטות channelSections.delete,‏ playlistItems.delete,‏ playlists.delete,‏ subscriptions.delete ו-videos.delete כדי לשקף את העובדה שאם הפעולה מצליחה, כל השיטות האלה מחזירות קוד תגובה של HTTP ‏204 (No Content).

שגיאות חדשות ומעודכנות

ה-API תומך עכשיו בשגיאות הבאות:

סוג השגיאה	פרטי השגיאה	תיאור
`badRequest (400)`	`targetInvalidCountry`	השיטות `channelSections.insert` ו-`channelSections.update` מחזירות את השגיאה הזו אם המשאב `channelSection` שהוכנס הכיל ערך לא תקין במאפיין `targeting.countries[]`.
`badRequest (400)`	`targetInvalidLanguage`	השיטות `channelSections.insert` ו-`channelSections.update` מחזירות את השגיאה הזו אם המשאב `channelSection` שהוכנס הכיל ערך לא תקין במאפיין `targeting.languages[]`.
`badRequest (400)`	`targetInvalidRegion`	השיטות `channelSections.insert` ו-`channelSections.update` מחזירות את השגיאה הזו אם המשאב `channelSection` שהוכנס הכיל ערך לא תקין במאפיין `targeting.regions[]`.
`badRequest (400)`	`operationNotSupported`	השיטה `comments.insert` מחזירה את השגיאה הזו אם משתמש ה-API לא יכול להוסיף תגובה לתגובה ברמה העליונה שמזוהה על ידי המאפיין `snippet.parentId`. במשאב `commentThread`, המאפיין `snippet.canReply` מציין אם הצופה הנוכחי יכול להשיב לשרשור.
`badRequest (400)`	`invalidChannelId`	השיטה `search.list` מחזירה את השגיאה הזו אם הפרמטר `channelId` בבקשה מציין מזהה ערוץ לא תקין.
`badRequest (400)`	`subscriptionForbidden`	השיטה `subscriptions.insert` מחזירה את השגיאה הזו אם משתמש ה-API מנסה להירשם לערוץ שלו.

השיטה captions.update לא תומכת יותר בשגיאות invalidMetadata ו-videoNotFound.

‫16 באפריל 2015

העדכון הזה כולל את השינויים הבאים:

המדריך להעברה עודכן, ועכשיו מוסבר בו איך להעביר אפליקציות שעדיין משתמשות בפונקציונליות של הערות מ-API גרסה 2.

במדריך מפורטות גם כמה תכונות של הערות שלא נתמכו ב-API בגרסה 2, אבל נתמכות ב-API בגרסה 3. למשל:
- אחזור תגובות לגבי ערוץ
- אחזור של כל שרשורי התגובות שקשורים לערוץ, כלומר תגובות על הערוץ או על סרטונים בערוץ.
- עדכון הטקסט של תגובה
- סימון תגובה כספאם
- הגדרת סטטוס ניהול התגובות של תגובה
המדריך הרשמה לקבלת התראות בדחיפה עודכן כדי לשקף את העובדה שההתראות נדחפות רק למרכז של Google PubSubHubBub ולא גם למרכז של Superfeedr, כפי שצוין קודם.

‫9 באפריל 2015

העדכון הזה כולל את השינויים הבאים:

המשאבים החדשים commentThread ו-comment ב-API מאפשרים לאחזר, להוסיף, לעדכן, למחוק ולנהל תגובות.
- commentThread משאב מכיל מידע על שרשור תגובות ב-YouTube, שכולל תגובה ברמה העליונה ותגובות, אם יש כאלה, לתגובה הזו. משאב commentThread יכול לייצג תגובות על סרטון או על ערוץ.
  
  התגובה ברמה העליונה והתשובות הן למעשה משאבי comment שמוטמעים בתוך משאב commentThread. חשוב לציין שהמשאב commentThread לא מכיל בהכרח את כל התגובות לתגובה, ואם רוצים לאחזר את כל התגובות לתגובה מסוימת, צריך להשתמש בשיטה comments.list. בנוסף, לחלק מהתגובות אין תשובות.
  
  ה-API תומך בשיטות הבאות למשאבי commentThread:
  - ‫commentThreads.list – אחזור רשימה של שרשורי תגובות. אפשר להשתמש בשיטה הזו כדי לאחזר תגובות שמשויכות לסרטון או לערוץ מסוימים.
  - commentThreads.insert – יצירת תגובה חדשה ברמה העליונה. (משתמשים ב-comments.insert method כדי להשיב לתגובה קיימת).
  - ‫commentThreads.update – שינוי תגובה ברמה העליונה.
- משאב comment מכיל מידע על תגובה אחת ב-YouTube. משאב comment יכול לייצג תגובה על סרטון או על ערוץ. בנוסף, התגובה יכולה להיות תגובה ברמה העליונה או תשובה לתגובה ברמה העליונה.
  
  ה-API תומך בשיטות הבאות למשאבי comment:
  - ‫comments.list – אחזור רשימה של תגובות. משתמשים בשיטה הזו כדי לאחזר את כל התשובות לתגובה מסוימת.
  - comments.insert – יצירת תשובה לתגובה קיימת.
  - ‫comments.update – עריכת תגובה.
  - ‫comments.markAsSpam – סימון תגובה אחת או יותר כספאם.
  - ‫comments.setModerationStatus – הגדרת סטטוס הניהול של תגובה אחת או יותר. לדוגמה, לאשר תגובה להצגה לציבור או לדחות תגובה כי היא לא מתאימה להצגה. הבקשה ל-API צריכה להיות מאושרת על ידי הבעלים של הערוץ או הסרטון שמשויכים לתגובות.
  - ‫comments.delete – מחיקת תגובה.
שימו לב שנדרש היקף ההרשאות https://www.googleapis.com/auth/youtube.force-ssl החדש של ה-API, שמתואר בהיסטוריית הגרסאות מ-2 באפריל 2015, כדי לבצע קריאות לשיטות comments.insert,‏ comments.update,‏ comments.markAsSpam,‏ comments.setModerationStatus,‏ comments.delete,‏ commentThreads.insert ו-commentThreads.update.
במדריך החדש Subscribing to push notifications (הרשמה לקבלת התראות פוש) מוסבר על התמיכה החדשה של ה-API בהתראות פוש דרך PubSubHubBub, פרוטוקול פרסום/הרשמה משרת לשרת למשאבים שנגישים באינטרנט. שרת ה-callback של PubSubHubBub יכול לקבל התראות על פיד Atom כשמתבצעת בערוץ אחת מהפעולות הבאות:
- מעלה סרטון
- עדכון השם של סרטון
- מעדכן את תיאור הסרטון
בנוסף, המדריך להעברת נתונים עודכן וכולל עכשיו את התמיכה החדשה בהתראות פוש. עם זאת, מאחר ש-API v2 תמך בסוגים רבים אחרים של הודעות פוש שלא נתמכים ב-API v3, עדיין מצוין בקטע בנושא הוצאה משימוש במדריך הזה שיש תמיכה ב-PubSubHubBub.
ההיקף החדש של https://www.googleapis.com/auth/youtube.force-ssl API הוא עכשיו היקף תקף לכל שיטת API שתמכה קודם בהיקף https://www.googleapis.com/auth/youtube.

ה-API תומך עכשיו בשגיאות הבאות:

סוג השגיאה	פרטי השגיאה	תיאור
`badRequest (400)`	`invalidRating`	השיטה `videos.rate` מחזירה את השגיאה הזו אם הבקשה הכילה ערך לא צפוי לפרמטר `rating`.

השיטה subscriptions.insert לא תומכת יותר בשגיאה subscriptionLimitExceeded, שציינה בעבר שהמנוי שזוהה בבקשה חרג ממגבלת הקצב של המינוי.

‫2 באפריל 2015

העדכון הזה כולל את השינויים הבאים:

המשאב החדש captions מייצג רצועת כתוביות ב-YouTube. כל רצועת כתוביות משויכת לסרטון אחד בלבד ב-YouTube.

ה-API תומך בשיטות לרישום, הוספה, עדכון, הורדה ומחיקה של טראקים של כתוביות.
המדריך להעברה עודכן גם כדי להסביר איך להעביר אפליקציות שעדיין משתמשות בפונקציונליות של כתוביות ב-API בגרסה 2.
היקף ההרשאות החדש https://www.googleapis.com/auth/youtube.force-ssl של ה-API מחייב שהתקשורת עם שרת ה-API תתבצע דרך חיבור SSL.

היקף ההרשאות החדש מעניק את אותה גישה כמו היקף ההרשאות https://www.googleapis.com/auth/youtube. למעשה, שני היקפי ההרשאות האלה זהים מבחינה פונקציונלית, כי שרת YouTube API זמין רק דרך נקודת קצה של HTTPS. כתוצאה מכך, למרות שהיקף ההרשאות https://www.googleapis.com/auth/youtube לא דורש חיבור SSL, אין דרך אחרת לשלוח בקשת API.

ההיקף החדש נדרש לקריאות לכל ה-methods של המשאב caption.

‫11 במרץ 2015

העדכון הזה כולל את השינויים הבאים:

במדריך להעברת נתונים (מיגרציה) של YouTube Data API (גרסה 3) יש כרטיסייה חדשה בשם New in the v3 API (מה חדש בגרסה 3 של ה-API). בכרטיסייה הזו מפורטות התכונות שנתמכות בגרסה 3 של ה-API ושלא נתמכו בגרסה 2 של ה-API. אותן התכונות היו רשומות בעבר ועדיין רשומות בכרטיסיות אחרות במדריך. לדוגמה, התכונה החדשה שמסבירה איך לעדכן נתונים של קמפיין לקידום מכירות ב-In-video בערוץ מופיעה גם בכרטיסייה ערוצים (פרופילים).
מדריך ההעברה של YouTube Data API (גרסה 3) עודכן, ועכשיו מצוין בו שממשק v3 API יתמוך בתכונה הבאה של v2 API:
- סימון סרטון בדגל
המדריך להעברת נתונים (מיגרציה) של YouTube Data API (גרסה 3) עודכן, ומופיעה בו הערה שלפיה התכונות הבאות של API גרסה 2 לא יתמכו ב-API גרסה 3:
- אחזור המלצות על סרטונים – ב-API גרסה 3 לא מתבצע אחזור של רשימה שמכילה רק סרטונים שמומלצים למשתמש הנוכחי ב-API. עם זאת, אפשר להשתמש ב-API בגרסה 3 כדי למצוא סרטונים מומלצים על ידי קריאה ל-method‏ activities.list והגדרת ערך הפרמטר home ל-true.
  
  בתגובת ה-API, משאב מתאים לסרטון מומלץ אם הערך של המאפיין snippet.type הוא recommendation. במקרה כזה, המאפיינים contentDetails.recommendation.reason ו-contentDetails.recommendation.seedResourceId יכילו מידע על הסיבה להמלצה על הסרטון. חשוב לדעת שלא מובטח שהתגובה תכיל מספר מסוים של סרטונים מומלצים.
- אחזור הצעות לערוצים
- אחזור סרטונים חדשים מהמינויים – v3 API לא מאחזר רשימה שמכילה רק סרטונים שהועלו לאחרונה לערוצים שהמשתמש ב-API נרשם אליהם כמנוי. עם זאת, אפשר להשתמש ב-v3 API כדי למצוא סרטונים חדשים במינוי על ידי קריאה ל-method‏ activities.list והגדרת ערך הפרמטר home ל-true.
  
  בתגובת ה-API, משאב מתאים לסרטון חדש במינוי אם הערך של המאפיין snippet.type הוא upload. שימו לב: אין ערובה לכך שהתגובה תכיל מספר מסוים של סרטונים חדשים מהערוצים שנרשמתם אליהם כמנויים.
- תמיכה בפיד RSS
- התראות פוש לעדכוני פיד – גרסה 2 של ה-API תמכה בהתראות פוש באמצעות Simple Update Protocol‏ (SUP) או PubSubHubbub, כדי לעקוב אחרי פידים של פעילות משתמשים ב-YouTube. התראות נשלחו על הרשמות חדשות לערוץ, על דירוג סרטונים, על שיתוף סרטונים, על סימון סרטונים כמועדפים, על הוספת תגובות ועל העלאת סרטונים.
  
  ‫API גרסה 3 יתמוך בהתראות בדחיפה באמצעות פרוטוקול PubSubHubbub, אבל ההתראות יכללו רק העלאות של סרטונים ועדכונים של שמות סרטונים או תיאורי סרטונים.
- מיקום הערוץ – ב-API מגרסה 2 נעשה שימוש בתג <yt:location> כדי לזהות את מיקום המשתמש כפי שהוזן בפרופיל הציבורי של הערוץ ב-YouTube. חלק מהמפתחים השתמשו בשדה הזה כדי לשייך ערוץ למדינה מסוימת, אבל לא ניתן היה להשתמש בנתונים של השדה הזה באופן עקבי למטרה הזו.
- הגדרה או אחזור של תגי מפתחים – ב-API בגרסה 2 הייתה תמיכה באפשרות לשייך מילות מפתח או תגי מפתחים לסרטון בזמן ההעלאה שלו. תגי מפתחים לא יוצגו למשתמשי YouTube, אבל בעלי סרטונים יוכלו לאחזר סרטונים שתואמים לתג מפתח ספציפי.
  
  גרסה 3 של ה-API תספק תכונה דומה, אבל לא זהה. באופן ספציפי, מפתח יוכל לחפש סרטונים שהועלו על ידי האפליקציה שלו. במסגרת התכונה הזו, כל סרטון שמועלה מתויג באופן אוטומטי במספר הפרויקט שמשויך לאפליקציה של המפתח ב-Google Developers Console. לאחר מכן המפתח משתמש באותו מספר פרויקט כדי לחפש סרטונים.
- הצגת רשימת סרטונים לפי תאריך פרסום, מספר צפיות או דירוג – ב-v2 API, הפרמטר orderby מאפשר למיין סרטונים בפלייליסט לפי מיקום, משך, תאריך פרסום, שם ועוד כמה ערכים. ב-API בגרסה 3, פריטים בפלייליסט ממוינים בדרך כלל לפי מיקום בסדר עולה, ולא זמינות אפשרויות מיון אחרות.
  
  יש כמה מקרים חריגים. סרטון חדש שהועלה, סרטון שנוסף למועדפים, סרטון שאהבתם או סרטון שצפיתם בו לאחרונה יתווספו אוטומטית כפריט הראשון (snippet.position=0) בסוגי הפלייליסטים הבאים. לכן, כל אחת מהרשימות האלה ממוינת למעשה לפי סדר הפריטים מהחדש לישן, על סמך השעות שבהן הפריטים נוספו לרשימה.
  - העלאות של משתמשים
  - סרטונים מועדפים
  - סרטונים שאהבתי
  - היסטוריית צפייה
  עם זאת, חשוב לזכור שפריט חדש שמוסיפים לפלייליסט 'לצפייה בהמשך' מתווסף כפריט האחרון ברשימה, כך שהרשימה הזו למעשה ממוינת מהפריט הישן ביותר לפריט החדש ביותר.
- עיבוד בקבוצות – גרסה 3 של ה-API תומכת באחד מתרחישי השימוש של עיבוד בקבוצות שגרסה 2 של ה-API תמכה בהם. כל ה-API methods‏ channels.list,‏ channelSections.list,‏ guideCategories.list,‏ playlistItems.list,‏ playlists.list,‏ subscriptions.list,‏ videoCategories.list ו-videos.list בגרסה 3 של ה-API תומכים בפרמטר id, שאפשר להשתמש בו כדי לציין רשימה של מזהים (מזהי סרטונים, מזהי ערוצים וכו') שמופרדים באמצעות פסיקים. באמצעות השיטות האלה, אפשר לאחזר רשימה של כמה משאבים בבקשה אחת.
בעקבות השינויים האלה, במדריך מפורטת עכשיו כל הפונקציונליות שנתמכה בגרסה הישנה של ה-API (גרסה 2) ושתוצא משימוש בגרסה הנוכחית של ה-API (גרסה 3).

‫4 במרץ 2015

העדכון הזה כולל את השינויים הבאים:

השיטות channelSections.delete ו-channelSections.update תומכות עכשיו בפרמטר onBehalfOfContentOwner, שכבר נתמך בכמה שיטות אחרות.
הנכסים הבאים והנכסים המשניים שלהם הוצאו משימוש:
- brandingSettings.image.backgroundImageUrl
- brandingSettings.image.largeBrandedBannerImageImapScript
- brandingSettings.image.largeBrandedBannerImageUrl
- brandingSettings.image.smallBrandedBannerImageImapScript
- brandingSettings.image.smallBrandedBannerImageUrl
הערה: אף אחד מהמאפיינים האלה לא היה כפוף למדיניות הוצאת API משימוש.
המאפיין החדש video של משאב contentDetails.contentRating.contentDetails.contentRating.djctqRatingReasons מזהה את הסיבות לכך שהסרטון קיבל את דירוג DJCQT (ברזיל).

ה-API תומך עכשיו בשגיאות הבאות:

סוג השגיאה	פרטי השגיאה	תיאור
`notFound (404)`	`channelNotFound`	השיטה `channels.update` מחזירה את השגיאה הזו אם הפרמטר `id` של הבקשה מציין ערוץ שלא ניתן למצוא.
`badRequest (400)`	`manualSortRequiredinvalidValue`	השגיאה הזו מוחזרת על ידי ה-methods ‏`playlistItems.insert` ו-`playlistItems.update` אם הבקשה מנסה להגדיר את המיקום של פריט בפלייליסט, אבל הפלייליסט לא משתמש במיון ידני. לדוגמה, אפשר למיין את הפריטים בפלייליסט לפי תאריך או לפי פופולריות. כדי לפתור את השגיאה הזו, צריך להסיר את רכיב `snippet.position` מהמשאב שנשלח בגוף הבקשה. אם רוצים שהפריט בפלייליסט יהיה במיקום ספציפי ברשימה, צריך קודם לעדכן את הגדרת הסדר של הפלייליסט לידני. אפשר לשנות את ההגדרה הזו במנהל הסרטונים ב-YouTube.
`forbidden (403)`	`channelClosed`	השיטה `playlists.list` מחזירה את השגיאה הזו אם הפרמטר `channelId` של הבקשה מציין ערוץ שנסגר.
`forbidden (403)`	`channelSuspended`	השיטה `playlists.list` מחזירה את השגיאה הזו אם הפרמטר `channelId` של הבקשה מציין ערוץ שהושעה.
`forbidden (403)`	`playlistForbidden`	השגיאה הזו מוחזרת על ידי השיטה `playlists.list` אם הפרמטר `id` של הבקשה לא תומך בבקשה או שהבקשה לא מורשית כראוי.
`notFound (404)`	`channelNotFound`	השיטה `playlists.list` מחזירה את השגיאה הזו אם הפרמטר `channelId` של הבקשה מציין ערוץ שלא ניתן למצוא.
`notFound (404)`	`playlistNotFound`	השגיאה הזו מוחזרת על ידי הפונקציה `playlists.list` אם הפרמטר `id` של הבקשה מציין פלייליסט שלא נמצא.
`notFound (404)`	`videoNotFound`	השיטה `videos.list` מחזירה את השגיאה הזו אם הפרמטר `id` של הבקשה מציין סרטון שלא ניתן למצוא.
`badRequest (400)`	`invalidRating`	השיטה `videos.rate` מחזירה את השגיאה הזו אם הבקשה מכילה ערך לא צפוי לפרמטר `rating`.

‫2 במרץ 2015

העדכון הזה כולל את השינויים הבאים:

ה-method‏ search.list תומך עכשיו בפרמטר relevanceLanguage, שמאפשר לבקש תוצאות שהכי רלוונטיות לשפה מסוימת.

עדכנו גם את מדריך ההעברה ל-YouTube Data API (גרסה 3) כדי להסביר איך להשתמש בפרמטר החדש הזה. הפרמטר הזה נועד לגשר על פער בתכונות שקיים בין גרסת ה-API הנוכחית (גרסה 3) לגרסה הקודמת (גרסה 2), שכבר הוצאה משימוש.
מדריך ההעברה של YouTube Data API (גרסה 3) עודכן גם כדי לציין את הוצאתם משימוש של פידים מיוחדים ושדות מטא-נתונים ש-API גרסה 2 סיפק לתיאור סרטים, טריילרים, תוכניות טלוויזיה, עונות של תוכניות טלוויזיה ופרקים של תוכניות טלוויזיה.

‫14 בינואר 2015

העדכון הזה כולל את השינויים הבאים:

המדריך להעברה ל-YouTube Data API (גרסה 3) עודכן, ועכשיו מוסבר בו איך להשתמש ב-API גרסה 3 כדי להעלות סרטונים באמצעות JavaScript. (פרטים נוספים זמינים בקטע העלאת סרטון). הפונקציונליות הזו דומה לפונקציונליות של העלאה מבוססת-דפדפן שנתמכת ב-v2 API. חשוב לשים לב: השינוי הזה במדריך להעברה לא משקף שינוי בפועל ב-API, אלא זמינות של קוד לדוגמה חדש להעלאת סרטונים באמצעות JavaScript בצד הלקוח.

לאור התמיכה בהעלאת סרטונים באמצעות ספריית הלקוח של JavaScript ו-CORS, מדריך ההעברה לא מציין יותר שהעלאה מבוססת-דפדפן היא תכונה שעשויה להיות מוצאת משימוש ב-API מגרסה 3.
המסמכים של שיטת videos.insert עודכנו וכוללים עכשיו את דוגמת קוד ה-JavaScript החדשה שמתוארת למעלה. גם רשימת דוגמאות הקוד של JavaScript ל-YouTube Data API (גרסה 3) עודכנה.

‫11 בנובמבר 2014

העדכון הזה כולל את השינויים הבאים:

העלות של המכסה לקריאה לשיטה search.list השתנתה ל-100 יחידות.

חשוב: ברוב המקרים אפשר להשתמש בשיטות אחרות של API כדי לאחזר מידע בעלות מכסת שימוש נמוכה יותר. לדוגמה, נניח שאתם רוצים למצוא סרטונים שהועלו לערוץ GoogleDevelopers.
- עלות המכסה: 100 יחידות
  
  מבצעים קריאה ל-search.list ומחפשים את GoogleDevelopers.
- עלות המכסה: 6 יחידות
  
  מבצעים קריאה ל-channels.list כדי למצוא את מזהה הערוץ הנכון. מגדירים את הפרמטר forUsername לערך GoogleDevelopers ואת הפרמטר part לערך contentDetails. בתגובת ה-API, המאפיין contentDetails.relatedPlaylists.uploads מציין את מזהה הפלייליסט של הסרטונים שהועלו לערוץ.
  
  לאחר מכן קוראים לשיטה playlistItems.list ומגדירים את הפרמטר playlistId למזהה שתועד ואת הפרמטר part לערך snippet.

‫8 באוקטובר 2014

העדכון הזה כולל את השינויים הבאים:

במשאב channel יש שני מאפיינים חדשים:
- המאפיין status.longUploadsStatus מציין אם הערוץ עומד בדרישות להעלאת סרטונים באורך של יותר מ-15 דקות. המאפיין הזה מוחזר רק אם בעלי הערוץ אישרו את בקשת ה-API. הערכים התקינים של המאפיין הם:
  - ‫allowed – אפשר להעלות לערוץ סרטונים באורך של יותר מ-15 דקות.
  - ‫eligible – בערוץ אפשר להעלות סרטונים באורך של יותר מ-15 דקות, אבל קודם צריך להפעיל את התכונה.
  - ‫disallowed – בערוץ אין אפשרות להעלות סרטונים באורך של יותר מ-15 דקות, או שהוא לא עומד בדרישות להעלאת סרטונים כאלה.
  מידע נוסף על הערכים האלה זמין בהגדרת המאפיין. במרכז העזרה של YouTube יש גם מידע מפורט יותר על התכונה הזו.
- המאפיין invideoPromotion.useSmartTiming מציין אם בקמפיין לקידום הערוץ מוגדרת תזמון חכם. התכונה הזו מנסה להציג מבצעים בנקודה בסרטון שבה הסיכוי שהצופים ילחצו עליהם גבוה יותר, והסיכוי שהם יפריעו לחוויית הצפייה נמוך יותר. התכונה הזו גם בוחרת מבצע אחד להצגה בכל סרטון.
ההגדרות של המאפיינים snippet.title ו-snippet.categoryId במשאב video עודכנו כדי להבהיר את האופן שבו ה-API מטפל בקריאות ל-method‏ videos.update. אם קוראים לשיטה הזו כדי לעדכן את החלק snippet במשאב video, צריך להגדיר ערך לשני המאפיינים האלה.

אם מנסים לעדכן את החלק snippet במשאב video ולא מגדירים ערך לשני המאפיינים האלה, ה-API מחזיר שגיאת invalidRequest. גם התיאור של השגיאה הזו עודכן.
המאפיין contentDetails.contentRating.oflcRating של מקור המידע video, שמזהה את סיווג הסרטון מטעם Office of Film and Literature Classification (המשרד לסיווג תכנים) של ניו זילנד, תומך עכשיו בשני סיווגים חדשים: oflcRp13 ו-oflcRp16. הערכים האלה תואמים לסיווגים RP13 ו-RP16, בהתאמה.

ה-method‏ channelBanners.insert תומך עכשיו בשגיאה הבאה:

סוג השגיאה	פרטי השגיאה	תיאור
`badRequest`	`bannerAlbumFull`	באוסף התמונות של עיצוב התבנית הגרפית של ערוץ YouTube של בעל הערוץ יש יותר מדי תמונות. בעל הערוץ צריך להיכנס לכתובת http://photos.google.com, לעבור לדף האלבומים ולהסיר חלק מהתמונות מהאלבום.

‫12 בספטמבר 2014

העדכון הזה כולל את השינויים הבאים:

עלות המכסה לקריאה לשיטה search.list השתנתה מיחידה אחת ל-2 יחידות, בנוסף לעלות של חלקי המשאב שצוינו.

‫13 באוגוסט 2014

העדכון הזה כולל את השינויים הבאים:

ה-method‏ subscriptions.insert תומך עכשיו בשגיאה הבאה:

סוג השגיאה	פרטי השגיאה	תיאור
`badRequest`	`subscriptionLimitExceeded`	המשתמש שאליו משויכת הבקשה חרג ממגבלת קצב הבקשות של המינוי. אפשר לנסות להירשם לעוד מינויים בעוד כמה שעות.

‫12 באוגוסט 2014

העדכון הזה כולל את השינויים הבאים:

במדריך חדש בשם העברת האפליקציה אל YouTube Data API (גרסה 3) מוסבר איך להשתמש ב-YouTube Data API (גרסה 3) כדי לבצע פעולות שזמינות ב-YouTube Data API (גרסה 2). ה-API הישן הוצא משימוש באופן רשמי ב-4 במרץ 2014. המדריך הזה נועד לעזור לכם להעביר אפליקציות שעדיין משתמשות ב-API בגרסה 2 לגרסה העדכנית ביותר של ה-API.

‫8 ביולי 2014

העדכון הזה כולל את השינויים הבאים:

ה-method‏ playlists.insert תומך עכשיו בשגיאה הבאה:

סוג השגיאה	פרטי השגיאה	תיאור
`badRequest`	`maxPlaylistExceeded`	השגיאה הזו מתרחשת אם אי אפשר ליצור פלייליסט כי בערוץ כבר יש את המספר המקסימלי של פלייליסטים שמותר ליצור.

‫18 ביוני 2014

העדכון הזה כולל את השינויים הבאים:

התיאור של כל method ב-API עודכן כך שיכלול את עלות המכסה שנובעת מקריאה ל-method הזה. באופן דומה, הגדרות הפרמטרים part עודכנו כדי לציין את עלות המכסה של כל חלק שאפשר לאחזר בקריאה ל-API. לדוגמה, קריאה ל-method‏ subscriptions.insert עולה בערך 50 יחידות מהמכסה. גם למשאב subscription יש שלושה חלקים (snippet,‏ contentDetails ו-subscriberSnippet), וכל אחד מהם עולה שתי יחידות.

חשוב לזכור שעלויות המכסה יכולות להשתנות ללא אזהרה.
המשאב video תומך עכשיו ב-43 מערכות חדשות לסיווג תוכן, שמזהות את הסיווגים שסרטונים קיבלו מסוכנויות סיווג לאומיות שונות. מערכות הסיווג החדשות שנתמכות הן מארגנטינה (Argentina), אוסטריה (Austria), בלגיה (Belgium), בולגריה (Bulgaria), צ'ילה (טלוויזיה), צ'ילה (סרטים), צ'כיה (Czech Republic), קולומביה (Colombia), דנמרק (Denmark), מצרים (Egypt�), אסטוניה (Estonia), פינלנד (Finland), צרפת (France), יוון (Greece), הונג קונג (Hong Kong), איסלנד (Iceland), אינדונזיה (Indonesia), אירלנד (Ireland), ישראל (Israel), איטליה (Italy), קניה (Kenya), לטביה (Latvia), לוקסמבורג (Luxembourg), מלזיה (Malaysia), האיים המלדיביים (Maldives), מלטה (Malta), הולנד (Netherlands), ניגריה (Nigeria), נורווגיה (Norway), פרו (Peru), הפיליפינים (Philippines), פורטוגל (Portugal), רומניה (Romania), סינגפור (Singapore), סלובקיה (Slovakia), דרום אפריקה (South Africa), שוודיה (Sweden), שווייץ (Switzerland), טייוואן (Taiwan), תאילנד (Thailand) וונצואלה (Venezuela).

‫28 במאי 2014

העדכון הזה כולל את השינויים הבאים:

ה-method‏ search.list תומך עכשיו בפרמטרים location ו-locationRadius, שמאפשרים לחפש סרטונים שמשויכים למיקום גיאוגרפי. כדי לאחזר תוצאות על סמך מיקום, צריך לציין ערך לשני הפרמטרים בבקשה. אם בקשה כוללת רק אחד משני הפרמטרים, ה-API יחזיר שגיאה.
- הפרמטר location מציין את הקואורדינטות של קו הרוחב וקו האורך במרכז האזור הגיאוגרפי העגול.
- הפרמטר locationRadius מציין את המרחק המקסימלי שבו המיקום שמשויך לסרטון יכול להיות ממרכז האזור, כדי שהסרטון עדיין ייכלל בתוצאות החיפוש.

‫13 במאי 2014

העדכון הזה כולל את השינויים הבאים:

המאפיין invideoPromotion.items[] של משאב channel עודכן כדי לציין שבדרך כלל אפשר להגדיר רק פריט אחד לקידום בערוץ. אם תנסו להוסיף יותר מדי פריטים מקודמים, ה-API יחזיר שגיאה tooManyPromotedItems עם קוד סטטוס HTTP 400.
עכשיו אפשר לכלול במשאב channelSection מידע על כמה סוגים חדשים של תוכן מומלץ. במאפיין snippet.type של רכיב channelSection יש עכשיו תמיכה בערכים הבאים:
- ‫postedPlaylists – פלייליסטים שבעלי הערוץ פרסמו בפיד הפעילות של הערוץ
- ‫postedVideos – סרטונים שבעלי הערוץ פרסמו בפיד הפעילות של הערוץ
- ‫subscriptions – ערוצים שהבעלים של הערוץ נרשם אליהם כמנוי
המאפיין החדש contentDetails.contentRating.ifcoRating של רכיב video מזהה את הסיווג שסרטון קיבל מה-Irish Film Classification Office (המשרד האירי לסיווג סרטים).
ההגדרה של מאפיין watermark של משאב position.cornerPosition עודכנה, ועכשיו מצוין בה שסימן המים תמיד מופיע בפינה השמאלית העליונה של הנגן.
ההגדרה של הפרמטר q בשיטה search.list עודכנה. עכשיו מצוין בה שאפשר להשתמש במונח השאילתה באופרטור NOT בוליאני (-) כדי להחריג סרטונים שמשויכים למונח חיפוש מסוים. אפשר גם להשתמש בערך באופרטור הבוליאני OR ‏ (|) כדי למצוא סרטונים שמשויכים לאחד מכמה מונחי חיפוש.
העדכנו את ההגדרה של המאפיין pageInfo.totalResults שמוחזר בתגובת API לקריאה search.list, והוספנו הערה שלפיה הערך הוא משוער ולא בהכרח מדויק. בנוסף, הערך המקסימלי הוא 1,000,000. אל תשתמשו בערך הזה כדי ליצור קישורים להחלפת דפים. במקום זאת, משתמשים בערכי המאפיינים nextPageToken ו-prevPageToken כדי לקבוע אם להציג קישורי מספור עמודים.
השיטות watermarks.set ו-watermarks.unset עודכנו כדי לשקף את העובדה שה-API מחזיר קוד תגובה מסוג HTTP 204 לבקשות שמופנות לשיטות האלה.

‫2 במאי 2014

העדכון הזה כולל את השינויים הבאים:

המשאב החדש i18nLanguage מציין שפה של אפליקציה שאתר YouTube תומך בה. שפת האפליקציה נקראת גם שפת ממשק המשתמש. באתר YouTube, שפת האפליקציה יכולה להיבחר אוטומטית על סמך ההגדרות בחשבון Google, שפת הדפדפן או מיקום ה-IP. משתמשים יכולים גם לבחור באופן ידני את שפת ממשק המשתמש הרצויה בכותרת התחתונה של אתר YouTube.

ה-API תומך בשיטה לרישום של שפות האפליקציה הנתמכות. אפשר להשתמש בשפות נתמכות כערך של הפרמטר hl כשקוראים לשיטות API כמו videoCategories.list ו-guideCategories.list.
המשאב החדש i18nRegion מציין אזור גיאוגרפי שמשתמש ב-YouTube יכול לבחור כאזור המועדף לצפייה בתוכן. אפשר גם לקרוא לאזור התוכן לוקאל תוכן. באתר YouTube, אזור התוכן יכול להיבחר באופן אוטומטי על סמך היוריסטיקה כמו דומיין YouTube או מיקום כתובת ה-IP של המשתמש. משתמש יכול גם לבחור באופן ידני את אזור התוכן הרצוי בכותרת התחתונה של אתר YouTube.

ממשק ה-API תומך בשיטה לרישום אזורי התוכן הנתמכים. אפשר להשתמש בקודי האזורים הנתמכים כערך של הפרמטר regionCode כשקוראים ל-API methods כמו search.list,‏ videos.list,‏ activities.list ו-videoCategories.list.

‫7 באפריל 2014

העדכון הזה כולל את השינויים הבאים:

משאב channelSection החדש מכיל מידע על קבוצת סרטונים שהערוץ בחר להציג. לדוגמה, קטע יכול להציג את ההעלאות האחרונות של הערוץ, את ההעלאות הפופולריות ביותר או סרטונים מפלייליסט אחד או יותר.

ממשק ה-API תומך בשיטות לרישום, הוספה, עדכון או מחיקה של אוספים בערוץ. אפשר לאחזר רשימה של קטעים בערוץ של המשתמש המאומת על ידי ציון מזהה ערוץ מסוים או על ידי ציון רשימה של מזהי קטעים ייחודיים בערוץ.

תיעוד השגיאות עודכן גם הוא, ועכשיו הוא כולל תיאור של הודעות השגיאה שה-API תומך בהן באופן ספציפי עבור השיטות החדשות האלה.
ההגדרה של אובייקט fileDetails במשאב video עודכנה כדי להסביר שהאובייקט הזה יוחזר רק אם למאפיין processingDetails.fileDetailsAvailability של הסרטון יש ערך של available.

באופן דומה, הגדרת האובייקט suggestions של המשאב video עודכנה כדי להסביר שהאובייקט הזה יוחזר רק אם למאפיין processingDetails.tagSuggestionsAvailability של הסרטון או למאפיין processingDetails.editorSuggestionsAvailability שלו יש ערך של available.
העדפנו את התיעוד של השיטות videos.insert ו-videos.update כדי לשקף את העובדה שאפשר להגדיר את המאפיין status.publishAt כשמפעילים את השיטות האלה.
הגדרת האובייקט invideoPromotion של המשאב channel עודכנה כדי להסביר שאפשר לאחזר את האובייקט רק על ידי הבעלים של הערוץ.
רשימת הפרמטרים של השיטה videos.rate עודכנה כדי לשקף שהשיטה הזו לא תומכת בפרמטר onBehalfOfContentOwner. זו הייתה שגיאה בתיעוד, כי בקשות videos.rate שמגדירות את הפרמטר הזה מחזירות שגיאת 500.

‫31 במרץ 2014

העדכון הזה כולל את השינויים הבאים:

המאפיין החדש status.publishAt של המשאב video מאפשר לציין את התאריך והשעה שבהם סרטון פרטי מתוזמן להתפרסם. אפשר להגדיר את המאפיין הזה רק אם סטטוס הפרטיות של הסרטון הוא private והסרטון מעולם לא פורסם. הנכס החדש הזה לא כפוף למדיניות הוצאה משימוש.

‫13 במרץ 2014

העדכון הזה כולל את השינויים הבאים:

ה-API תומך עכשיו בחלק contentOwnerDetails של משאבי channel. החלק החדש מכיל נתוני ערוץ שרלוונטיים לשותפי YouTube שמקושרים לערוץ, כולל המזהה של בעלי התוכן שמקושרים לערוץ והתאריך והשעה שבהם בוצע הקישור בין בעלי התוכן לערוץ. שימו לב שהחלק החדש הזה לא כפוף למדיניות הוצאה משימוש.

במסמכי התיעוד מפורט עכשיו האורך המקסימלי של התווים הנתמכים במאפיינים הבאים:

משאב	נכס	אורך מקסימלי
`channel`	`invideoPromotion.items[].customMessage`	40 תווים
`video`	`snippet.title`	100 תווים
`video`	`snippet.description`	‫5,000 בייטים
`video`	`snippet.tags`	‫500 תווים. שימו לב שערך המאפיין הוא רשימה, והפסיקים בין הפריטים ברשימה נספרים במסגרת המגבלה.

המאפיין brandingSettings.watch.featuredPlaylistId של המשאב channel יצא משימוש. ה-API יחזיר שגיאה אם תנסו להגדיר את הערך שלו.
הוספנו את מאפייני המשאבים הבאים video לרשימת הערכים שאפשר להגדיר כשמוסיפים או מעדכנים סרטון:
במסמכי התיעוד בנושא שגיאות מצוין עכשיו קוד תגובת ה-HTTP לכל סוג שגיאה.

ה-API תומך עכשיו בשגיאות הבאות:

סוג השגיאה	פרטי השגיאה	תיאור
`badRequest (400)`	`invalidCriteria`	השיטה `channels.list` מחזירה את השגיאה הזו אם בבקשה צוינו פרמטרים של מסננים שלא יכולים לשמש יחד.
`badRequest (400)`	`channelTitleUpdateForbidden`	השגיאה הזו מוחזרת על ידי ה-method `channels.update` אם מנסים לעדכן את החלק `brandingSettings` של ערוץ ולשנות את הערך של המאפיין `brandingSettings.channel.title`. (שימו לב: ה-API לא מחזיר את השגיאה אם משמיטים את המאפיין).
`badRequest (400)`	`invalidRecentlyUploadedBy`	השיטה `channels.update` מחזירה את השגיאה הזו אם המאפיין `invideoPromotion.items[].id.recentlyUploadedBy` מציין מזהה ערוץ לא תקין.
`badRequest (400)`	`invalidTimingOffset`	השיטה `channels.update` מחזירה את השגיאה הזו אם החלק `invideoPromotion` מציין היסט זמן לא תקין.
`badRequest (400)`	`tooManyPromotedItems`	השיטה `channels.update` מחזירה את השגיאה הזו אם החלק `invideoPromotion` מציין מספר פריטים מקודמים שגדול מהמספר המותר.
`forbidden (403)`	`promotedVideoNotAllowed`	השיטה `channels.update` מחזירה את השגיאה הזו אם המאפיין `invideoPromotion.items[].id.videoId` מציין מזהה סרטון שלא ניתן למצוא או שלא ניתן להשתמש בו כפריט מקודם.
`forbidden (403)`	`websiteLinkNotAllowed`	השיטה `channels.update` מחזירה את השגיאה הזו אם הנכס `invideoPromotion.items[].id.websiteUrl` מציין כתובת URL שאסורה.
`required (400)`	`requiredTimingType`	השיטה `channels.update` מחזירה את השגיאה הזו אם בבקשה לא מצוינות הגדרות ברירת מחדל של תזמון להצגת פריט מקודם ב-YouTube.
`required (400)`	`requiredTiming`	בשיטה `channels.update` צריך לציין אובייקט `invideoPromotion.items[].timing` לכל פריט מקודם.
`required (400)`	`requiredWebsiteUrl`	בשיטה `channels.update` צריך לציין מאפיין `invideoPromotion.items[].id.websiteUrl` לכל פריט שמקודם.
`badRequest (400)`	`invalidPublishAt`	השיטה `videos.insert` מחזירה את השגיאה הזו אם המטא-נתונים של הבקשה מציינים שעת פרסום מתוזמנת לא חוקית.

‫4 במרץ 2014

העדכון הזה כולל את השינויים הבאים:

‫YouTube Data API, גרסה 3, כפוף עכשיו למדיניות הוצאה משימוש שמתוארת בתנאים ובהגבלות של YouTube APIs. חשוב לציין שבדף שבו מפורטים ממשקי ה-API שחלה עליהם מדיניות ההוצאה משימוש, יש החרגה ספציפית של חלק מהפונקציונליות של v3 API, כך שהיא לא כפופה למדיניות.

‫5 בדצמבר 2013

העדכון הזה כולל את השינויים הבאים:

עדכנו את התיעוד של השיטה search.list כדי לשקף בצורה נכונה שלא צריך לציין ערך לפרמטר מסנן אחד בדיוק כששולחים בקשת חיפוש. במקום זאת, אפשר להגדיר ערך לאפס פרמטרים של מסננים או לפרמטר אחד של מסנן.
הגדרות הפרמטרים של השיטה search.list עודכנו, ועכשיו מצוין בהן שאם מציינים ערך לאחד מהפרמטרים הבאים, צריך להגדיר את ערך הפרמטר type כ-video:
- eventType
- videoCaption
- videoCategoryId
- videoDefinition
- videoDimension
- videoDuration
- videoEmbeddable
- videoLicense
- videoSyndicated
- videoType
הגודל המינימלי של תמונות באנר של ערוץ שהועלו הוקטן ל-2,048 פיקסלים על 1,152 פיקסלים. (בעבר, הגודל המינימלי היה ‎2120px by 1192px). בנוסף, חשוב לזכור שבchannelתיעוד המשאבים מצוינים הגדלים המקסימליים של כל תמונות הבאנרים שמוצגות מה-API. לדוגמה, הגודל המקסימלי של תמונת brandingSettings.image.bannerTvImageUrl לאפליקציות לטלוויזיה הוא ‎2120px x 1192px, אבל הגודל בפועל של התמונה יכול להיות ‎2048px x 1152px. במרכז העזרה של YouTube יש הנחיות נוספות לאופטימיזציה של עיצוב הערוץ לתצוגה בסוגים שונים של מכשירים.
הגדרות של כמה מאפייני משאבים channel עודכנו כדי לשקף את המידע הבא:
- האורך המקסימלי של הערך של המאפיין brandingSettings.channel.description הוא 1,000 תווים.
- האורך המקסימלי של מאפיין brandingSettings.channel.featuredChannelsTitle הוא 30 תווים.
- עכשיו אפשר להוסיף עד 100 ערוצים למאפיין brandingSettings.channel.featuredChannelsUrls[].
- אם מגדירים את ערך המאפיין brandingSettings.channel.unsubscribedTrailer, צריך לציין את מזהה הסרטון ב-YouTube של סרטון ציבורי או לא רשום שנמצא בבעלות של בעל הערוץ.
ה-method‏ channels.update תומך עכשיו בעדכונים של הנכס invideoPromotion.items[].promotedByContentOwner. המאפיין הזה מציין אם השם של בעלי התוכן יוצג כשהמבצע יוצג. אפשר להגדיר את המאפיין הזה רק אם בקשת ה-API שמגדירה את ערך המאפיין מוגשת בשם בעל התוכן באמצעות הפרמטר onBehalfOfContentOwner.
השיטות playlistItems.list ו-playlistItems.insert תומכות עכשיו בפרמטר onBehalfOfContentOwner, שכבר נתמך בכמה שיטות אחרות.
במאפיין contentDetails.contentRating.acbRating אפשר עכשיו לציין סיווג של Australian Classification Board (‏ACB) לסרטים או של Australian Communications and Media Authority (‏ACMA) לתוכניות טלוויזיה לילדים.
המאפיינים החדשים contentDetails.contentRating.catvRating ו-contentDetails.contentRating.catvfrRating מזהים את הסיווגים שסרטון קיבל במסגרת מערכת הסיווג הקנדית לטלוויזיה ומערכת הסיווג של Régie du cinéma בשפה הצרפתית, שמשמשת בקוויבק, בהתאמה.
המאפיין החדש snippet.assignable של רכיב videoCategory מציין אם אפשר לשייך לקטגוריית הסרטונים הזו סרטונים מעודכנים או סרטונים חדשים שהועלו.
נוספו דוגמאות קוד לשיטות הבאות:
- ‫activities.insert (Go)
- ‫channelBanners.insert (Python)
- ‫channels.update (Python)
- ‫playlistItems.list (Go)
- ‫search.list (Go)
- ‫thumbnails.set (Java)
- ‫videos.insert (Go)

‫24 באוקטובר 2013

העדכון הזה כולל את השינויים הבאים:

ממשק ה-API כולל שתי תכונות נוספות שנועדו לעזור למצוא תוכן של שידורים חיים ולהציג אותו:

המאפיין החדש snippet.liveBroadcastContent בתוצאות החיפוש מציין אם במשאב של סרטון או ערוץ יש תוכן של שידור חי. ערכי המאפיין התקינים הם upcoming,‏ active ו-none.
- המאפיין החדש video של משאב snippet.liveBroadcastContent מציין אם הסרטון הוא שידור חי פעיל או שידור חי שישודר בקרוב. ברשימה הבאה מפורטים הערכים האפשריים של המאפיין:
  - ‫upcoming – הסרטון הוא שידור חי שעוד לא התחיל.
  - ‫active – הסרטון הוא שידור חי שמתקיים כרגע.
  - ‫none – הסרטון הוא לא שידור חי פעיל או שידור חי שצפוי להתחיל בקרוב. זה יהיה ערך המאפיין לשידורים שהסתיימו ועדיין אפשר לצפות בהם ב-YouTube.
- המאפיין החדש liveStreamingDetails של משאב video הוא אובייקט שמכיל מטא-נתונים על שידור וידאו חי. כדי לאחזר את המטא-נתונים האלה, צריך לכלול את liveStreamingDetails ברשימת חלקי המשאבים של ערך הפרמטר part. המטא-נתונים כוללים את המאפיינים החדשים הבאים:
  - ‫liveStreamingDetails.actualStartTime – השעה שבה השידור התחיל בפועל. (הערך הזה יופיע אחרי שהסטטוס של השידור יהיה active).
  - ‫liveStreamingDetails.actualEndTime – השעה שבה השידור הסתיים בפועל. (הערך הזה יופיע אחרי שהשידור יסתיים).
  - ‫liveStreamingDetails.scheduledStartTime – השעה שבה השידור מתוזמן להתחיל.
  - ‫liveStreamingDetails.scheduledEndTime – השעה שבה השידור אמור להסתיים. אם ערך המאפיין ריק או שהמאפיין לא קיים, השידור מתוזמן להמשיך ללא הגבלת זמן.
  - ‫liveStreamingDetails.concurrentViewers – מספר האנשים שצופים בשידור החי.
  כדי לאחזר את המטא-נתונים האלה, צריך לכלול את liveStreamingDetails בערך הפרמטר part כשקוראים לשיטה videos.list, videos.insert או videos.update.
שימו לב: ב-1 באוקטובר 2013 השקנו עוד שתי תכונות לזיהוי תוכן של שידורים חיים – הפרמטר eventType של שיטת search.list והמאפיין snippet.liveBroadcastContent של תוצאת החיפוש.
השיטה videos.insert תומכת עכשיו בפרמטר notifySubscribers, שמציין אם YouTube צריך לשלוח התראה על הסרטון החדש למשתמשים שנרשמו כמנויים לערוץ של הסרטון. ערך ברירת המחדל של הפרמטר הוא True, והוא מציין שמנויים יקבלו התראה על סרטונים חדשים שהועלו. עם זאת, בעלי ערוץ שמעלים הרבה סרטונים עשויים להעדיף להגדיר את הערך כ-False כדי להימנע משליחת התראה על כל סרטון חדש למנויים של הערוץ.
הרשימה של המאפיינים שאפשר לשנות כשקוראים לשיטה channels.update עודכנה ונוספו אליה המאפיינים invideoPromotion.items[].customMessage ו-invideoPromotion.items[].websiteUrl. בנוסף, הרשימה שונתה כך שאפשר לזהות את מאפייני brandingSettings שאפשר לשנות. אפשר היה לשנות את המאפיינים האלה גם קודם, כך שהשינוי במסמכים לא משקף שינוי בפונקציונליות הקיימת של ה-API.brandingSettings
השיטות playlists.insert,‏ playlists.update ו-playlists.delete תומכות עכשיו בפרמטר onBehalfOfContentOwner, שכבר נתמך בכמה שיטות אחרות.
ה-method‏ playlists.insert תומך עכשיו בפרמטר onBehalfOfContentOwnerChannel, שכבר נתמך בכמה methods אחרים.
המאפיין contentDetails.contentRating.tvpgRating של המשאב video תומך עכשיו בערך pg14, שמתאים לסיווג TV-14.
הגדרת המאפיין snippet.liveBroadcastContent, שמופיע בתוצאות החיפוש, תוקנה כך שתשקף את העובדה ש-live הוא ערך מאפיין תקין, אבל active הוא לא ערך מאפיין תקין.
המאפיין contentDetails.contentRating.mibacRating במשאב video תומך עכשיו בשני סוגי דירוגים נוספים:
- ‫mibacVap (VAP) – ילדים צריכים להיות מלווים במבוגר.
- ‫mibacVm6 (V.M.6) – מוגבל לגיל 6 ומעלה.
- ‫mibacVm12 (V.M.12) – מוגבל לגיל 12 ומעלה.
המאפיין החדש invideoPromotion.items[].promotedByContentOwner של רכיב channel מציין אם השם של בעלי התוכן יוצג כשהמבצע יוצג. אפשר להגדיר את השדה הזה רק אם בקשת ה-API שמגדירה את הערך נשלחת בשם בעל התוכן. מידע נוסף זמין בפרמטר onBehalfOfContentOwner.

‫1 באוקטובר 2013

העדכון הזה כולל את השינויים הבאים:

אובייקט auditDetails החדש במשאב channel מכיל נתוני ערוץ שרשת מרובת ערוצים (MCN) תעריך כדי לקבוע אם לאשר או לדחות ערוץ מסוים. שימו לב: כל בקשת API שמקבלת את החלק הזה של המשאב חייבת לספק אסימון הרשאה שמכיל את היקף ההרשאה https://www.googleapis.com/auth/youtubepartner-channel-audit. בנוסף, צריך לבטל כל טוקן שמשתמש בהיקף הזה אם רשת ה-MCN מחליטה לקבל או לדחות את הערוץ, או תוך שבועיים מהתאריך שבו הונפק הטוקן.
המאפיין invideoPromotion.items[].id.type של רכיב channel תומך עכשיו בערך recentUpload, שמציין שהפריט המקודם הוא הסרטון שהועלה לאחרונה מערוץ ספציפי.

כברירת מחדל, הערוץ זהה לערוץ שעבורו מוגדרים נתוני הקידום בסרטון. עם זאת, אפשר לקדם את הסרטון שהועלה לאחרונה מערוץ אחר על ידי הגדרת הערך של המאפיין החדש invideoPromotion.items[].id.recentlyUploadedBy למזהה הערוץ של הערוץ הזה.
במשאב channel יש שלוש מאפיינים חדשים – brandingSettings.image.bannerTvLowImageUrl,‏ brandingSettings.image.bannerTvMediumImageUrl ו-brandingSettings.image.bannerTvHighImageUrl – שמציינים את כתובות ה-URL של תמונות הבאנר שמוצגות בדפי הערוצים באפליקציות לטלוויזיה.
המאפיין החדש snippet.liveBroadcastContent בתוצאות החיפוש מציין אם במשאב של סרטון או ערוץ יש תוכן של שידור חי. ערכי המאפיין התקינים הם upcoming,‏ active ו-none.
- במשאב video, הערך upcoming מציין שהסרטון הוא שידור חי שעוד לא התחיל, והערך active מציין שהסרטון הוא שידור חי שמתקיים כרגע.
- במשאב channel, הערך upcoming מציין שיש לערוץ שידור מתוזמן שעדיין לא התחיל, והערך acive מציין שיש לערוץ שידור חי שמתנהל כרגע.
במשאב watermark, המאפיין targetChannelId השתנה מאובייקט למחרוזת. במקום להכיל נכס משני שמציין את מזהה ערוץ YouTube של הערוץ שאליו מקושרת תמונת סימן המים, הנכס targetChannelId מציין עכשיו את הערך הזה בעצמו. לכן, המאפיין targetChannelId.value של המשאב הוסר.
ה-method‏ thumbnails.set תומך עכשיו בפרמטר onBehalfOfContentOwner, שכבר נתמך בכמה methods אחרים.
השיטה search.list תומכת עכשיו בפרמטר eventType, שמגביל את החיפוש כך שיוחזרו רק אירועים פעילים, אירועים עתידיים או אירועים שהסתיימו.
המאפיין החדש contentDetails.contentRating.mibacRating מציין את הסיווג שהסרטון קיבל מ-Ministero dei Beni e delle Attivita Culturali e del Turismo (המשרד למורשת תרבותית ולתיירות) באיטליה.

ה-API תומך עכשיו בשגיאות הבאות:

סוג השגיאה	פרטי השגיאה	תיאור
`badRequest`	`invalidImage`	השיטה `thumbnails.set` מחזירה את השגיאה הזו אם תוכן התמונה שסופק לא תקין.
`forbidden`	`videoRatingDisabled`	השיטה `videos.rate` מחזירה את השגיאה הזו אם הבעלים של הסרטון שסווג השבית את הסיווג של הסרטון.

‫27 באוגוסט 2013

העדכון הזה כולל את השינויים הבאים:

המשאב החדש watermark מזהה תמונה שמוצגת במהלך ההפעלה של סרטונים בערוץ מסוים. אפשר גם לציין ערוץ יעד שאליו התמונה תקושר, ופרטים לגבי התזמון שיקבעו מתי סימן המים יופיע במהלך הפעלת הסרטונים וכמה זמן הוא יהיה גלוי.

השיטה watermarks.set מעלה ומגדירה את תמונת סימן המים של הערוץ. השיטה watermarks.unset מוחקת את תמונת סימן המים של הערוץ.

במסמכי התיעוד של ה-API מפורטות הודעות השגיאה שה-API תומך בהן, במיוחד עבור השיטות watermarks.set ו-watermarks.unset.
המאפיין החדש statistics.hiddenSubscriberCount של משאב channel מכיל ערך בוליאני שמציין אם מספר המנויים של הערוץ מוסתר. לכן, הערך של המאפיין הוא false אם מספר המנויים של הערוץ גלוי לכולם.
ה-method‏ playlists.list תומך עכשיו בפרמטרים onBehalfOfContentOwner ו-onBehalfOfContentOwnerChannel. שני הפרמטרים האלה כבר נתמכים בכמה שיטות אחרות.
השיטה videos.list תומכת עכשיו בפרמטר regionCode, שמזהה את אזור התוכן שאליו צריך לאחזר תרשים. אפשר להשתמש בפרמטר הזה רק בשילוב עם הפרמטר chart. ערך הפרמטר הוא קוד מדינה לפי תקן ISO 3166-1 alpha-2.

בקטע error documentation מתוארת שגיאה נפוצה חדשה בבקשה, שיכולה להתרחש בכמה שיטות API:

סוג השגיאה	פרטי השגיאה	תיאור
`forbidden`	`insufficientPermissions`	ההיקפים שמשויכים לאסימון OAuth 2.0 שצוין בבקשה לא מספיקים כדי לגשת לנתונים המבוקשים.

‫15 באוגוסט 2013

העדכון הזה כולל את השינויים הבאים:

לאובייקט invideoPromotion של המשאב channel יש את המאפיינים החדשים והמעודכנים הבאים:
- ה-API תומך עכשיו באפשרות לציין אתר כפריט מקודם. כדי לעשות זאת, מגדירים את ערך המאפיין invideoPromotion.items[].id.type כ-website ומשתמשים במאפיין החדש invideoPromotion.items[].id.websiteUrl כדי לציין את כתובת ה-URL. אפשר גם להשתמש במאפיין החדש invideoPromotion.items[].customMessage כדי להגדיר הודעה מותאמת אישית שתוצג לגבי המבצע.
  
  הקישורים יכולים להוביל לאתרים משויכים, לאתרי מוכרים או לאתרים של רשתות חברתיות. מידע נוסף על הפעלת קישורים לתוכן זמין בהוראות שבמרכז העזרה של YouTube בנושא אתרים משויכים ואתרי מוֹכרים.
  
  כשאתם מוסיפים קישורים לקידום מכירות, אתם מסכימים שלא תשתמשו בקישורים האלה כדי להפנות תנועה לאתרים לא מורשים, ושהקישורים האלה יעמדו בדרישות של מדיניות AdWords, המדיניות של YouTube בנושא מודעות, הנחיות הקהילה של YouTube והתנאים וההגבלות של YouTube.
- המאפיינים שקשורים להגדרות התזמון של הצגת פריטים מקודמים במהלך הפעלת סרטון עברו שינוי במבנה:
  - האובייקט invideoPromotion.timing הועבר אל invideoPromotion.items[].timing. האובייקט הזה מאפשר לכם להתאים אישית את נתוני התזמון של כל פריט מקודם ברשימה invideoPromotion.items[].
  - אובייקט invideoPromotion.defaultTiming החדש מציין הגדרות תזמון שמוגדרות כברירת מחדל למבצע. ההגדרות האלה קובעות מתי פריט מקודם יוצג במהלך ההפעלה של אחד מהסרטונים בערוץ. אפשר לשנות את תזמון ברירת המחדל של כל פריט מקודם באמצעות אובייקט invideoPromotion.items[].timing.
  - המאפיין החדש invideoPromotion.items[].timing.durationMs מציין את משך הזמן, באלפיות השנייה, שבו המבצע יוצג. אובייקט invideoPromotion.defaultTiming מכיל גם שדה durationMs שמציין את משך הזמן שבו הפריט המקודם יוצג כברירת מחדל.
- המאפיינים invideoPromotion.items[].type ו-invideoPromotion.items[].videoId הועברו לאובייקט invideoPromotion.items[].id.
ה-method‏ subscriptions.list תומך עכשיו בפרמטרים onBehalfOfContentOwner ו-onBehalfOfContentOwnerChannel. שני הפרמטרים האלה כבר נתמכים בכמה שיטות אחרות.
בתגובת ה-API לבקשת thumbnails.set, הערך של המאפיין kind השתנה מ-youtube#thumbnailListResponse ל-youtube#thumbnailSetResponse.
נוספו דוגמאות קוד לשיטות הבאות:
- ‫channels.update (Java, ‏ Python)
- ‫playlists.insert (‎.NET, ‏ PHP)
- ‫subscriptions.insert (PHP, ‏ Python)
- ‫thumbnails.set (PHP, ‏ Python)
- ‫videos.insert (PHP)
- ‫videos.list (PHP)
- ‫videos.rate (Python)
- ‫videos.update (Java, ‏ PHP, ‏ Python)
שימו לב שגם הדוגמה ל-Python של ה-method‏ playlistItems.insert הוסרה, כי הפונקציונליות שהיא הדגימה מטופלת עכשיו על ידי ה-method‏ videos.rate.

ב-error documentation מתוארת שגיאה חדשה בהקשר של בקשה, שיכולה להתרחש בכל שיטת API שתומכת בפרמטר הבקשה mine:

סוג השגיאה	פרטי השגיאה	תיאור
`badRequest`	`invalidMine`	אי אפשר להשתמש בפרמטר `mine` בבקשות שבהן המשתמש המאומת הוא שותף של YouTube. צריך להסיר את הפרמטר `mine`, לבצע אימות כמשתמש YouTube על ידי הסרת הפרמטר `onBehalfOfContentOwner`, או לפעול כאחד מהערוצים של השותף על ידי ציון הפרמטר `onBehalfOfContentOwnerChannel` אם הוא זמין לשיטה שנקראה.

‫8 באוגוסט 2013

העדכון הזה כולל את השינויים הבאים:

עדכנו את הקטע Quota Usage (שימוש במכסת נפח) במדריך Getting Started with the YouTube Data API (תחילת העבודה עם YouTube Data API). השינוי הוא בעלות מכסת הנפח של העלאת סרטון, שהשתנתה מכ-16,000 יחידות לכ-1,600 יחידות.

‫30 ביולי 2013

העדכון הזה כולל את השינויים הבאים:

במשאב channelBanner, הערך של המאפיין kind השתנה מ-youtube#channelBannerInsertResponse ל-youtube#channelBannerResource. המשאב הזה מוחזר בתגובה לבקשת channelBanners.insert.
המאפיין החדש brandingSettings.channel.profileColor במשאב channel מציין צבע בולט שמשלים את התוכן של הערוץ. ערך המאפיין הוא סימן פאונד (#) ואחריו מחרוזת הקסדצימלית באורך שישה תווים, כמו #2793e6.
ה-API תומך עכשיו באפשרות לציין אם המינוי הוא לכל הפעילויות בערוץ או רק להעלאות חדשות. המאפיין החדש contentDetails.activityType של המשאב subscription מזהה את סוגי הפעילויות שהמנוי יקבל עליהן התראות. ערכי המאפיין התקינים הם all ו-uploads.
videos.list השיטה תומכת בפרמטרים חדשים לאחזור של מצעד הסרטונים הפופולריים ביותר ב-YouTube:
- הפרמטר chart מזהה את התרשים שרוצים לאחזר. בשלב הזה, הערך הנתמך היחיד הוא mostPopular. הערה: הפרמטר chart הוא פרמטר של מסנן, ולכן אי אפשר להשתמש בו באותה בקשה עם פרמטרים אחרים של מסננים (id ו-myRating).
- הפרמטר videoCategoryId מזהה את קטגוריית הסרטונים שעבורה צריך לאחזר את התרשים. אפשר להשתמש בפרמטר הזה רק בשילוב עם הפרמטר chart. כברירת מחדל, התרשימים לא מוגבלים לקטגוריה מסוימת.
המאפיין החדש topicDetails.relevantTopicIds[] של משאב video מספק רשימה של מזהי נושאים ב-Freebase שרלוונטיים לסרטון או לתוכן שלו. יכול להיות שהנושאים האלה מוזכרים בסרטון או מופיעים בו.
המאפיין recordingDetails.location.elevation של המשאב video קיבל את השם החדש recordingDetails.location.altitude, והמאפיין fileDetails.recordingLocation.location.elevation קיבל את השם החדש fileDetails.recordingLocation.location.altitude.
אובייקט contentDetails.contentRating של משאב video מציין את הסיווגים שסרטון קיבל במסגרת תוכניות סיווג שונות, כולל סיווגים של MPAA, סיווגים של TVPG וכן הלאה. ממשק ה-API תומך עכשיו בערך דירוג לכל מערכת דירוג, שמציין שהסרטון לא דורג. שימו לב שבסיווגי תוכן של MPAA, הסיווג 'ללא סיווג' משמש לעיתים קרובות לזיהוי גרסאות לא ערוכות של סרטים, שגרסה ערוכה שלהם קיבלה סיווג רשמי.
המאפיין החדש contentDetails.contentRating.ytRating של משאב video מזהה תוכן שחלה עליו הגבלת גיל. ערך המאפיין יהיה ytAgeRestricted אם מערכת YouTube זיהתה שהסרטון מכיל תוכן שלא מתאים למשתמשים מתחת לגיל 18. אם המאפיין לא קיים או אם ערך המאפיין ריק, סימן שהתוכן לא זוהה כתוכן עם הגבלת גיל.
הפרמטר mySubscribers של השיטה channels.list הוצא משימוש. משתמשים בשיטה subscriptions.list ובפרמטר mySubscribers שלה כדי לאחזר רשימה של מנויים לערוץ של המשתמש המאומת.
השיטות channelBanners.insert,‏ channels.update,‏ videos.getRating ו-videos.rate תומכות עכשיו בפרמטר onBehalfOfContentOwner. הפרמטר הזה מציין שהמשתמש המאומת פועל בשם בעל התוכן שצוין בערך הפרמטר.
עדכנו את התיעוד של method ‏channels.update כדי לשקף את העובדה שאפשר להשתמש ב-method הזה כדי לעדכן את אובייקט brandingSettings של משאב channel ואת מאפייני הצאצא שלו. בנוסף, במסמכי התיעוד מופיעה עכשיו רשימה מעודכנת של מאפיינים שאפשר להגדיר לאובייקט channel של משאב invideoPromotion.

בטופס error documentation מתוארות השגיאות החדשות הבאות:

סוג השגיאה	פרטי השגיאה	תיאור
`forbidden`	`accountDelegationForbidden`	השגיאה הזו לא ספציפית לרכיב method מסוים של API. השגיאה הזו מציינת שלמשתמש המאומת אין הרשאה לפעול בשם חשבון Google שצוין.
`forbidden`	`authenticatedUserAccountClosed`	השגיאה הזו לא ספציפית לרכיב method מסוים של API. הוא מציין שהחשבון של המשתמש המאומת ב-YouTube סגור. אם המשתמש פועל בשם חשבון Google אחר, השגיאה הזו מציינת שהחשבון האחר סגור.
`forbidden`	`authenticatedUserAccountSuspended`	השגיאה הזו לא ספציפית לרכיב method מסוים של API. הערך הזה מציין שהחשבון של המשתמש המאומת ב-YouTube מושעה. אם המשתמש פועל בשם חשבון Google אחר, השגיאה הזו מציינת שהחשבון האחר מושעה.
`forbidden`	`authenticatedUserNotChannel`	השגיאה הזו לא ספציפית לרכיב method מסוים של API. השגיאה הזו מציינת ששרת ה-API לא יכול לזהות את הערוץ שמשויך לבקשת ה-API. אם הבקשה מאושרת ומשתמשים בפרמטר `onBehalfOfContentOwner`, צריך להגדיר גם את הפרמטר `onBehalfOfContentOwnerChannel`.
`forbidden`	`cmsUserAccountNotFound`	השגיאה הזו לא ספציפית לרכיב method מסוים של API. למשתמש במערכת ניהול התוכן אין הרשאה לפעול בשם בעלי התוכן שצוין.
`notFound`	`contentOwnerAccountNotFound`	השגיאה הזו לא ספציפית לרכיב method מסוים של API. לא נמצא החשבון שמוגדר כבעלים שצוין.
`badRequest`	`invalidPart`	השגיאה הזו לא ספציפית לרכיב method מסוים של API. הפרמטר `part` בבקשה מציין חלקים שלא ניתן לכתוב בו-זמנית.
`badRequest`	`videoChartNotFound`	השיטה `videos.list` מחזירה את השגיאה הזו אם הבקשה מציינת תרשים סרטונים שלא נתמך או שלא זמין.
`notFound`	`videoNotFound`	השגיאה הזו מוחזרת על ידי השיטה `videos.update` כדי לציין שלא ניתן למצוא את הסרטון שאתם מנסים לעדכן. בודקים את הערך של הנכס `id` בגוף הבקשה כדי לוודא שהוא נכון.

‫10 ביוני 2013

העדכון הזה כולל את השינויים הבאים:

הפרמטר החדש forUsername של השיטה channels.list מאפשר לאחזר מידע על ערוץ על ידי ציון שם המשתמש שלו ב-YouTube.
ה-method‏ activities.list תומך עכשיו בפרמטר regionCode, שמורה ל-API להחזיר תוצאות שרלוונטיות למדינה שצוינה. מערכת YouTube משתמשת בערך הזה אם הפעילות הקודמת של המשתמש המורשה ב-YouTube לא מספקת מספיק מידע ליצירת עדכון הפעילות.
משאבי פלייליסט מכילים עכשיו את הנכס snippet.tags. הנכס יוחזר רק למשתמשים מורשים שמחלצים נתונים על הפלייליסטים שלהם. משתמשים מורשים יכולים גם להגדיר תגי פלייליסט כשהם מפעילים את השיטות playlists.insert או playlists.update.
הפרמטר onBehalfOfContentOwner, שנתמך בעבר בשיטות channels.list ו-search.list, נתמך עכשיו גם בשיטות videos.insert, videos.update ו-videos.delete. שימו לב: כשמשתמשים בפרמטר הזה בקריאה לשיטה videos.insert, הבקשה צריכה לציין גם ערך לפרמטר החדש onBehalfOfContentOwnerChannel, שמזהה את הערוץ שאליו יתווסף הסרטון. הערוץ חייב להיות מקושר לבעלי התוכן שצוינו בפרמטר onBehalfOfContentOwner.

הפרמטר מציין שפרטי ההרשאה של הבקשה מזהים משתמש ב-YouTube CMS, שפועל בשם בעל התוכן שצוין בערך הפרמטר. החשבון במערכת ניהול התוכן שהמשתמש מאמת צריך להיות מקושר לבעלי התוכן ב-YouTube שצוינו.

הפרמטר הזה מיועד לשותפי תוכן שהם הבעלים של ערוצי YouTube רבים ומנהלים אותם. הפרמטר מאפשר לשותפים האלה לבצע אימות פעם אחת ולקבל גישה לכל נתוני הסרטונים והערוצים שלהם, בלי לספק פרטי אימות לכל ערוץ בנפרד.

בפרט, בנוגע לגרסה הזו, הפרמטר מאפשר עכשיו לשותף תוכן להוסיף, לעדכן או למחוק סרטונים בכל אחד מערוצי YouTube שבבעלות השותף.

בטופס error documentation מתוארות השגיאות החדשות הבאות:

סוג השגיאה	פרטי השגיאה	תיאור
`forbidden`	`insufficientCapabilities`	השגיאה הזו לא ספציפית לרכיב method מסוים של API. השגיאה הזו מציינת שלמשתמש במערכת ניהול התוכן שקורא ל-API אין מספיק הרשאות לביצוע הפעולה המבוקשת. השגיאה הזו קשורה לשימוש בפרמטר `onBehalfOfContentOwner`, שנתמך בכמה שיטות API.
`unauthorized`	`authorizationRequired`	השיטה `activities.list` מחזירה את השגיאה הזו אם בבקשה נעשה שימוש בפרמטר `home` אבל היא לא מורשית בצורה תקינה.

במשאב channels, המאפיין invideoPromotion.channelId הוסר כי מזהה הערוץ כבר צוין באמצעות המאפיין id של המשאב.
במדריך החדש Working with Channel IDs מוסבר איך ממשק ה-API משתמש במזהי ערוצים. המדריך הזה יכול להיות שימושי במיוחד למפתחים שעוברים מהגרסה הקודמת של ה-API ויש להם אפליקציות שמבקשות תוכן עבור המשתמש default או שמסתמכות על ההנחה שלכל ערוץ ב-YouTube יש שם משתמש ייחודי, מה שכבר לא נכון.

‫22 במאי 2013

העדכון הזה כולל את השינויים הבאים:

השיטה החדשה channelBanners.insert מאפשרת להעלות תמונת באנר שאפשר להגדיר אותה בהמשך כתמונת הבאנר של הערוץ באמצעות המאפיין החדש brandingSettings.image.bannerExternalUrl של מקור המידע channel.
עדכנו את התיעוד של השיטה channels.update כדי לפרט את המאפיינים שאפשר לשנות כשמפעילים את השיטה.
במסמכי העזרה בנושא המשאב video, הערך unspecified לא מופיע יותר כערך מאפיין תקין למאפיינים suggestions.processingErrors[], ‏ suggestions.processingHints[], ‏ suggestions.processingWarnings[] ו-suggestions.editorSuggestions[].
לפרמטר maxResults של ה-method‏ videos.list יש עכשיו ערך ברירת מחדל של 5.
בerror documentation מוצגות עכשיו שגיאות עבור השיטות channelBanners.insert ו-subscriptions.list. הוא גם מפרט כמה שגיאות חדשות בשיטה channels.update.

‫14 במאי 2013

העדכון הזה כולל את השינויים הבאים:

בדפים עצמאיים מופיעות עכשיו דוגמאות קוד ל-Java, ל-‎.NET, ל-PHP ול-Ruby.
הדף שבו מפורטות דוגמאות לקוד Python כולל עכשיו דוגמאות להוספת מינוי, ליצירת פלייליסט ולעדכון סרטון.

‫10 במאי 2013

העדכון הזה כולל את השינויים הבאים:

‫YouTube לא מזהה יותר תכונות ושירותים ניסיוניים של API. במקום זאת, אנחנו מספקים עכשיו רשימה של ממשקי YouTube API שחלים עליהם כללי המדיניות בנושא הוצאה משימוש.

‫8 במאי 2013

העדכון הזה כולל את השינויים הבאים:

במשאבי הערוץ יש עכשיו תמיכה באובייקט inVideoPromotion, שמכיל מידע על קמפיין פרסומי שמשויך לערוץ. בערוץ אפשר להשתמש בקמפיין לקידום מכירות בתוך סרטון כדי להציג תמונות ממוזערות של סרטון מקודם בנגן הווידאו במהלך הפעלת הסרטונים של הערוץ.

כדי לאחזר את הנתונים האלה, צריך לכלול את invideoPromotion בערך הפרמטר part בבקשת channels.list.
אפשר להשתמש בשיטה החדשה channels.update כדי לעדכן את נתוני הקמפיין לקידום מכירות ב-In-video בערוץ. שימו לב שהשיטה תומכת רק בעדכונים של החלק invideoPromotion במשאב channel, ועדיין לא תומכת בעדכונים של חלקים אחרים במשאב הזה.

‫2 במאי 2013

העדכון הזה כולל את השינויים הבאים:

משאבי הערוץ תומכים עכשיו במאפיין status.isLinked, שמציין אם נתוני הערוץ מזהים משתמש שכבר מקושר לשם משתמש ב-YouTube או לחשבון Google+. למשתמש שיש לו אחד מהקישורים האלה כבר יש זהות ציבורית ב-YouTube, שנדרשת כדי לבצע כמה פעולות, כמו העלאת סרטונים.
משאבי מינוי תומכים עכשיו בחלק subscriberSnippet. האובייקט הזה מכיל נתוני קטע קוד של הערוץ של המנוי.
ה-API תומך עכשיו במתודה videos.getRating, שמחזירה את הדירוגים שהמשתמש המאומת נתן לרשימה של סרטון אחד או יותר.
הפרמטר החדש myRating של השיטה videos.list מאפשר לכם לאחזר רשימה של סרטונים שהמשתמש המאומת דירג בדירוג like או dislike.

הפרמטר myRating והפרמטר id נחשבים עכשיו לפרמטרים של סינון, כלומר בבקשת API צריך לציין בדיוק אחד מהפרמטרים. (בעבר, הפרמטר id היה פרמטר חובה בשיטה הזו).

השיטה מחזירה שגיאה forbidden לבקשות שמנסות לאחזר מידע על סיווג סרטונים, אבל לא קיבלו הרשאה מתאימה לעשות זאת.
בנוסף, עם ההשקה של הפרמטר myRating, עודכן גם ה-method ‏videos.list כדי לתמוך בהגדרת מעברי עמוד. עם זאת, חשוב לזכור שפרמטרים של חלוקה לדפים נתמכים רק בבקשות שמשתמשות בפרמטר myRating. (לא ניתן להשתמש בפרמטרים ובמידע של חלוקה לדפים בבקשות שמשתמשות בפרמטר id).
- הפרמטר maxResults מציין את המספר המקסימלי של סרטונים שה-API יכול להחזיר בקבוצת התוצאות, והפרמטר pageToken מזהה דף ספציפי בקבוצת התוצאות שרוצים לאחזר.
- המשאב youtube#videoListResponse, שמוחזר בתגובה לבקשת videos.list, מכיל עכשיו את האובייקט pageInfo, שכולל פרטים כמו המספר הכולל של התוצאות ומספר התוצאות שנכללות בקבוצת התוצאות הנוכחית. המשאב youtube#videoListResponse יכול לכלול גם את המאפיינים nextPageToken ו-prevPageToken, שכל אחד מהם מספק טוקן שאפשר להשתמש בו כדי לאחזר דף ספציפי בקבוצת התוצאות.
השיטה videos.insert תומכת בפרמטרים החדשים הבאים:
- ‫autoLevels – מגדירים את ערך הפרמטר הזה ל-true כדי להנחות את YouTube לשפר באופן אוטומטי את התאורה והצבע של הסרטון.
- ‫stabilize – מגדירים את ערך הפרמטר הזה ל-true כדי להנחות את YouTube לבצע שינויים בסרטון ולהסיר ממנו טלטולים שנובעים מתנועות המצלמה.
הנכס channelTitle נוסף אל snippet למשאבים הבאים:
- ‫playlistItem – המאפיין מציין את שם הערוץ שהוסיף את הפריט לפלייליסט.
- ‫playlist – המאפיין מציין את שם הערוץ שיצר את הפלייליסט.
- ‫subscription – המאפיין מציין את שם הערוץ שאליו נרשמים.
נוספו דוגמאות קוד לשיטות הבאות:
- ‫activities.insert (Ruby)
- ‫playlistItems.list (‎.NET)
- ‫search.list (‎.NET)
- ‫subscriptions.insert (Java, ‏ Ruby)
- ‫videos.insert (‎.NET, ‏ Ruby)
הפרמטר החדש mySubscribers של השיטה subscriptions.list מאפשר לכם לאחזר רשימה של המנויים של המשתמש המאומת הנוכחי. אפשר להשתמש בפרמטר הזה רק בבקשה מורשית.

הערה: התכונה הזו נועדה להחליף את הפרמטר mySubscribers שנתמך כרגע בשיטה channels.list. הפרמטר הזה יוצא משימוש.
במשאב video, ערך המאפיין unspecified לא יכול להיות יותר ערך אפשרי לאף אחד מהמאפיינים הבאים:
בקשות ל-API שמכילות פרמטר לא צפוי מחזירות עכשיו שגיאה badRequest, והסיבה לשגיאה שמדווחת היא unexpectedParameter.
השגיאה שמוחזרת מהשיטה playlistItems.insert כשהפלייליסט כבר מכיל את המספר המקסימלי של פריטים מותרים עודכנה. השגיאה מדווחת עכשיו כשגיאה מסוג forbidden, והסיבה לשגיאה היא playlistContainsMaximumNumberOfVideos.

‫19 באפריל 2013

העדכון הזה כולל את השינויים הבאים:

השיטה החדשה videos.rate מאפשרת למשתמש להגדיר דירוג של like או dislike לסרטון או להסיר דירוג מסרטון.

בנוסף, מאמרי העזרה בנושא שגיאות עודכנו ומופיעה בהם רשימה של השגיאות שה-API עשוי להחזיר בתגובה לvideos.rateהפעלת method.
תמונות ממוזערות מזוהות עכשיו ב<High Priority Term>מאמרי העזרה של ה-API</High Priority Term> כמשאב נפרד, והשיטה החדשה thumbnails.set מאפשרת להעלות <High Priority Term>תמונה ממוזערת של סרטון</High Priority Term> מותאמת אישית ל-YouTube ולהגדיר אותה לסרטון.

בנוסף, מאמרי העזרה בנושא שגיאות עודכנו ומופיעה בהם רשימה של השגיאות שה-API עשוי להחזיר בתגובה לthumbnails.setהפעלת method.

שימו לב שהשינוי הזה לא משפיע על משאבים קיימים שמחזירים תמונות ממוזערות. התמונות הממוזערות מוחזרות במשאבים האלה באותו אופן כמו קודם, אבל עכשיו מופיעים במסמכי התיעוד השמות של הגדלים השונים של התמונות הממוזערות שה-API עשוי להחזיר.
החלק brandingSettings החדש במשאב channel מזהה הגדרות, טקסט ותמונות לדף הערוץ ולדפי הצפייה בסרטונים של הערוץ.
משאב playlistItem מכיל את המאפיינים החדשים הבאים:
- האובייקט החדש status כולל מידע על הסטטוס של הפריט בפלייליסט, והמאפיין status.privacyStatus מזהה את סטטוס הפרטיות של הפריט בפלייליסט.

משאב video מכיל את המאפיינים החדשים הבאים:

המאפיין status.publicStatsViewable מציין אם הנתונים הסטטיסטיים המורחבים של הסרטון בדף הצפייה גלויים לציבור. כברירת מחדל, הנתונים הסטטיסטיים האלה גלויים, ונתונים סטטיסטיים כמו מספר הצפיות בסרטון והדירוגים שלו עדיין יהיו גלויים לכולם גם אם ערך המאפיין הזה מוגדר כ-false. אפשר להגדיר את הערך של המאפיין הזה כשמפעילים את השיטה videos.insert או videos.update.

האובייקט contentDetails.contentRating מכיל את הסיווגים שהסרטון קיבל במסגרת תוכניות סיווג שונות. ברשימה הבאה מפורטות מערכות הסיווג הנתמכות, ומופיע קישור לנכס שמשויך לכל מערכת סיווג. הגדרות המאפיינים מזהות את ערכי הסיווג הנתמכים לכל מערכת.

מדינה	מערכת סיווג	נכס
`United States`	‫Motion Picture Association of America (איגוד הסרטים של אמריקה, MPAA)	`contentDetails.contentRating.mpaaRating`
`United States`	הנחיות להורים לגבי טלוויזיה	`contentDetails.contentRating.tvpgRating`
`Australia`	Australian Classification Board ‏ (ACB)	`contentDetails.contentRating.acbRating`
`Brazil`	Departamento de Justiça, Classificação, Qualificação e Títulos	`contentDetails.contentRating.djctqRating`
`Canada`	מערכת הסיווג הקנדית לסרטוני וידאו ביתיים (CHVRS)	`contentDetails.contentRating.chvrsRating`
`France`	Centre national du cinéma et de l'image animée (המשרד הצרפתי לתרבות)	`contentDetails.contentRating.fmocRating`
`Germany`	Freiwillige Selbstkontrolle der Filmwirtschaft (FSK)	`contentDetails.contentRating.fskRating`
`Great Britain`	British Board of Film Classification (BBFC)	`contentDetails.contentRating.bbfcRating`
`India`	Central Board of Film Certification (CBFC)	`contentDetails.contentRating.cbfcRating`
`Japan`	映倫管理委員会 (EIRIN)	`contentDetails.contentRating.eirinRating`
`Korea`	‫영상물등급위원회 (KMRB)	`contentDetails.contentRating.kmrbRating`
`Mexico`	General Directorate of Radio, Television and Cinematography (RTC)	`contentDetails.contentRating.rtcRating`
`New Zealand`	Office of Film and Literature Classification	`contentDetails.contentRating.oflcRating`
`Russia`	National Film Registry of the Russian Federation	`contentDetails.contentRating.russiaRating`
`Spain`	`Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA)`	`contentDetails.contentRating.icaaRating`

עדכנו את התיעוד של ה-method playlistItems.update כדי לשקף את העובדה שצריך לציין את המאפיין snippet.resourceId במשאב שנשלח כגוף הבקשה.
השיטה search.list תומכת עכשיו בפונקציות הבאות:
- הפרמטר החדש forMine מגביל את החיפוש כך שיוחזרו רק הסרטונים של המשתמש המאומת.
- הפרמטר order תומך עכשיו באפשרות למיין את התוצאות בסדר אלפביתי לפי שם (order=title) או לפי מספר הסרטונים בסדר יורד (order=videoCount).
- הפרמטר החדש safeSearch מציין אם תוצאות החיפוש צריכות לכלול תוכן מוגבל.

השיטה videos.insert תומכת בכמה שגיאות חדשות, שמפורטות בטבלה הבאה:

סוג השגיאה	פרטי השגיאה	תיאור
`badRequest`	`invalidCategoryId`	הערך של מאפיין `snippet.categoryId` הוא מזהה קטגוריה לא תקין. אפשר להשתמש בשיטה `videoCategories.list` כדי לאחזר את הקטגוריות הנתמכות.
`badRequest`	`invalidRecordingDetails`	השדה `metadata` מציין פרטי הקלטה לא תקינים.
`badRequest`	`invalidVideoGameRating`	המטא-נתונים של הבקשה מציינים דירוג לא תקין של משחק וידאו.
`badRequest`	`invalidVideoMetadata`	המטא-נתונים של הבקשה לא תקינים.

הפרמטר onBehalfOfContentOwner הוסר מרשימת הפרמטרים הנתמכים של השיטות videos.update ו-videos.delete.

‫12 במרץ 2013

העדכון הזה כולל את השינויים הבאים:

הנכס channelTitle נוסף אל snippet למשאבים הבאים:
- ‫activity – המאפיין מציין את שם הערוץ שאחראי לפעילות.
- ‫search – המאפיין מציין את שם הערוץ שמשויך למשאב שזוהה בתוצאת החיפוש.
- ‫video – המאפיין מציין את שם הערוץ שהעלה את הסרטון.
השיטה search.list תומכת בפרמטרים החדשים הבאים:
- הפרמטר channelType מאפשר להגביל את החיפוש של ערוצים כדי לאחזר את כל הערוצים או רק תוכניות.
- הפרמטר videoType מאפשר להגביל את החיפוש של סרטונים כך שיוחזרו כל הסרטונים, או רק סרטים או רק פרקים של תוכניות.
העדכנו את ההגדרה של החלק recordingDetails במשאב video כדי לציין שהאובייקט יוחזר רק עבור סרטון אם הוגדרו הנתונים הגיאוגרפיים או זמן הצילום של הסרטון.
השיטה playlistItems.update מחזירה עכשיו שגיאה מסוג invalidSnippet, שמוחזרת אם בבקשת ה-API לא מצוין קטע קוד תקין.
כמה שיטות API תומכות בפרמטרים חדשים שמיועדים באופן בלעדי לשותפי תוכן ב-YouTube. שותפי התוכן של YouTube כוללים אולפני סרטים וטלוויזיה, לייבלים ויוצרי תוכן אחרים שמאפשרים לצפות בתוכן שלהם ב-YouTube.
- הפרמטר onBehalfOfContentOwner מציין שפרטי ההרשאה של הבקשה מזהים משתמש ב-YouTube CMS שפועל בשם בעל התוכן שצוין בערך הפרמטר. החשבון במערכת ניהול התוכן שהמשתמש מאמת צריך להיות מקושר לבעלי התוכן ב-YouTube שצוינו.
  
  הפרמטר הזה מיועד לשותפי תוכן שהם הבעלים של ערוצי YouTube רבים ומנהלים אותם. הפרמטר מאפשר לשותפים האלה לבצע אימות פעם אחת ולקבל גישה לכל נתוני הסרטונים והערוצים שלהם, בלי לספק פרטי אימות לכל ערוץ בנפרד.
  
  כל השיטות channels.list,‏ search.list,‏ videos.delete,‏ videos.list ו-videos.update תומכות בפרמטר הזה.
- הפרמטר managedByMe, שנתמך על ידי השיטה channels.list, מורה ל-API להחזיר את כל הערוצים שבבעלות בעלי התוכן שצוינו בפרמטר onBehalfOfContentOwner.
- הפרמטר forContentOwner, שנתמך על ידי השיטה search.list, מורה ל-API להגביל את תוצאות החיפוש כך שיכללו רק משאבים שנמצאים בבעלות של בעל התוכן שצוין בפרמטר onBehalfOfContentOwner.

‫25 בפברואר 2013

העדכון הזה כולל את השינויים הבאים:

ה-API תומך בכמה חלקים ומאפיינים חדשים של משאבי video:
- החלקים החדשים fileDetails, processingDetails ו-suggestions מספקים לבעלי הסרטונים מידע על הסרטונים שהם העלו. הנתונים האלה שימושיים מאוד באפליקציות שמאפשרות העלאת סרטונים, והם כוללים את הפרטים הבאים:
  - סטטוס ומהלך העיבוד
  - שגיאות או בעיות אחרות שנתקלו בהן במהלך עיבוד סרטון
  - זמינות של תמונות ממוזערות
  - הצעות לשיפור האיכות של הסרטון או המטא-נתונים
  - פרטים על הקובץ המקורי שהועלה ל-YouTube
  רק הבעלים של הסרטון יכול לאחזר את כל החלקים האלה. ברשימה הבאה מופיע תיאור קצר של החלקים החדשים, ובvideoתיעוד המשאבים מוגדרים כל המאפיינים שכל חלק מכיל.
  - אובייקט fileDetails מכיל מידע על קובץ הווידאו שהועלה ל-YouTube, כולל הרזולוציה, משך הזמן, קודק האודיו והווידאו, קצב העברת הנתונים של הסטרימינג ועוד.
  - האובייקט processingProgress מכיל מידע על התקדמות העיבוד של קובץ הווידאו שהועלה ב-YouTube. המאפיינים של האובייקט מזהים את סטטוס העיבוד הנוכחי ומעריכים את הזמן שנותר עד ש-YouTube יסיים לעבד את הסרטון. בחלק הזה מצוין גם אם סוגים שונים של נתונים או תוכן, כמו פרטי הקובץ או תמונות ממוזערות, זמינים לסרטון.
    האובייקט הזה מיועד לשליחת בקשות חוזרות כדי שמעלה הסרטון יוכל לעקוב אחרי ההתקדמות של YouTube בעיבוד קובץ הסרטון שהועלה.
  - אובייקט suggestions מכיל הצעות לשיפור איכות הסרטון או המטא-נתונים של הסרטון שהועלה.
- החלק contentDetails מכיל ארבע מאפיינים חדשים. אפשר לאחזר את המאפיינים האלה באמצעות בקשות לא מאומתות.
  - ‫dimension – מציין אם הסרטון זמין בתלת-ממד או בדו-ממד.
  - ‫definition – מציין אם הסרטון זמין באיכות רגילה או באיכות גבוהה.
  - ‫caption – מציין אם יש כתוביות לסרטון.
  - ‫licensedContent – מציין אם הסרטון מכיל תוכן שהוגשה לגביו תביעת בעלות על ידי שותף תוכן של YouTube.
- החלק status מכיל שתי מאפיינים חדשים. בעלי סרטונים יכולים להגדיר ערכים לשני המאפיינים האלה כשהם מוסיפים או מעדכנים סרטון. אפשר גם לאחזר את הנכסים האלה באמצעות בקשות לא מאומתות.
  - ‫embeddable – מציין אם אפשר להטמיע את הסרטון באתר אחר.
  - ‫license – מציין את הרישיון של הסרטון. הערכים התקינים הם creativeCommon ו-youtube.
ההגדרה של הפרמטר part עודכנה עבור השיטות videos.list, videos.insert ו-videos.update, כך שהיא כוללת את החלקים החדשים שנוספו (שמתוארים למעלה) וגם את החלק recordingDetails, שהושמט בטעות.
המאפיין contentDetails.googlePlusUserId החדש של משאב channel מציין את מזהה הפרופיל ב-Google+‎ שמשויך לערוץ. אפשר להשתמש בערך הזה כדי ליצור קישור לפרופיל Google+‎.
עכשיו כל אובייקט של תמונה ממוזערת מציין את הרוחב והגובה של התמונה. כרגע, התמונות הממוזערות מוחזרות במשאבים activity, channel, playlist, playlistItem, search result, subscription ו-video.
הפרמטר playlistItems.list תומך עכשיו בפרמטר videoId, שאפשר להשתמש בו בשילוב עם הפרמטר playlistId כדי לאחזר רק את הפריט בפלייליסט שמייצג את הסרטון שצוין.

ה-API מחזיר שגיאה notFound אם הסרטון שהפרמטר מזהה לא נמצא בפלייליסט.
במסמכי השגיאות מתוארת שגיאה חדשה, forbidden, שמציינת שהבקשה לא מורשית לבצע את הפעולה המבוקשת.
המאפיין snippet.channelId של המשאב channel הוסר. ערך המאפיין id של המשאב זהה.

‫30 בינואר 2013

העדכון הזה כולל את השינויים הבאים:

בדף error החדש מפורטות השגיאות שממשק ה-API יכול להחזיר. בדף הזה מפורטות שגיאות כלליות, שיכולות להתרחש בכמה שיטות שונות של API, וגם שגיאות שספציפיות לשיטה מסוימת.

‫16 בינואר 2013

העדכון הזה כולל את השינויים הבאים:

דוגמאות קוד זמינות עכשיו ל-methods ולשפות שמופיעות ברשימה הבאה:
- ‫activities.insert – Java
- ‫playlistItems.insert – Python
- ‫playlistItems.list – Java, ‏ JavaScript, ‏ PHP, ‏ Python, ‏ Ruby
- ‫playlists.insert – Java, ‏ JavaScript, ‏ Python
- ‫search.list – Java, ‏ JavaScript, ‏ Python, ‏ Ruby
- ‫videos.insert – Java
עכשיו אפשר לדווח על פעולה מסוג channelItem במשאב activity. הפעולה הזו מתרחשת כשמערכת YouTube מוסיפה סרטון לערוץ YouTube שנוצר באופן אוטומטי. (האלגוריתם של YouTube מזהה נושאים שיש להם נוכחות משמעותית באתר YouTube ויוצר באופן אוטומטי ערוצים לנושאים האלה).
הפרמטרים הבאים של search.list עודכנו:
- הפרמטר q כבר לא מוגדר כמסנן, מה שאומר ש...
- הפרמטר relatedToVideo נקרא עכשיו relatedToVideoId.
- הפרמטר published הוחלף בשני פרמטרים חדשים, publishedAfter ו-publishedBefore, שמתוארים בהמשך.

השיטה search.list תומכת בפרמטרים החדשים הבאים:

שם הפרמטר	ערך	תיאור
`channelId`	`string`	מחזירה משאבים שנוצרו על ידי הערוץ שצוין.
`publishedAfter`	`datetime`	החזרת משאבים שנוצרו אחרי הזמן שצוין.
`publishedBefore`	`datetime`	החזרת משאבים שנוצרו לפני הזמן שצוין.
`regionCode`	`string`	החזרת משאבים למדינה שצוינה.
`videoCategoryId`	`string`	מסנן את תוצאות החיפוש של סרטונים כך שיכללו רק סרטונים שמשויכים לקטגוריית הסרטון שצוינה.
`videoEmbeddable`	`string`	אפשר לסנן את תוצאות החיפוש של סרטונים כך שיכללו רק סרטונים שאפשר להפעיל בנגן מוטמע בדף אינטרנט. מגדירים את ערך הפרמטר ל-`true` כדי לאחזר רק סרטונים שאפשר להטמיע.
`videoSyndicated`	`string`	סינון תוצאות החיפוש של סרטונים כך שיכללו רק סרטונים שאפשר להפעיל מחוץ ל-YouTube.com. מגדירים את ערך הפרמטר ל-`true` כדי לאחזר רק סרטונים שזמינים להפצה.

כמה משאבי API תומכים במאפיינים חדשים. בטבלה הבאה מפורטים המשאבים והמאפיינים החדשים שלהם:

משאב	שם הנכס	ערך	תיאור
`activity`	`contentDetails.playlistItem.playlistItemId`	`string`	מזהה פריט הפלייליסט שהוקצה על ידי YouTube כדי לזהות באופן ייחודי את הפריט בפלייליסט.
`activity`	`contentDetails.channelItem`	`object`	אובייקט שמכיל מידע על מקור מידע שנוסף לערוץ. המאפיין הזה מופיע רק אם הערך של `snippet.type` הוא `channelItem`.
`activity`	`contentDetails.channelItem.resourceId`	`object`	אובייקט שמזהה את המשאב שנוסף לערוץ. בדומה למאפיינים אחרים של `resourceId`, הוא מכיל מאפיין `kind` שמציין את סוג המשאב, כמו סרטון או פלייליסט. הוא מכיל גם בדיוק אחד מכמה מאפיינים – `videoId`,‏ `playlistId` וכו' – שמציין את המזהה שמזהה באופן ייחודי את המשאב הזה.
`channel`	`status`	`object`	האובייקט הזה כולל מידע על סטטוס הפרטיות של הערוץ.
`channel`	`status.privacyStatus`	`string`	סטטוס הפרטיות של הערוץ. הערכים התקינים הם `private` ו-`public`.
`playlist`	`contentDetails`	`object`	האובייקט הזה מכיל מטא-נתונים על התוכן של הפלייליסט.
`playlist`	`contentDetails.itemCount`	`unsigned integer`	מספר הסרטונים בפלייליסט.
`playlist`	`player`	`object`	האובייקט הזה מכיל מידע שמשמש להפעלת הפלייליסט בנגן מוטמע.
`playlist`	`player.embedHtml`	`string`	תג `<iframe>` שמטמיע נגן וידאו שמפעיל את הפלייליסט.
`video`	`recordingDetails`	`object`	האובייקט הזה מכיל מידע שמזהה או מתאר את המקום והזמן שבהם הסרטון צולם.
`video`	`recordingDetails.location`	`object`	האובייקט הזה מכיל מידע על מיקום גיאוגרפי שמשויך לסרטון.
`video`	`recordingDetails.location.latitude`	`double`	קו רוחב במעלות.
`video`	`recordingDetails.location.longitude`	`double`	קו אורך במעלות.
`video`	`recordingDetails.location.elevation`	`double`	הגובה מעל פני כדור הארץ, במטרים.
`video`	`recordingDetails.locationDescription`	`string`	תיאור טקסטואלי של המיקום שבו צולם הסרטון.
`video`	`recordingDetails.recordingDate`	`datetime`	התאריך והשעה שבהם הסרטון צולם. הערך מצוין בפורמט ISO 8601 (`YYYY-MM-DDThh:mm:ss.sZ`).

בתיעוד של כמה שיטות API מפורטים עכשיו מאפיינים שצריך לציין בגוף הבקשה או שמתעדכנים על סמך ערכים בגוף הבקשה. בטבלה הבאה מפורטות השיטות האלה, וגם המאפיינים הנדרשים או הניתנים לשינוי.

הערה: יכול להיות שבמסמכים של שיטות אחרות כבר מפורטים המאפיינים הנדרשים והניתנים לשינוי.

שיטה	מאפיינים
`activities.insert`	מאפייני חובה: `snippet.description` מאפיינים שאפשר לשנות: `snippet.description` `contentDetails.bulletin.resourceId`
`playlists.update`	מאפייני חובה: `id`
`playlistItems.update`	מאפייני חובה: `id`
`videos.update`	מאפייני חובה: `id`

ה-API לא מדווח יותר על שגיאה playlistAlreadyExists אם מנסים ליצור או לעדכן פלייליסט עם שם זהה לשם של פלייליסט שכבר קיים באותו ערוץ.

כמה שיטות API תומכות בסוגי שגיאות חדשים. בטבלה הבאה מפורטים השיטה והשגיאות החדשות שנתמכות:

שיטה	סוג השגיאה	פרטי השגיאה	תיאור
`guideCategories.list`	`notFound`	`notFound`	לא ניתן למצוא את קטגוריית המדריך שצוינה בפרמטר `id`. אפשר להשתמש בשיטה guideCategories.list כדי לאחזר רשימה של ערכים תקינים.
`playlistItems.delete`	`forbidden`	`playlistItemsNotAccessible`	אין הרשאה למחיקת פריט הפלייליסט שצוין בבקשה.
`videoCategories.list`	`notFound`	`videoCategoryNotFound`	לא ניתן למצוא את קטגוריית הסרטון שזוהתה על ידי הפרמטר `id`. אפשר להשתמש בשיטה videoCategories.list כדי לאחזר רשימה של ערכים תקינים.

היסטוריית תיקונים קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

‫1 ביוני 2026

‫4 בדצמבר 2025

‫10 ביולי 2025

‫26 במרץ 2025

‫30 באוקטובר 2024

‫30 באפריל 2024

‫13 במרץ 2024

‫12 במרץ 2024

‫7 במרץ 2024

‫31 בינואר 2024

‫9 בנובמבר 2023

‫12 בספטמבר 2023

‫22 באוגוסט 2023

‫18 באוגוסט 2023

‫7 באוגוסט 2023

‫28 ביוני 2023

‫12 ביוני 2023

‫22 באוגוסט 2022

5 באוגוסט 2022

12 ביולי 2022

27 באפריל 2022

‫8 באפריל 2022

15 בדצמבר 2021

‫18 בנובמבר 2021

‫2 ביולי 2021

1 ביולי 2021

‫12 במאי 2021

‫9 בפברואר 2021

‫28 בינואר 2021

‫15 באוקטובר 2020

‫8 באוקטובר 2020

9 בספטמבר 2020

‫29 ביולי 2020

28 ביולי 2020

21 ביולי 2020

7 ביולי 2020

‫15 ביוני 2020

4 ביוני 2020

17 באפריל 2020

31 במרץ 2020

‫10 בינואר 2020

‫10 בספטמבר 2019

4 באפריל 2019

9 ביולי 2018

‫22 ביוני 2018

‫27 בנובמבר 2017

‫16 בנובמבר 2017

‫25 באוקטובר 2017

‫29 באוגוסט 2017

‫24 ביולי 2017

‫1 ביוני 2017

‫17 במאי 2017

‫27 באפריל 2017

‫30 במרץ 2017

‫27 בפברואר 2017

‫29 בנובמבר 2016

‫10 בנובמבר 2016

‫2 בנובמבר 2016

‫15 בספטמבר 2016

‫11 באוגוסט 2016

‫13 ביוני 2016

‫31 במאי 2016

‫17 במאי 2016

‫28 באפריל 2016

‫20 באפריל 2016

‫16 במרץ 2016

‫18 בדצמבר 2015

‫19 בנובמבר 2015

‫4 בנובמבר 2015

‫28 באוגוסט 2015

‫7 באוגוסט 2015

‫18 ביוני 2015

‫27 באפריל 2015

‫16 באפריל 2015

‫9 באפריל 2015

‫2 באפריל 2015

‫11 במרץ 2015

‫4 במרץ 2015

‫2 במרץ 2015

היסטוריית תיקונים