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

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

‫30 בספטמבר 2026

העדכנו את הגדרת המשאב comments כך שתכלול את המאפיין החדש snippet.imageUrl, שמספק את כתובת ה-URL של תמונה או קובץ GIF מונפש שמצורפים לתגובה.

התכונה הזו תהיה זמינה לכל המשתמשים בנובמבר 2026.

‫14 בספטמבר 2026

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

• תיאור השיטה thumbnails.set עודכן, ועכשיו מצוין בו שגודל הקובץ המקסימלי של תמונות ממוזערות שהועלו גדל מ-2MB ל-50MB.
• תיארנו את השיטה playlistImages.insert וציינו שגודל הקובץ המקסימלי של תמונות שהועלו גדל מ-2MB ל-50MB.

‫11 בספטמבר 2026

ההגדרה של מאפיין snippet.thumbnails.(key) עודכנה במסמכי העיון של המשאבים activities,‏ liveBroadcasts,‏ playlistItems,‏ playlists,‏ search ו-videos. במסמכים האלה מצוין שעכשיו יש תמונות ממוזערות ברזולוציה גבוהה יותר לחלק מהסרטונים: fhd (1080p),‏ qhd (1440p) ו-uhd (4K).

‫1 בספטמבר 2026

ה-method‏ videos.getRating מקבל עכשיו את היקף ההרשאה https://www.googleapis.com/auth/youtube.readonly.

‫27 באוגוסט 2026

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

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

אין שינוי בדרישות הסף להצטרפות לתוכנית השותפים של YouTube. בנוסף, דרישות הסף להצטרפות לתוכנית השותפים של YouTube ייקראו מעכשיו "צפיות ב-Shorts שעומדות בדרישות" ו "שעות צפייה שעומדות בדרישות" (בעבר "צפיות תקפות ב-Shorts גלויים לכולם" ו "שעות צפייה תקפות בתוכן גלוי לכולם").

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

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

עדכונים במסמכי העזרה של ה-API: עדכנו את התיאור של השדה viewCount במסמכי העזרה בנושא channels ו-videos.

‫6 באוגוסט 2026

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

• הסרנו מהמסמכים הציבוריים את כל ההפניות לשדות contentDetails.like ו-contentDetails.favorite בקטע activities.contentDetails, כי ה-API לא מחזיר את השדות האלה.

7 ביולי 2026

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

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

אפשר לציין את החלק brandPartner כשקוראים לשיטות הבאות:

• videos.insert
• videos.update
• videos.list

אובייקט brandPartner מכיל את השדות הבאים:

• channelId: מזהה הערוץ החיצוני של מותג שותף.
• ‫channelHandle: הכינוי של הערוץ של השותף למותג.
‫

צריך להגדיר את channelId או את channelHandle כשיוצרים קישור, אבל רק channelId מוחזר בתשובה.

‫23 ביוני 2026

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

• הוסרו כל ההפניות לסוגי המשאבים messageDeletedEvent ו-messageRetractedEvent (ולאובייקטים התואמים messageDeletedDetails ו-messageRetractedDetails) בקטע liveChatMessages, כי האירועים האלה לא מוחזרים על ידי ה-API.

‫3 ביוני 2026

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

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

לקריאה לשיטה הזו יש עלות מכסה של יחידה אחת בדלי המכסה הגרגולרי שלה. מכסת ברירת המחדל של השיטה היא 10,000 יחידות ביום.

‫1 ביוני 2026

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

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

קריאות לשיטות videos.insert ו-search.list של API יחויבו בנפרד במסגרת המכסות שלהן. קריאות ל-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 בנושא תוכן שקשור להתעללות או ניצול מיני של ילדים

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

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

כדי לציין אם סרטון מכיל תוכן שנוצר על ידי AI או תוכן סינתטי, צריך להגדיר את המאפיין 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 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 הוצא משימוש. מערכת YouTube תפסיק לתמוך בפרמטר החל מ-7 באוגוסט 2023.

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

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

‫22 באוגוסט 2022

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

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

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

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

  בכל המקרים, השגיאה הזו מחזירה קוד תגובה 400 של תגובת HTTP (בקשה שגויה).

• השגיאות 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.

במדריך החדש איך בודקים את סטטוס הסרטון 'נוצר לילדים' מוסבר איך לחפש את סטטוס ה-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 – היסטוריית גרסאות. השינויים בתנאים ובהגבלות של שירותי ה-API של YouTube ובמדיניות למפתחים ייכנסו לתוקף ב-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. דוגמאות אפשר לראות גם במסמכי העזרה של כמעט כל method של 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 שמגדירות את ערכי המאפיינים האלה לא יגרמו לשגיאות לפני התאריך הזה, אבל יכול להיות שהנתונים הנכנסים לא יישמרו.

  • recordingDetails.locationDescription
  • recordingDetails.location.latitude
  • recordingDetails.location.longitude

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

‫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, הוסר.

בעקבות השינוי הזה, נושאים שקשורים לסרטון תמיד מוחזרים בערך המאפיין 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 מציין את הסיווג שהסרטון קיבל בוויטנאם.

  • ה-method‏ videos.list תומך עכשיו בשני פרמטרים חדשים: maxHeight ו-maxWidth. אפשר להשתמש בפרמטר אחד או בשני הפרמטרים כשמאחזרים את החלק player במשאבי video.

    כברירת מחדל, הגובה של <iframe> שמוחזר במאפיין player.embedHtml הוא 360 פיקסלים. הרוחב מותאם ליחס הגובה-רוחב של הסרטון, וכך מוודאים שבנגן המוטמע לא יהיו פסים שחורים שממסגרים את הסרטון. לדוגמה, אם יחס הגובה-רוחב של סרטון הוא 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.

  • התיקון בוצע בהגדרה של המאפיין snippet.name של רכיב i18nLanguage, כדי לשקף שהערך מייצג את שם השפה כפי שהוא נכתב בשפה שצוינה בפרמטר 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 מחזיר משאבים שנוצרו לפני או בזמן שצוין.

  • מאפיין ה-video של המשאב contentDetails.contentRating.grfilmRating תומך בשלושה ערכים נוספים: 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	השגיאה הזו מוחזרת על ידי ה-method ‏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 יחזירו רשימה ריקה.

  • המאפיינים contentDetails.relatedPlaylists.watchHistory ו-contentDetails.relatedPlaylists.watchLater של משאב channel מכילים עכשיו את הערכים 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 מזהה את הנושאים שמשויכים לערוץ.
  • החלק topicDetails של המשאב video מציין את הנושאים שמשויכים לסרטון.
  • הפרמטר topicId של השיטה search.list מאפשר לכם לחפש סרטונים או ערוצים שקשורים לנושא מסוים.

  השינויים בתכונות האלה הם:

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

  • אפשר להשתמש במזהי נושאים של Freebase שכבר אחזרתם כדי לחפש תוכן עד 10 בפברואר 2017. אבל אחרי התקופה הזו, תוכלו להשתמש רק בקבוצה הקטנה יותר של נושאים שזוהו בפריט הקודם כדי לאחזר תוצאות חיפוש לפי נושא.

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

• ב-12 בספטמבר 2016 הוצאו משימוש כמה שדות ופרמטרים של API:

  • הפרמטר home של השיטה activities.list אפשר למשתמש מורשה לאחזר את פיד הפעילות שיוצג בדף הבית של YouTube עבור אותו משתמש. בקשות שמשתמשות בפרמטר הזה אחרי 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 של המשאב video או כל מאפיין צאצא שלו לא יוחזרו יותר אחרי 12 בספטמבר 2016. רק הבעלים של הסרטון יכול לאחזר את הנתונים האלה, כי רק הבעלים של הסרטון יכול לאחזר את אובייקט ההורה 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 (מסוף המפתחים של Google), שבו אפשר לראות את מכסת נפח האחסון בפועל ואת השימוש במכסה.

‫16 במרץ 2016

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

• עדכונים למשאבים ולשיטות קיימים

  • עדכנו את מסמכי התיעוד של המשאב channelBanner כדי לציין שהגודל המומלץ של תמונת הבאנר של הערוץ שמעלים הוא ‎2,560 x 1,440 פיקסלים. הגודל המינימלי (‎2,048 x 1,152 פיקסלים) לא השתנה.

  • המאפיין החדש 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 צריכה לכלול את כל הגרסאות הקיימות של הנתונים המותאמים לשוק מקומי. לדוגמה, אם שלחתם בקשה נוספת להוספת נתונים בפורטוגזית לסרטון שמופיע בדוגמה שלמעלה, הבקשה צריכה לכלול את הנתונים המותאמים לגרמנית, ספרדית ופורטוגזית.

• אחזור ערכים מותאמים לשוק המקומי

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

  • מוסיפים את הפרמטר hl לבקשה channels.list, channelSections.list, playlists.list או videos.list כדי לאחזר נתונים מותאמים לשפה של אפליקציה ספציפית שאתר YouTube תומך בה. אם פרטי משאב מקומיים זמינים בשפה הזו, אובייקט 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.

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

    השינוי הזה לא משקף שינוי בהתנהגות של ה-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. בעבר, במסמכים היה כתוב שאסור לספק גוף בקשה כשמפעילים את ה-method הזו. העדכון הזה לא משקף שינוי בהתנהגות ה-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 תיאור המשאב comment שמוסיפים או מעדכנים מכיל יותר מדי תווים במאפיין snippet.topLevelComment.snippet.textOriginal.
    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 של ה-method‏ 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 כשמתבצעת בערוץ אחת מהפעולות הבאות:

  • העלאת סרטון
  • עדכון השם של סרטון
  • מעדכן את תיאור הסרטון

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

• ההיקף החדש של ה-API‏, https://www.googleapis.com/auth/youtube.force-ssl, הוא עכשיו היקף תקף לכל שיטת 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 (מה חדש ב-API גרסה 3). בכרטיסייה הזו מפורטות התכונות ש-API גרסה 3 תומך בהן, וש-API גרסה 2 לא תמך בהן. התכונות האלה מופיעות גם בכרטיסיות אחרות במדריך. לדוגמה, התכונה החדשה שמסבירה איך לעדכן נתונים של קמפיין לקידום מכירות ב-In-video בערוץ מופיעה גם בכרטיסייה ערוצים (פרופילים).

• המדריך להעברת נתונים (מיגרציה) של YouTube Data API (גרסה 3) עודכן, ומופיעה בו הערה שלפיה API גרסה 3 יתמוך בתכונה הבאה של API גרסה 2:

  • סימון סרטון

• המדריך להעברת נתונים (מיגרציה) של 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 יכילו מידע על הסיבה להמלצה על הסרטון. חשוב לזכור שלא מובטח שהתשובה תכיל מספר מסוים של סרטונים מומלצים.

  • קבלת הצעות לערוצים

  • אחזור סרטונים חדשים מהמינויים – ב-API בגרסה 3 לא מתבצע אחזור של רשימה שמכילה רק סרטונים שהועלו לאחרונה לערוצים שהמשתמש ב-API נרשם אליהם כמנוי. עם זאת, אפשר להשתמש ב-v3 API כדי למצוא סרטונים חדשים של מינויים על ידי הפעלת השיטה activities.list והגדרת ערך הפרמטר home ל-true.

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

  • תמיכה בפיד RSS

  • התראות פוש על עדכוני פיד – ב-API בגרסה 2 הייתה תמיכה בהתראות פוש, באמצעות Simple Update Protocol‏ (SUP) או PubSubHubbub, כדי לעקוב אחרי פידים של פעילות משתמשים ב-YouTube. ההתראות שסופקו היו על הרשמה לערוץ חדש, על דירוג סרטונים, על שיתוף סרטונים, על סימון סרטונים כמועדפים, על הוספת תגובות ועל העלאת סרטונים.

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

  • מיקום הערוץ – ב-API גרסה 2 נעשה שימוש בתג <yt:location> כדי לזהות את מיקום המשתמש כפי שהוזן בפרופיל הציבורי של הערוץ ב-YouTube. חלק מהמפתחים השתמשו בשדה הזה כדי לשייך ערוץ למדינה מסוימת, אבל אי אפשר היה להשתמש בנתונים של השדה הזה באופן עקבי למטרה הזו.

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

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

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

    יש כמה מקרים חריגים. סרטון חדש שהועלה, סרטון שנוסף למועדפים, סרטון שאהבתם או סרטון שצפיתם בו לאחרונה יתווסף אוטומטית כפריט הראשון (snippet.position=0) בסוגי הפלייליסטים הבאים. לכן, כל אחת מהרשימות האלה מסודרת למעשה מהפריט החדש ביותר לפריט הישן ביותר, על סמך השעות שבהן הפריטים נוספו לרשימה.

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

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

  • עיבוד בקבוצות – גרסה 3 של ה-API תומכת באחד מתרחישי השימוש של עיבוד בקבוצות שגרסה 2 של ה-API תמכה בהם. כל ה-methods‏ channels.list,‏ channelSections.list,‏ guideCategories.list,‏ playlistItems.list,‏ playlists.list,‏ subscriptions.list,‏ videoCategories.list ו-videos.list של v3 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 משימוש.

• המאפיין contentDetails.contentRating.contentDetails.contentRating.djctqRatingReasons החדש של המשאב video מציין את הסיבות לכך שהסרטון קיבל את הסיווג DJCQT (ברזיל).

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

  סוג השגיאה	פרטי השגיאה	תיאור
  notFound (404)	channelNotFound	השיטה channels.update מחזירה את השגיאה הזו אם הפרמטר id של הבקשה מציין ערוץ שלא ניתן למצוא.
  badRequest (400)	manualSortRequiredinvalidValue	השגיאה הזו מוחזרת על ידי הפונקציות 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. (פרטים נוספים זמינים בקטע העלאת סרטון). הפונקציונליות הזו דומה להעלאה מבוססת-דפדפן שנתמכת ב-API מגרסה 2. הערה: השינוי הזה במדריך ההעברה לא משקף שינוי בפועל ב-API, אלא זמינות של קוד לדוגמה חדש להעלאת סרטונים באמצעות JavaScript בצד הלקוח.

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

• המסמכים של השיטה videos.insert עודכנו וכוללים עכשיו את דוגמת קוד ה-JavaScript החדשה שמתוארת למעלה. גם הרשימה של דוגמאות קוד JavaScript ל-YouTube Data API (גרסה 3) עודכנה.

‫11 בנובמבר 2014

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

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

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

  • עלות המכסה: 100 יחידות

    מבצעים קריאה ל-method search.list ומחפשים את GoogleDevelopers.

  • עלות המכסה: 6 יחידות

    מבצעים קריאה ל-method‏ 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 של בעלי הערוץ ב-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 resource יש עכשיו תמיכה בערכים הבאים:

  • ‫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 מחזיר קוד תגובה 204 HTTP לבקשות מוצלחות לשיטות האלה.

‫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 עודכנה כדי להסביר שאפשר לאחזר את האובייקט רק על ידי הבעלים של הערוץ.

• רשימת הפרמטרים של ה-method ‏videos.rate עודכנה כדי לשקף שה-method הזה לא תומך בפרמטר 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 לרשימת הערכים שאפשר להגדיר כשמוסיפים או מעדכנים סרטון:

  • recordingDetails.locationDescription
  • recordingDetails.location.latitude
  • recordingDetails.location.longitude
  • recordingDetails.recordingDate

• בתיעוד השגיאות מצוין עכשיו קוד התגובה של 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, כפוף עכשיו למדיניות הוצאה משימוש שמתוארת בתנאים ובהגבלות של ממשקי ה-API של YouTube. חשוב לציין שבדף שבו מפורטים ממשקי ה-API שחלה עליהם מדיניות הוצאה משימוש, יש החרגות ספציפיות לגבי פונקציונליות מסוימת של v3 API, שלא חלה עליה המדיניות.

‫5 בדצמבר 2013

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

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

• הגדרות הפרמטרים של השיטה search.list עודכנו, ועכשיו מצוין בהן שצריך להגדיר את ערך הפרמטר type ל-video אם מציינים גם ערך לאחד מהפרמטרים הבאים:

  • eventType
  • videoCaption
  • videoCategoryId
  • videoDefinition
  • videoDimension
  • videoDuration
  • videoEmbeddable
  • videoLicense
  • videoSyndicated
  • videoType

• הגודל המינימלי של תמונות באנר של ערוץ שהועלו הוקטן ל-2,048x1,152 פיקסלים. (בעבר, הגודל המינימלי היה ‎2,120 x 1,192 פיקסלים). בנוסף, חשוב לשים לב שבמסמכי המשאבים של channel מצוינים הגדלים המקסימליים של כל תמונות הבאנרים שמוצגות מה-API. לדוגמה, הגודל המקסימלי של תמונת brandingSettings.image.bannerTvImageUrl לאפליקציות לטלוויזיה הוא 2,120 פיקסלים על 1,192 פיקסלים, אבל הגודל בפועל של התמונה יכול להיות 2,048 פיקסלים על 1,152 פיקסלים. במרכז העזרה של 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.

  • המאפיין החדש snippet.liveBroadcastContent של משאב video מציין אם הסרטון הוא שידור חי פעיל או שידור חי שצפוי להתחיל בקרוב. ברשימה הבאה מוסבר על הערכים האפשריים של המאפיין:

    • ‫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 שאפשר לשנות. אפשר היה לשנות את המאפיינים האלה של brandingSettings גם קודם, ולכן השינוי במסמכים לא משקף שינוי בפונקציונליות הקיימת של ה-API.

• השיטות playlists.insert,‏ playlists.update ו-playlists.delete תומכות עכשיו בפרמטר onBehalfOfContentOwner, שכבר נתמך בכמה שיטות אחרות.

• השיטה playlists.insert תומכת עכשיו בפרמטר onBehalfOfContentOwnerChannel, שכבר נתמך בכמה שיטות אחרות.

• המאפיין 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 של המשאב הוסר.

• השיטה thumbnails.set תומכת עכשיו בפרמטר onBehalfOfContentOwner, שכבר נתמך בכמה שיטות אחרות.

• השיטה 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)

  שימו לב שגם הדוגמה ל-method playlistItems.insert ב-Python הוסרה, כי הפונקציונליות שהיא הדגימה מטופלת עכשיו על ידי ה-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 resource מציין את הסיווגים שסרטון קיבל במסגרת תוכניות סיווג שונות, כולל סיווגים של 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, שמכיל מידע על קמפיין קידום מכירות שמשויך לערוץ. בערוץ אפשר להשתמש בקמפיין לקידום סרטונים ב-In-video כדי להציג תמונות ממוזערות של סרטון מקודם בתוך נגן הווידאו במהלך הפעלת הסרטונים של הערוץ.

  כדי לאחזר את הנתונים האלה, צריך לכלול את 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 לא יכול להיות יותר ערך אפשרי לאף אחד מהמאפיינים הבאים:

  • fileDetails.fileType
  • fileDetails.videoStreams[].rotation
  • processingDetails.processingStatus
  • processingDetails.processingFailureReason
  • fileDetails.fileType

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

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

‫19 באפריל 2013

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

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

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

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

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

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

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

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

  • אובייקט status החדש מכיל מידע על הסטטוס של פריט הפלייליסט, ומאפיין status.privacyStatus מציין את סטטוס הפרטיות של פריט הפלייליסט.

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

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

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

    Country	מערכת סיווג	נכס
    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	‫Canadian Home Video Rating System (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	המינהל הכללי של רדיו, טלוויזיה וקולנוע (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, שנתמך על ידי ה-method ‏ 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

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

• בדף השגיאות החדש מפורטות השגיאות שה-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

• activity עכשיו אפשר לדווח על פעולת channelItem של משאב, שמתרחשת כשמערכת 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 כדי לאחזר רשימה של ערכים תקינים.