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

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

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

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

‫6 באוגוסט 2026

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

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

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

‫4 בדצמבר 2025

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

‫10 ביולי 2025

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

‫26 במרץ 2025

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

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

• channels.statistics.viewCount
• videos.statistics.viewCount

‫30 באוקטובר 2024

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

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

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

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

‫30 באפריל 2024

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

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

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

‫13 במרץ 2024

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

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

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

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

‫12 במרץ 2024

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

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

‫7 במרץ 2024

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

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

‫31 בינואר 2024

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

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

‫9 בנובמבר 2023

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

‫12 בספטמבר 2023

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

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

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

‫22 באוגוסט 2023

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

‫18 באוגוסט 2023

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

‫7 באוגוסט 2023

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

‫28 ביוני 2023

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

‫12 ביוני 2023

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

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

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

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

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

‫2 ביולי 2021

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

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

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

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

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

‫15 באוקטובר 2020

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

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

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

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

‫8 באוקטובר 2020

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

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

9 בספטמבר 2020

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

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

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

29 ביולי, 2020

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

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

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

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

28 ביולי 2020

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

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

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

21 ביולי 2020

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

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

7 ביולי 2020

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

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

‫15 ביוני 2020

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

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

4 ביוני 2020

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

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

17 באפריל 2020

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

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

31 במרץ 2020

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

• משאבים ושיטות חדשים

  • המשאב החדש member מייצג חבר במועדון של ערוץ ב-YouTube. חברי המועדון תומכים ביוצרים באופן קבוע ומקבלים הטבות מיוחדות. לדוגמה, חברי המועדון יכולים לשוחח בצ'אט כשהיוצר מפעיל את המצב 'צ'אט לחברי מועדון בלבד'.

    המשאב הזה מחליף את המשאב sponsor שמתועד כחלק מ-YouTube Live Streaming API. המשאב sponsor הוצא משימוש, ולקוחות API צריכים לעדכן את הקריאות ל-method ‏sponsors.list כדי להשתמש במקומה ב-method ‏members.list.

  • המשאב החדש membershipsLevel מזהה רמת תמחור שמנוהלת על ידי היוצר שהרשה את בקשת ה-API. ה-method‏ membershipsLevels.list מחזירה רשימה של כל רמות החברות של היוצר.

‫10 בינואר 2020

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

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

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

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

‫10 בספטמבר 2019

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

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

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

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

4 באפריל 2019

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

• עדכנו את מאמרי העזרה של ה-API כדי להסביר טוב יותר תרחישי שימוש נפוצים לכל שיטה, וכדי לספק דוגמאות קוד דינמיות ואיכותיות באמצעות הווידג'ט APIs Explorer. דוגמה מופיעה במסמכי העזרה של השיטה channels.list. נוספו שני רכיבים חדשים לדפים שמתארים שיטות API:

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

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

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

  דוגמאות קוד נתמכות כרגע בשפות Java,‏ JavaScript,‏ PHP,‏ Python ו-curl.

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

  בנוסף לשינוי הזה, הסרנו את הדפים שבהם הופיעו דוגמאות קוד זמינות ל-Java,‏ JavaScript,‏ PHP ו-Python.

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

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

9 ביולי 2018

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

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

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

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

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

‫22 ביוני 2018

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

‫27 בנובמבר 2017

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

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

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

  עדיין אפשר לאחזר ולהגדיר נתונים של invideoPromotion עד 14 בדצמבר 2017. אחרי התאריך הזה:

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

  אחרי 27 במאי 2018, יכול להיות שהבקשות האלה יחזירו הודעות שגיאה כדי לציין, לדוגמה, ש-invalidPromotion הוא חלק לא תקין.

‫16 בנובמבר 2017

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

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

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

  • הפונקציה removeEmptyParameters מקבלת רשימה של צמדי מפתח-ערך שמתאימים לפרמטרים של בקשת API, ומסירה את הפרמטרים שלא הוגדרו להם ערכים.
  • הפונקציה createResource מקבלת רשימה של צמדי מפתח/ערך שמתאימים למאפיינים במשאב API. לאחר מכן, המערכת ממירה את המאפיינים לאובייקט JSON שאפשר להשתמש בו בפעולות insert ו-update. בדוגמה הבאה מוצגת קבוצה של שמות מאפיינים וערכים, ואובייקט ה-JSON שהקוד ייצור עבורם:

    # Key-value pairs:
    {'id': 'ABC123',
     'snippet.title': 'Resource title',
     'snippet.description': 'Resource description',
     'status.privacyStatus': 'private'}
    
    # JSON object:
    {
     'id': 'ABC123',
     'snippet': {
       'title': 'Resource title',
       'description': 'Resource description',
     },
     'status': {
       'privacyStatus': 'private'
     }
    }

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

‫25 באוקטובר 2017

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

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

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

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

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

‫29 באוגוסט 2017

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

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

‫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 מזהה את הדירוג שאיגוד Motion Picture Association of America (‏MPAA) העניק לטריילר או לתצוגה מקדימה של סרט.

‫27 בפברואר 2017

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

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

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

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

• הנושא Animated cartoon, שהיה בעבר נושא צאצא של Entertainment, הוסר.
• הנושא Children's music, שהיה בעבר נושא צאצא של Music, הוסר.

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

‫29 בנובמבר 2016

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

• ב-10 בפברואר 2017 יחולו שלושה שינויים קלים ברשימת מזהי הנושאים שיתמכו ב-Google Ads:

  • הקטגוריה Professional wrestling, שהייתה בעבר קטגוריית צאצא של הקטגוריה Sports, היא עכשיו קטגוריית צאצא של Entertainment.
  • הקטגוריה TV shows, שהיא צאצא של Entertainment, היא חדשה.
  • הקטגוריה Health, שהייתה בעבר קטגוריית צאצא של Lifestyle, הוסרה.

  כמו כן, שימו לב שישנן מספר קטגוריות אב (Entertainment, Gaming, Lifestyle, Music ו-Sports). כל סרטון המשויך לקטגוריית צאצא, כמו Tennis, ישויך גם לקטגוריית האב (Sports).

‫10 בנובמבר 2016

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

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

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

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

  • המאפיין topicDetails.topicIds[] של המשאב channel.
  • המאפיין topicDetails.relevantTopicIds[] של המשאב video.
  • הפרמטר topicId של השיטה search.list.

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

  המאפיינים הבאים יוצאו משימוש:

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

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

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

‫2 בנובמבר 2016

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

• מאפיינים ופרמטרים חדשים

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

    • המאפיין player.embedHtml מכיל תג <iframe> שאפשר להשתמש בו כדי להטמיע נגן שמפעיל את הסרטון. המאפיינים החדשים player.embedHeight ו-player.embedWidth מזהים את הממדים של נגן מוטמע. המאפיינים האלה מוחזרים רק אם בבקשת ה-API מצוין ערך לפחות לאחד מהפרמטרים maxHeight או maxWidth. בהמשך הרשומה הזו בהיסטוריית גרסאות מוסבר על שני הפרמטרים החדשים האלה.

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

    • התג החדש fpbRatingReasons[] מציין את הסיבות לכך שהסרטון קיבל את הסיווג של FPB (דרום אפריקה).

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

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

    כברירת מחדל, הגובה של <iframe> שמוחזר במאפיין player.embedHtml הוא 360px. הרוחב מותאם ליחס הגובה-רוחב של הסרטון, וכך מוודאים שבנגן המוטמע לא יהיו פסים שחורים שממסגרים את הסרטון. לדוגמה, אם יחס הגובה-רוחב של סרטון הוא 16:9, הרוחב של הנגן יהיה 640px.

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

    לדוגמה, נניח שיחס הגובה-רוחב של סרטון הוא 16:9. לכן, התג player.embedHtml יכיל נגן בגודל 640x360 אם הפרמטר maxHeight או maxWidth לא מוגדר.

    • אם הפרמטר maxHeight מוגדר לערך 720, והפרמטר maxWidth לא מוגדר, ה-API יחזיר נגן בגודל 1280x720.
    • אם הפרמטר maxWidth מוגדר לערך 960, והפרמטר maxHeight לא מוגדר, ה-API יחזיר נגן בגודל 960x540.
    • אם הפרמטר maxWidth מוגדר ל-960, והפרמטר maxHeight מוגדר ל-450, ממשק ה-API יחזיר נגן בגודל 800x450.

    המאפיינים החדשים player.embedHeight ו-player.embedWidth, שמתוארים למעלה, מזהים את המידות של נגן הווידאו.

• עדכונים לשיטות, לנכסים ולפרמטרים קיימים

  • תיאור המשאב channelSection עודכן, ועכשיו מצוין בו שאפשר ליצור בערוץ עד 10 מדפים בלי להגדיר נתוני טירגוט, ועד 100 מדפים עם נתוני טירגוט.

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

  • ההגדרה של המאפיין i18nLanguage של משאב snippet.name תוקנה כדי לשקף שהערך מייצג את שם השפה כפי שהוא נכתב בשפה שצוינה בפרמטר hl של שיטת i18nLanguage.list.

  • המאפיין contentDetails.note של המשאב playlistItem עודכן כדי לציין שהאורך המקסימלי של ערך המאפיין הוא 280 תווים.

  • המאפיינים contentDetails.startAt ו-contentDetails.endAt של המשאב playlistItem יצאו משימוש. המערכת מתעלמת מהשדות האלה אם הם מוגדרים בבקשות playlistItems.insert או playlistItems.update.

  • השיטות playlistItems.delete ו-playlistItems.update תומכות עכשיו בפרמטר onBehalfOfContentOwner, שכבר נתמך בכמה שיטות אחרות. בקשות שמשתמשות בשיטה הזו צריכות גם להיות מאושרות באמצעות אסימון שמעניק גישה להיקף https://www.googleapis.com/auth/youtubepartner.

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

  • מאפיין ה-contentDetails.contentRating.grfilmRating של משאב ה-video תומך בשלושה ערכים נוספים: grfilmK12,‏ grfilmK15 ו-grfilmK18.

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

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

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

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

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

• עדכונים אחרים

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

‫15 בספטמבר 2016

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

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

• השינויים הבאים נכנסו לתוקף: הודעה על השינויים האלה נמסרה בעדכון של היסטוריית הגרסאות ב-11 באוגוסט 2016:

  • אם קוראים לשיטה activities.list עם הפרמטר home שמוגדר לערך true, תגובת ה-API מכילה עכשיו פריטים דומים לאלה שמשתמש לא מחובר ב-YouTube רואה בדף הבית.

    זהו שינוי קל שמטרתו לספק חוויית משתמש טובה יותר מההתנהגות שתוארה בעדכון של היסטוריית הגרסאות מ-11 באוגוסט 2016. בעדכון הזה צוין שבקשות שמשתמשות בפרמטר home יחזירו רשימה ריקה.

  • המאפיינים channel ו-contentDetails.relatedPlaylists.watchHistory של משאב contentDetails.relatedPlaylists.watchLater מכילים עכשיו את הערכים HL ו-WL, בהתאמה, לכל הערוצים.

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

    בנוסף, בקשות לאחזור פרטים של פלייליסט (playlists.list) או פריטים בפלייליסט (playlistItems.list) עבור היסטוריית הצפייה או הפלייליסט 'לצפייה בהמשך' של ערוץ מחזירות עכשיו רשימות ריקות. ההתנהגות הזו נכונה לגבי הערכים החדשים, HL ו-WL, וגם לגבי מזהים של היסטוריית צפייה או של רשימות השמעה של צפייה בהמשך, שאולי כבר אוחסנו על ידי לקוח ה-API.

• האובייקט fileDetails.recordingLocation של המשאב video ומאפייני הצאצא שלו לא מוחזרים יותר. בעבר, רק בעלי הסרטון יכלו לאחזר את הנתונים האלה (למשל, אובייקט האב fileDetails).

‫11 באוגוסט 2016

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

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

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

• הוצאה משימוש של Freebase ושל Freebase API גורמת לכמה שינויים שקשורים למזהי נושאים. מזהי נושאים משמשים במשאבי ה-API ובשיטות הבאות:

  • החלק topicDetails של המשאב channel מזהה נושאים שמשויכים לערוץ.
  • החלק video של המשאב topicDetails מזהה את הנושאים שמשויכים לסרטון.
  • הפרמטר topicId של השיטה search.list מאפשר לחפש סרטונים או ערוצים שקשורים לנושא מסוים.

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

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

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

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

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

  • הפרמטר home של השיטה 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 שלך.

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

‫16 במרץ 2016

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

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

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

  • המאפיין החדש snippet.customUrl של משאב channel מזהה את כתובת ה-URL המותאמת אישית שמשויכת לערוץ. (לא לכל הערוצים יש כתובות URL מותאמות אישית). במרכז העזרה של YouTube מוסברות דרישות הסף לקבלת כתובת URL מותאמת אישית וגם איך להגדיר את כתובת ה-URL.

  • הוצאנו משימוש את אובייקט brandingSettings.watch של המשאב channel ואת כל נכסי הצאצאים שלו.

  • תגובת ה-API לבקשת search.list מכילה עכשיו את המאפיין regionCode. המאפיין מזהה את קוד האזור ששימש לשאילתת החיפוש. קוד האזור מורה ל-API להחזיר תוצאות חיפוש עבור המדינה שצוינה.

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

  • הגדרות המאפיינים snippet.label ו-snippet.secondaryReasons[].label של המשאב videoAbuseReportReason עודכנו. עכשיו מצוין שהמאפיינים מכילים טקסט של תווית מותאמת לשפה המקומית של הסיבות לדיווח על התנהלות פוגעת.

    בנוסף, השיטה videoAbuseReportReasons.list תומכת עכשיו בפרמטר hl, שמציין את השפה שבה צריך להשתמש בטקסט של התווית בתגובת ה-API. ערך ברירת המחדל של הפרמטר הוא en_US.

  • המאפיין contentDetails.contentRating.ecbmctRating החדש של המשאב video מזהה את סיווג הסרטון על ידי מועצת ההערכה והסיווג של משרד התרבות והתיירות בטורקיה.

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

    • ‫contentDetails.contentRating.fpbRating (דרום אפריקה)
      סיווג: 10; ערך המאפיין: fpb10
    • contentDetails.contentRating.moctwRating (טייוואן)
      סיווג: R-12; ערך המאפיין: moctwR12
    • contentDetails.contentRating.moctwRating (טייוואן)
      סיווג: R-15; ערך מאפיין: moctwR15

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

  • המאפיין status.rejectionReason במשאב video תומך בערך המאפיין החדש legal.

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

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

‫18 בדצמבר 2015

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

‫19 בנובמבר 2015

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

• הגדרת כותרות ותיאורים מותאמים מקומית

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

  • מוודאים שמוגדר ערך למאפיין snippet.defaultLanguage של המשאב. המאפיין הזה מציין את השפה של מאפייני המשאב snippet.title ו-snippet.description. הערך יכול להיות כל שפה נתמכת באפליקציה או רוב קודי השפה האחרים לפי תקן ISO 639-1:2002. לדוגמה, אם מעלים סרטון עם שם ותיאור באנגלית, צריך להגדיר את המאפיין snippet.defaultLanguage כ-en.

    הערה לגבי עדכון משאבי channel: כדי להגדיר את המאפיין snippet.defaultLanguage למשאב channel, צריך לעדכן את המאפיין brandingSettings.channel.defaultLanguage.

  • מוסיפים את האובייקט localizations למקור המידע שרוצים לעדכן. כל מפתח אובייקט הוא מחרוזת שמזהה שפה של אפליקציה או קוד שפה לפי תקן ISO 639-1:2002, וכל מפתח ממופה לאובייקט שמכיל את השם המקומי (והתיאור) של המשאב.

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

    {
      "kind": "youtube#video",
      ...
      "snippet": {
        "title": "Playing soccer",
        "description": "We play soccer in the park on Sundays.",
        "defaultLanguage": "en",
        ...
      },
      "localizations":
        "de": {
          "title": "Fußball spielen",
          "description": "Wir spielen Fußball im Park am Sonntag"
        },
        "es": {
          "title": "Jugar al fútbol",
          "description": "Nosotros jugamos fútbol en el parque los domingos",
        }
      }
    }

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

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

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

  • מוסיפים את הפרמטר hl לבקשת channels.list, channelSections.list, playlists.list או videos.list כדי לאחזר נתונים מותאמים לשפה מסוימת של האפליקציה שאתר YouTube תומך בה (application language). אם פרטי משאב מקומיים זמינים בשפה הזו, אובייקט snippet.localized של המשאב יכיל את הערכים המקומיים. עם זאת, אם פרטים מותאמים לשוק המקומי לא זמינים, אובייקט snippet.localized יכיל פרטי משאב בשפת ברירת המחדל של המשאב.

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

    {
      "kind": "youtube#video",
      ...
      "snippet": {
        "title": "Playing soccer",
        "description": "We play soccer in the park on Sundays.",
        "defaultLanguage": "en",
        "localized": {
          "title": "Fußball spielen",
          "description": "Wir spielen Fußball im Park am Sonntag"
        }
        ...
      }
    }

    עם זאת, אם הפרמטר hl היה מוגדר ל-fr, האובייקט snippet.localized היה מכיל את הכותרת והתיאור באנגלית מכיוון שאנגלית היא שפת ברירת המחדל עבור המשאב, ופרטים מקומיים בצרפתית אינם זמינים.

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

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

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

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

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

‫4 בנובמבר 2015

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

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

  • הפרמטר order של השיטה search.list עודכן כדי לציין שאם ממיינים שידורים חיים לפי viewCount, תוצאות ה-API ממוינות לפי מספר הצופים בו-זמנית בשידורים בזמן שהם עדיין מתבצעים.

  • הפרמטר relatedToVideoId של השיטה search.list עודכן כך שאם הפרמטר מוגדר, הפרמטרים הנתמכים היחידים האחרים הם part, maxResults, pageToken, regionCode, relevanceLanguage, safeSearch, type (אשר חייב להיות מוגדר ל-video) ו-fields. העדכון הזה לא משקף שינוי בהתנהגות ה-API.

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

    השינוי הזה לא משקף שינוי בהתנהגות של ה-API.

  • ההגדרה של המאפיין status.publishAt במשאב video עודכנה, ועכשיו מצוין בה:

    • אם מגדירים את הערך של המאפיין הזה כשמפעילים את השיטה videos.update, צריך להגדיר גם את הערך של המאפיין status.privacyStatus כ-private, גם אם הסרטון כבר פרטי.
    • אם הבקשה מתזמנת פרסום של סרטון למועד כלשהו בעבר, הסרטון יפורסם מיד. לפיכך, ההשפעה של הגדרת המאפיין status.publishAt לתאריך ושעה מהעבר זהה לשינוי privacyStatus של הסרטון מ-private ל-public.

  • המאפיין contentDetails.contentRating.cncRating של המשאב video מציין את דירוג הסרטון על ידי הוועדה לסילוק סינמטוגרפי של צרפת. המאפיין הזה מחליף את המאפיין contentDetails.contentRating.fmocRating, שיצא משימוש.

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

  • המסמכים של שיטת thumbnails.set עודכנו כדי לשקף בצורה מדויקת שגוף הבקשה מכיל את תמונת המיניאטורה שאתם מעלים ומשייכים לסרטון. גוף הבקשה לא מכיל משאב thumbnail. בעבר, בתיעוד נאמר שאין לספק גוף בקשה בעת קריאה לשיטה זו. העדכון הזה לא משקף שינוי בהתנהגות ה-API.

  • התיאור של משאב activity עודכן כדי לשקף את העובדה ששיטת activities.list לא כוללת כרגע משאבים שקשורים לתגובות חדשות לסרטונים. גם הערכים של המאפיינים snippet.type ו-contentDetails.comment של המשאב עודכנו.

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

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

    פרטי השגיאה
    activities.insert	קוד תגובת HTTP badRequest (400) סיבה invalidMetadata תיאור הנכס kind לא תואם לסוג המזהה שצוין.
    commentThreads.update comments.insert comments.update	קוד תגובת HTTP badRequest (400) סיבה commentTextTooLong תיאור המאפיין snippet.topLevelComment.snippet.textOriginal במשאב comment שמוסיפים או מעדכנים מכיל יותר מדי תווים.
    playlistItems.insert playlistItems.update	קוד תגובת HTTP forbidden (403) סיבה playlistItemsNotAccessible תיאור אין הרשאה מתאימה בבקשה להוספה, לעדכון או למחיקה של פריט הפלייליסט שצוין.
    playlists.delete playlists.insert playlists.update	קוד תגובת HTTP badRequest (400) סיבה playlistForbidden תיאור הפעולה הזו אסורה או שהבקשה לא אושרה כמו שצריך.
    search.list	קוד תגובת HTTP badRequest (400) סיבה invalidLocation תיאור הפורמט של ערך הפרמטר location או locationRadius שגוי.
    search.list	קוד תגובת HTTP badRequest (400) סיבה invalidRelevanceLanguage תיאור הפורמט של ערך הפרמטר relevanceLanguage שגוי.
    subscriptions.insert	קוד תגובת HTTP badRequest (400) סיבה subscriptionForbidden תיאור השגיאה הזו מתרחשת אם מתקיים אחד מהתנאים הבאים: המנוי שאתה מנסה ליצור כבר קיים כבר הגעת למספר המנויים המקסימלי שלך ניסית להירשם לערוץ שלך, וזה לא אפשרי. יצרת יותר מדי מינויים לאחרונה, ולכן צריך להמתין כמה שעות לפני שמנסים שוב לשלוח את הבקשה.
    videos.update	קוד תגובת HTTP badRequest (400) סיבה invalidDefaultBroadcastPrivacySetting תיאור הבקשה מנסה להגדיר הגדרת פרטיות לא חוקית לשידור ברירת המחדל.

28 באוגוסט, 2015

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

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

  • המאפיין statistics.favoriteCount של המשאב video יצא משימוש.

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

‫7 באוגוסט 2015

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

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

  • העדכנו את ההגדרה של מאפיין video snippet.tags[] המשאב כדי לספק מידע נוסף על האופן שבו שרת ה-API מחשב את אורך הערך של המאפיין. הערה: העדכון הזה לא משקף שינוי בהתנהגות של ה-API.

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

  • השיטה commentThreads.insert כבר לא תומכת בפרמטר shareOnGooglePlus, שבעבר ציין אם תגובה ותשובות לתגובה הזו צריכות להתפרסם גם בפרופיל Google+ של המחבר. אם הבקשה כוללת את הפרמטר, שרת ה-API מתעלם מהפרמטר אבל מטפל בבקשה.

‫18 ביוני 2015

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

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

  • הפרמטר החדש order של השיטה commentThreads.list מציין את הסדר שבו שרשורי התגובות צריכים להופיע בתגובת ה-API. אפשר לסדר את השרשורים לפי זמן או לפי רלוונטיות. ההתנהגות שמוגדרת כברירת מחדל היא סידור לפי זמן.

  • המאפיין החדש snippet.defaultAudioLanguage של משאב video מציין את השפה שמדוברת בטראק האודיו שמוגדר כברירת המחדל בסרטון.

  • הגדרת המאפיין contentDetails.licensedContent של המשאב video עודכנה כדי להבהיר שהתוכן חייב להיות מועלה במקור לערוץ המקושר לשותף תוכן של YouTube ולאחר מכן נתבע על ידי אותו שותף. השינוי הזה לא משקף שינוי בהתנהגות בפועל של ה-API.

  • השיטות captions.delete,‏ captions.download,‏ captions.insert,‏ captions.list ו-captions.update תומכות עכשיו בפרמטר onBehalfOfContentOwner, שכבר נתמך בכמה שיטות אחרות. בקשות שמשתמשות בשיטה הזו צריכות גם להיות מאושרות באמצעות אסימון שמעניק גישה להיקף https://www.googleapis.com/auth/youtubepartner.

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

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

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

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

‫27 באפריל 2015

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

• משאבים ושיטות חדשים

  • המשאב החדש videoAbuseReportReason מכיל מידע על הסיבה לסימון סרטון בגלל תוכן פוגעני. ה-method‏ videoAbuseReportReasons.list מאפשרת לאחזר רשימה של כל הסיבות האפשריות לסימון סרטונים.

  • השיטה החדשה videos.reportAbuse מאפשרת לדווח על סרטון שמכיל תוכן פוגעני. גוף הבקשה מכיל אובייקט JSON שמציין את הסרטון שסומן ואת הסיבה לכך שהסרטון נחשב כתוכן פוגע. אפשר למצוא סיבות תקפות בשיטה videoAbuseReportReason.list שמתוארת למעלה.

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

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

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

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

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

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

  • המאפיין החדש snippet.country של משאב channel מאפשר לבעלי ערוצים לשייך את הערוצים שלהם למדינה מסוימת.

    הערה: כדי להגדיר את המאפיין snippet.country למשאב channel, צריך לעדכן את המאפיין brandingSettings.channel.country.

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

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

    • targeting.languages[]: רשימה של שפות של אפליקציות YouTube. משתמשים שבחרו באחת מהשפות האלה יכולים לראות את הקטע המתאים בערוץ.

    • targeting.regions[]: רשימה של אזורי תוכן מועדפים של YouTube. הקטע בערוץ גלוי למשתמשים שבחרו באחד מהאזורים האלה, וגם למשתמשים שאחד מהאזורים האלה נבחר עבורם באופן אוטומטי.

    • ‫targeting.countries[]: רשימה של מדינות שבהן קטע הערוצים גלוי. כל ערך ברשימה הוא קוד מדינה בן שתי אותיות לפי תקן ISO 3166-1 alpha-2.

  • ההגדרה של המאפיין contentDetails.duration של המשאב video תוקנה כדי לשקף שהערך יכול לשקף שעות, ימים וכן הלאה.

  • במסמכי התיעוד של השיטות channelSections.delete,‏ playlistItems.delete,‏ playlists.delete,‏ subscriptions.delete ו-videos.delete בוצע תיקון שמשקף את העובדה שאם השיטות האלה מצליחות, הן מחזירות קוד תגובה של HTTP ‏204 (No Content).

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

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

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

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

‫16 באפריל 2015

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

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

  במדריך מפורטות גם כמה תכונות של תגובות שלא נתמכו ב-API בגרסה 2, אבל נתמכות ב-API בגרסה 3. למשל:

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

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

‫9 באפריל 2015

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

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

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

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

    ה-API תומך בשיטות הבאות למשאבי commentThread:

    • ‫commentThreads.list – אחזור רשימה של שרשורי תגובות. אפשר להשתמש בשיטה הזו כדי לאחזר תגובות שמשויכות לסרטון או לערוץ מסוימים.
    • commentThreads.insert – יצירת תגובה חדשה ברמה העליונה. (משתמשים ב-comments.insert method כדי להשיב לתגובה קיימת).
    • ‫commentThreads.update – שינוי תגובה ברמה העליונה.

  • משאב comment מכיל מידע על תגובה אחת ב-YouTube. משאב comment יכול לייצג תגובה על סרטון או על ערוץ. בנוסף, התגובה יכולה להיות תגובה ברמה העליונה או תשובה לתגובה ברמה העליונה.

    ה-API תומך בשיטות הבאות למשאבי comment:

    • ‫comments.list – אחזור רשימה של תגובות. משתמשים בשיטה הזו כדי לאחזר את כל התשובות לתגובה מסוימת.
    • comments.insert – יצירת תשובה לתגובה קיימת.
    • ‫comments.update – עריכת תגובה.
    • ‫comments.markAsSpam – סימון תגובה אחת או יותר כספאם.
    • ‫comments.setModerationStatus – הגדרת סטטוס ניהול התגובות של תגובה אחת או יותר. לדוגמה, לאשר תגובה להצגה לציבור או לדחות תגובה כי היא לא מתאימה להצגה. הבקשה ל-API צריכה להיות מאושרת על ידי הבעלים של הערוץ או הסרטון שמשויכים לתגובות.
    • ‫comments.delete – מחיקת תגובה.

  שימו לב שנדרש היקף ההרשאות https://www.googleapis.com/auth/youtube.force-ssl החדש של ה-API, שמתואר בהיסטוריית הגרסאות מ-2 באפריל 2015, כדי לבצע קריאות לשיטות comments.insert,‏ comments.update,‏ comments.markAsSpam,‏ comments.setModerationStatus,‏ comments.delete,‏ commentThreads.insert ו-commentThreads.update.

• במדריך החדש Subscribing to push notifications (הרשמה לקבלת התראות פוש) מוסבר על התמיכה החדשה של ה-API בהתראות פוש דרך PubSubHubBub, פרוטוקול פרסום/הרשמה משרת לשרת למשאבים שנגישים באינטרנט. שרת ה-callback של PubSubHubBub יכול לקבל התראות על פיד Atom כשמתבצעת בערוץ אחת מהפעולות הבאות:

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

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

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

• היקף ההרשאות החדש https://www.googleapis.com/auth/youtube.force-ssl של ה-API מחייב שהתקשורת עם שרת ה-API תתבצע דרך חיבור SSL.

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

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

‫11 במרץ 2015

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

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

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

  • סימון סרטון בדגל

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

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

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

  • אחזור הצעות לערוצים

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

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

  • תמיכה בפיד RSS

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

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

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

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

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

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

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

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

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

  • עיבוד בקבוצות – גרסה 3 של ה-API תומכת באחד מתרחישי השימוש של עיבוד בקבוצות שגרסה 2 של ה-API תמכה בהם. כל ה-API methods‏ channels.list,‏ channelSections.list,‏ guideCategories.list,‏ playlistItems.list,‏ playlists.list,‏ subscriptions.list,‏ videoCategories.list ו-videos.list בגרסה 3 של ה-API תומכים בפרמטר id, שאפשר להשתמש בו כדי לציין רשימה של מזהים (מזהי סרטונים, מזהי ערוצים וכו') שמופרדים באמצעות פסיקים. באמצעות השיטות האלה, אפשר לאחזר רשימה של כמה משאבים בבקשה אחת.

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

4 במרץ, 2015

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

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

• הנכסים הבאים והנכסים המשניים שלהם הוצאו משימוש:

  • brandingSettings.image.backgroundImageUrl
  • brandingSettings.image.largeBrandedBannerImageImapScript
  • brandingSettings.image.largeBrandedBannerImageUrl
  • brandingSettings.image.smallBrandedBannerImageImapScript
  • brandingSettings.image.smallBrandedBannerImageUrl

  הערה: אף אחד מהמאפיינים האלה לא היה כפוף למדיניות הוצאת API משימוש.

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

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

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

‫2 במרץ 2015

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

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

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

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

‫14 בינואר 2015

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

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

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

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

‫11 בנובמבר 2014

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

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

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

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

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

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

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

    לאחר מכן קוראים לשיטה playlistItems.list ומגדירים את הפרמטר playlistId למזהה שתועד ואת הפרמטר part לערך snippet.

‫8 באוקטובר 2014

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

• במשאב channel יש שני מאפיינים חדשים:

  • המאפיין status.longUploadsStatus מציין אם הערוץ עומד בדרישות להעלאת סרטונים באורך של יותר מ-15 דקות. המאפיין הזה מוחזר רק אם הבעלים של הערוץ אישר את בקשת ה-API. הערכים התקינים של המאפיין הם:

    • ‫allowed – אפשר להעלות לערוץ סרטונים באורך של יותר מ-15 דקות.
    • ‫eligible – בערוץ אפשר להעלות סרטונים באורך של יותר מ-15 דקות, אבל קודם צריך להפעיל את התכונה.
    • disallowed – הערוץ אינו מסוגל או זכאי להעלות סרטונים שאורכם עולה על 15 דקות.

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

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

• הגדרות המאפיינים snippet.title ו-snippet.categoryId של המשאב video עודכנו כדי להבהיר את האופן שבו ה-API מטפל בקריאות לשיטה videos.update. אם קוראים לשיטה הזו כדי לעדכן את החלק snippet במשאב video, צריך להגדיר ערך לשני המאפיינים האלה.

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

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

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

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

‫12 בספטמבר 2014

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

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

‫13 באוגוסט 2014

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

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

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

‫12 באוגוסט 2014

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

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

‫8 ביולי 2014

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

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

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

‫18 ביוני 2014

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

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

  חשוב לזכור שעלויות המכסה יכולות להשתנות ללא אזהרה.

• המשאב video תומך עכשיו ב-43 מערכות חדשות לסיווג תוכן, שמזהות את הסיווגים שסרטונים קיבלו מסוכנויות סיווג לאומיות שונות. מערכות הדירוג הנתמכות החדשות הן מארגנטינה, אוֹסְטְרֵיָה, בלגיה, בולגריה, צ'ילה (טֵלֶוִיזִיָה ), צ'ילה (סֶרֶט ), צ'כיה, קולומביה, דנמרק, מִצְרַיִם, אסטוניה, פינלנד, צָרְפַת, יָוָן, הונג קונג, אִיסלַנד, אִינדוֹנֵזִיָה, אירלנד, יִשְׂרָאֵל, אִיטַלִיָה, קניה, לטביה, לוקסמבורג, מלזיה, האיים המלדיביים, מלטה, הוֹלַנד, ניגריה, נורבגיה, פרו, הפיליפינים, פּוֹרטוּגָל, רומניה, סינגפור, סלובקיה, דרום אפריקה, שבדיה, שוויץ, טייוואן, תאילנד, וונצואלה.

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

‫2 במאי 2014

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

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

  ה-API תומך בשיטה לרישום של שפות האפליקציה הנתמכות. ניתן להשתמש בשפות נתמכות כערך של הפרמטר hl בעת קריאה לשיטות API כמו videoCategories.list ו-guideCategories.list.

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

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

‫7 באפריל 2014

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

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

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

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

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

  באופן דומה, הגדרת האובייקט suggestions של המשאב video עודכנה כדי להסביר שהאובייקט הזה יוחזר רק אם למאפיין processingDetails.tagSuggestionsAvailability של הסרטון או למאפיין processingDetails.editorSuggestionsAvailability שלו יש ערך של available.

• העדפנו את התיעוד של השיטות videos.insert ו-videos.update כדי לשקף את העובדה שאפשר להגדיר את המאפיין status.publishAt כשמפעילים את השיטות האלה.

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

• רשימת הפרמטרים עבור שיטת videos.rate עודכנה כדי לשקף ששיטה זו אינה תומכת בפועל בפרמטר onBehalfOfContentOwner. זו הייתה שגיאה בתיעוד, כי בקשות videos.rate שבהן מוגדר הפרמטר הזה מחזירות שגיאת 500.

‫31 במרץ 2014

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

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

‫13 במרץ 2014

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

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

• התיעוד מפרט כעת את אורך התווים המרבי הנתמך עבור המאפיינים הבאים:

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

• המאפיין brandingSettings.watch.featuredPlaylistId של המשאב channel יצא משימוש. ה-API יחזיר שגיאה אם ​​תנסה להגדיר את הערך שלו.

• הבאvideo מאפייני משאבים נוספו לרשימת הערכים שניתן להגדיר כאשרהכנסת אוֹעִדכּוּן סרטון:

  • 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

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

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

5 בדצמבר, 2013

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

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

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

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

• הגודל המינימלי של תמונות באנר של ערוץ שהועלו הוקטן ל-2,048 פיקסלים על 1,152 פיקסלים. (בעבר, הגודל המינימלי היה ‎2120px by 1192px). בנוסף, חשוב לזכור שבchannelתיעוד המשאבים מצוינים הגדלים המקסימליים של כל תמונות הבאנרים שמוצגות מה-API. לדוגמה, הגודל המקסימלי של תמונת brandingSettings.image.bannerTvImageUrl לאפליקציות לטלוויזיה הוא ‎2120px x 1192px, אבל הגודל בפועל של התמונה יכול להיות ‎2048px x 1152px. במרכז העזרה של YouTube יש הנחיות נוספות לאופטימיזציה של עיצוב הערוץ לתצוגה בסוגים שונים של מכשירים.

• הגדרות של כמה מאפייני משאבים channel עודכנו כדי לשקף את המידע הבא:

  • האורך המקסימלי של הערך של המאפיין brandingSettings.channel.description הוא 1,000 תווים.
  • האורך המקסימלי של מאפיין brandingSettings.channel.featuredChannelsTitle הוא 30 תווים.
  • עכשיו אפשר להוסיף עד 100 ערוצים למאפיין brandingSettings.channel.featuredChannelsUrls[].
  • אם מגדירים את ערך המאפיין brandingSettings.channel.unsubscribedTrailer, צריך לציין את מזהה הסרטון ב-YouTube של סרטון ציבורי או לא רשום שנמצא בבעלות של בעל הערוץ.

• השיטה 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 (ג'אווה)
  • ‫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, שכבר נתמך בכמה שיטות אחרות.

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

• המאפיין contentDetails.contentRating.tvpgRating של המשאב video תומך כעת בערך של pg14, התואם לדירוג TV-14.

• הגדרת המאפיין snippet.liveBroadcastContent, שמופיע בתוצאות החיפוש, תוקנה כך שתשקף את העובדה ש-live הוא ערך מאפיין תקין, אבל active הוא לא ערך מאפיין תקין.

• המאפיין contentDetails.contentRating.mibacRating במשאב video תומך עכשיו בשני דירוגים נוספים:

  • ‫mibacVap (VAP) – ילדים צריכים להיות מלווים במבוגר.
  • ‫mibacVm6 (V.M.6) – מוגבל לצפייה מגיל 6 ומעלה.
  • ‫mibacVm12 (V.M.12) – מוגבל לצפייה מגיל 12 ומעלה.

• המאפיין החדש invideoPromotion.items[].promotedByContentOwner של המשאב channel מציין האם שם בעל התוכן יוצג בעת הצגת הקידום. אפשר להגדיר את השדה הזה רק אם בקשת ה-API שמגדירה את הערך נשלחת בשם בעל התוכן. עיין בפרמטר onBehalfOfContentOwner לקבלת מידע נוסף.

‫1 באוקטובר 2013

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

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

• המאפיין invideoPromotion.items[].id.type של המשאב channel תומך כעת בערך של recentUpload, המציין שהפריט המקודם הוא הסרטון שהועלה לאחרונה מערוץ מסוים.

  כברירת מחדל, הערוץ זהה לערוץ שעבורו מוגדרים נתוני הקידום בסרטון. עם זאת, אפשר לקדם את הסרטון שהועלה לאחרונה מערוץ אחר על ידי הגדרת הערך של המאפיין החדש invideoPromotion.items[].id.recentlyUploadedBy למזהה הערוץ של הערוץ הזה.

• במשאב channel יש שלוש מאפיינים חדשים – brandingSettings.image.bannerTvLowImageUrl,‏ brandingSettings.image.bannerTvMediumImageUrl ו-brandingSettings.image.bannerTvHighImageUrl – שמציינים את כתובות ה-URL של תמונות הבאנר שמוצגות בדפי הערוצים באפליקציות לטלוויזיה.

• המאפיין החדש snippet.liveBroadcastContent בתוצאות החיפוש מציין אם במשאב של סרטון או ערוץ יש תוכן של שידור חי. ערכי המאפיין התקינים הם upcoming,‏ active ו-none.

  • במשאב video, הערך upcoming מציין שהסרטון הוא שידור חי שעוד לא התחיל, והערך active מציין שהסרטון הוא שידור חי שמתקיים כרגע.
  • במשאב channel, הערך upcoming מציין שיש לערוץ שידור מתוזמן שעדיין לא התחיל, והערך acive מציין שיש לערוץ שידור חי שמתנהל כרגע.

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

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

• השיטה search.list תומכת כעת בפרמטר eventType, אשר מגביל את החיפוש להחזרת אירועי שידור פעילים, קרובים או שהושלמו בלבד.

• המאפיין החדש contentDetails.contentRating.mibacRating מציין את הסיווג שהסרטון קיבל מ-Ministero dei Beni e delle Attivita Culturali e del Turismo (המשרד למורשת תרבותית ולתיירות) באיטליה.

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

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

‫27 באוגוסט 2013

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

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

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

  במסמכי התיעוד של ה-API מפורטות הודעות השגיאה שה-API תומך בהן, במיוחד עבור השיטות watermarks.set ו-watermarks.unset.

• המאפיין החדש statistics.hiddenSubscriberCount במשאב channel מכיל ערך בוליאני שמציין אם מספר המנויים של הערוץ מוסתר. לכן, הערך של המאפיין הוא false אם מספר המנויים של הערוץ גלוי לכולם.

• ה-method‏ playlists.list תומך עכשיו בפרמטרים onBehalfOfContentOwner ו-onBehalfOfContentOwnerChannel. שני הפרמטרים האלה כבר נתמכים בכמה שיטות אחרות.

• השיטה videos.list תומכת כעת בפרמטר regionCode, המזהה את אזור התוכן שעבורו יש לאחזר תרשים. אפשר להשתמש בפרמטר הזה רק בשילוב עם הפרמטר chart. ערך הפרמטר הוא קוד מדינה לפי ISO 3166-1 alpha-2.

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

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

‫15 באוגוסט 2013

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

• לאובייקט invideoPromotion של המשאב channel יש את המאפיינים החדשים והמעודכנים הבאים:

  • ה-API תומך עכשיו באפשרות לציין אתר כפריט מקודם. כדי לעשות זאת, מגדירים את ערך המאפיין invideoPromotion.items[].id.type ל-website ומשתמשים במאפיין החדש invideoPromotion.items[].id.websiteUrl כדי לציין את כתובת ה-URL. אפשר גם להשתמש במאפיין החדש invideoPromotion.items[].customMessage כדי להגדיר הודעה מותאמת אישית שתוצג לגבי המבצע.

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

    כשאתם מוסיפים קישורים לקידום מכירות, אתם מסכימים שלא תשתמשו בקישורים האלה כדי להפנות תנועה לאתרים לא מורשים, ושהקישורים האלה יעמדו בדרישות של מדיניות AdWords, המדיניות של YouTube בנושא מודעות, הנחיות הקהילה של YouTube והתנאים וההגבלות של YouTube.

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

    • האובייקט invideoPromotion.timing הועבר אל invideoPromotion.items[].timing. האובייקט הזה מאפשר לכם להתאים אישית את נתוני התזמון של כל פריט מקודם ברשימה invideoPromotion.items[].

    • אובייקט invideoPromotion.defaultTiming החדש מציין הגדרות תזמון שמוגדרות כברירת מחדל למבצע. ההגדרות האלה קובעות מתי פריט מקודם יוצג במהלך ההפעלה של אחד מהסרטונים בערוץ. אפשר לשנות את תזמון ברירת המחדל של כל פריט מקודם באמצעות אובייקט invideoPromotion.items[].timing.

    • המאפיין החדש invideoPromotion.items[].timing.durationMs מציין את משך הזמן, באלפיות השנייה, שבו המבצע יוצג. אובייקט invideoPromotion.defaultTiming מכיל גם שדה durationMs שמציין את משך הזמן שבו הפריט המקודם יוצג כברירת מחדל.

  • המאפיינים invideoPromotion.items[].type ו-invideoPromotion.items[].videoId הועברו שניהם לאובייקט invideoPromotion.items[].id.

• ה-method‏ subscriptions.list תומך עכשיו בפרמטרים onBehalfOfContentOwner ו-onBehalfOfContentOwnerChannel. שני הפרמטרים האלה כבר נתמכים בכמה שיטות אחרות.

• בתגובת ה-API לבקשת thumbnails.set, הערך של המאפיין kind השתנה מ-youtube#thumbnailListResponse ל-youtube#thumbnailSetResponse.

• דוגמאות קוד נוספו עבור השיטות הבאות:

  • ‫channels.update (Java, ‏ Python)
  • ‫playlists.insert (‎.NET, ‏ PHP)
  • ‫subscriptions.insert (PHP, ‏ Python)
  • ‫thumbnails.set (PHP, ‏ Python)
  • ‫videos.insert (PHP)
  • ‫videos.list (PHP)
  • ‫videos.rate (Python)
  • ‫videos.update (Java, ‏ PHP, ‏ Python)

  שימו לב שגם הדוגמה של Python לשיטה playlistItems.insert הוסרה, כי הפונקציונליות שהיא הדגימה מטופלת עכשיו על ידי השיטה videos.rate.

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

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

‫8 באוגוסט 2013

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

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

‫30 ביולי 2013

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

• במשאב channelBanner, הערך של המאפיין kind השתנה מ-youtube#channelBannerInsertResponse ל-youtube#channelBannerResource. המשאב הזה מוחזר בתגובה לבקשת channelBanners.insert.

• המאפיין החדש brandingSettings.channel.profileColor של משאב channel מציין צבע בולט המשלים את תוכן הערוץ. ערך המאפיין הוא סימן פאונד (#) ואחריו מחרוזת הקסדצימלית באורך שישה תווים, כמו #2793e6.

• ה-API תומך עכשיו באפשרות לציין אם המינוי הוא לכל הפעילויות בערוץ או רק להעלאות חדשות. המאפיין החדש contentDetails.activityType של המשאב subscription מזהה את סוגי הפעילויות שהמנוי יקבל עליהן התראות. ערכי המאפיין התקינים הם all ו-uploads.

• videos.list השיטה תומכת בפרמטרים חדשים לאחזור של מצעד הסרטונים הפופולריים ביותר ב-YouTube:

  • הפרמטר chart מזהה את התרשים שרוצים לאחזר. בשלב הזה, הערך הנתמך היחיד הוא mostPopular. הערה: הפרמטר chart הוא פרמטר של מסנן, ולכן אי אפשר להשתמש בו באותה בקשה עם פרמטרים אחרים של מסננים (id ו-myRating).
  • הפרמטר videoCategoryId מזהה את קטגוריית הסרטונים שעבורה צריך לאחזר את התרשים. אפשר להשתמש בפרמטר הזה רק בשילוב עם הפרמטר chart. כברירת מחדל, התרשימים לא מוגבלים לקטגוריה מסוימת.

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

• המאפיין recordingDetails.location.elevation של המשאב video נקרא עכשיו recordingDetails.location.altitude, והמאפיין fileDetails.recordingLocation.location.elevation שלו נקרא עכשיו fileDetails.recordingLocation.location.altitude.

• אובייקט contentDetails.contentRating של משאב video מציין את הסיווגים שסרטון קיבל במסגרת תוכניות סיווג שונות, כולל סיווגים של MPAA, סיווגים של TVPG וכן הלאה. מערכת ה-API תומכת עכשיו בערך דירוג לכל מערכת דירוג, שמציין שהסרטון לא דורג. שימו לב שבסיווגי תוכן של MPAA, הסיווג 'ללא סיווג' משמש לעיתים קרובות לזיהוי גרסאות לא ערוכות של סרטים, שגרסה ערוכה שלהם קיבלה סיווג רשמי.

• המאפיין החדש contentDetails.contentRating.ytRating של משאב video מזהה תוכן שחלה עליו הגבלת גיל. ערך המאפיין יהיה ytAgeRestricted אם מערכת YouTube זיהתה שהסרטון מכיל תוכן שלא מתאים למשתמשים מתחת לגיל 18. אם המאפיין לא קיים או אם ערך המאפיין ריק, סימן שהתוכן לא זוהה כתוכן עם הגבלת גיל.

• הפרמטר mySubscribers של השיטה channels.list הוצא משימוש. משתמשים בשיטה subscriptions.list ובפרמטר mySubscribers שלה כדי לאחזר רשימה של מנויים לערוץ של המשתמש המאומת.

• השיטות channelBanners.insert,‏ channels.update,‏ videos.getRating ו-videos.rate תומכות עכשיו בפרמטר onBehalfOfContentOwner. הפרמטר הזה מציין שהמשתמש המאומת פועל בשם בעל התוכן שצוין בערך הפרמטר.

• העדפנו את התיעוד של method ‏channels.update כדי לשקף את העובדה שאפשר להשתמש ב-method הזה כדי לעדכן את אובייקט brandingSettings של המשאב channel ואת מאפייני הצאצא שלו. בנוסף, במסמכי התיעוד מופיעה עכשיו רשימה מעודכנת של מאפיינים שאפשר להגדיר לאובייקט channel של משאב invideoPromotion.

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

  סוג השגיאה	פרטי השגיאה	תיאור
  forbidden	accountDelegationForbidden	השגיאה הזו לא ספציפית לשיטת API מסוימת. השגיאה הזו מציינת שלמשתמש המאומת אין הרשאה לפעול בשם חשבון Google שצוין.
  forbidden	authenticatedUserAccountClosed	השגיאה הזו לא ספציפית לשיטת API מסוימת. הוא מציין שהחשבון של המשתמש המאומת ב-YouTube סגור. אם המשתמש פועל בשם חשבון Google אחר, השגיאה הזו מציינת שהחשבון האחר סגור.
  forbidden	authenticatedUserAccountSuspended	השגיאה הזו לא ספציפית לשיטת API מסוימת. הערך הזה מציין שהחשבון של המשתמש המאומת ב-YouTube מושעה. אם המשתמש פועל בשם חשבון Google אחר, השגיאה הזו מציינת שהחשבון האחר מושעה.
  forbidden	authenticatedUserNotChannel	השגיאה הזו לא ספציפית לשיטת API מסוימת. השגיאה הזו מציינת ששרת ה-API לא יכול לזהות את הערוץ שמשויך לבקשת ה-API. אם הבקשה מאושרת ומשתמשים בפרמטר onBehalfOfContentOwner, צריך להגדיר גם את הפרמטר onBehalfOfContentOwnerChannel.
  forbidden	cmsUserAccountNotFound	השגיאה הזו לא ספציפית לשיטת API מסוימת. למשתמש במערכת ניהול התוכן אין הרשאה לפעול בשם בעל התוכן שצוין.
  notFound	contentOwnerAccountNotFound	השגיאה הזו לא ספציפית לשיטת API מסוימת. לא נמצא החשבון שמוגדר כבעלים שצוין.
  badRequest	invalidPart	השגיאה הזו לא ספציפית לשיטת 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, שפועל בשם בעל התוכן שצוין בערך הפרמטר. החשבון במערכת ניהול התוכן שהמשתמש מאמת צריך להיות מקושר לבעלי התוכן ב-YouTube שצוינו.

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

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

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

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

• במשאב channels, המאפיין invideoPromotion.channelId הוסר כי מזהה הערוץ כבר צוין באמצעות המאפיין id של המשאב.

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

‫22 במאי 2013

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

• השיטה החדשה channelBanners.insert מאפשרת להעלות תמונת באנר שאפשר להגדיר אותה בהמשך כתמונת הבאנר של ערוץ באמצעות המאפיין החדש brandingSettings.image.bannerExternalUrl של רכיב channel.

• התיעוד עבור המתודה channels.update עודכן כדי לפרט את המאפיינים שניתן לשנות בעת קריאה לשיטה.

• במסמכי העזרה בנושא המשאב video, הערך unspecified לא מופיע יותר כערך מאפיין תקין למאפיינים suggestions.processingErrors[], ‏ suggestions.processingHints[], ‏ suggestions.processingWarnings[] ו-suggestions.editorSuggestions[].

• לפרמטר maxResults של ה-method‏ videos.list יש עכשיו ערך ברירת מחדל של 5.

• בerror documentation מוצגות עכשיו שגיאות עבור השיטות channelBanners.insert ו-subscriptions.list. הוא גם מפרט כמה שגיאות חדשות בשיטה channels.update.

‫14 במאי 2013

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

• בדפים עצמאיים מופיעות עכשיו דוגמאות קוד ל-Java, ל-‎.NET, ל-PHP ול-Ruby.

• הדף שמציג דוגמאות קוד של Python כולל כעת דוגמאות להוספת מנוי, יצירת פלייליסט ועדכון סרטון.

‫10 במאי 2013

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

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

‫8 במאי 2013

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

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

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

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

‫2 במאי 2013

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

• משאבי הערוץ תומכים כעת במאפיין status.isLinked, המציין האם נתוני הערוץ מזהים משתמש שכבר מקושר לשם משתמש ב-YouTube או לחשבון Google+‎. למשתמש שיש לו אחד מהקישורים האלה כבר יש זהות ציבורית ב-YouTube, שנדרשת לביצוע כמה פעולות, כמו העלאת סרטונים.

• משאבי המנוי תומכים כעת בחלק subscriberSnippet. האובייקט הזה מכיל נתוני קטע קוד של הערוץ של המנוי.

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

• הפרמטר החדש myRating של השיטה videos.list מאפשר לכם לאחזר רשימה של סרטונים שהמשתמש המאומת דירג בדירוג like או dislike.

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

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

• בנוסף, עם ההשקה של הפרמטר myRating, עודכן גם ה-method ‏videos.list כדי לתמוך בהגדרת מעברי עמוד. עם זאת, חשוב לזכור שפרמטרים של חלוקה לדפים נתמכים רק בבקשות שמשתמשות בפרמטר myRating. (לא ניתן להשתמש בפרמטרים ובמידע של חלוקה לדפים בבקשות שמשתמשות בפרמטר id).

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

  • המשאב youtube#videoListResponse, שמוחזר בתגובה לבקשת videos.list, מכיל עכשיו את האובייקט pageInfo, שכולל פרטים כמו המספר הכולל של התוצאות ומספר התוצאות שנכללות בקבוצת התוצאות הנוכחית. המשאב youtube#videoListResponse יכול לכלול גם את המאפיינים nextPageToken ו-prevPageToken, שכל אחד מהם מספק טוקן שאפשר להשתמש בו כדי לאחזר דף ספציפי בקבוצת התוצאות.

• השיטה videos.insert תומכת בפרמטרים החדשים הבאים:

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

• המאפיין channelTitle נוסף אל snippet למשאבים הבאים:

  • ‫playlistItem – המאפיין מציין את שם הערוץ שבו נוסף פריט הפלייליסט.
  • ‫playlist – המאפיין מציין את שם הערוץ שיצר את הפלייליסט.
  • ‫subscription – המאפיין מציין את שם הערוץ שאליו נרשמים.

• נוספו דוגמאות קוד לשיטות הבאות:

  • ‫activities.insert (Ruby)
  • ‫playlistItems.list (‎.NET)
  • ‫search.list (‎.NET)
  • ‫subscriptions.insert (Java, ‏ Ruby)
  • ‫videos.insert (‎.NET, ‏ Ruby)

• הפרמטר החדש mySubscribers של השיטה subscriptions.list מאפשר לכם לאחזר רשימה של המנויים של המשתמש המאומת הנוכחי. אפשר להשתמש בפרמטר הזה רק בבקשה מורשית.

  הערה: התכונה הזו נועדה להחליף את הפרמטר mySubscribers שנתמך כרגע בשיטה channels.list. הפרמטר הזה יוצא משימוש.

• במשאב video, ערך המאפיין unspecified לא יכול להיות יותר ערך אפשרי לאף אחד מהמאפיינים הבאים:

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

    מדינה	מערכת סיווג	נכס
    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, הנתמך על ידי השיטה 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 – ג'אווה, ג'אווהסקריפט, PHP, פייתון, רובי
  • ‫playlists.insert – Java, ‏ JavaScript, ‏ Python
  • ‫search.list – Java, ‏ JavaScript, ‏ Python, ‏ Ruby
  • ‫videos.insert – Java

• עכשיו אפשר לדווח על פעולה מסוג channelItem במשאב activity. הפעולה הזו מתרחשת כשמערכת YouTube מוסיפה סרטון לערוץ YouTube שנוצר באופן אוטומטי. (אלגוריתם של YouTube מזהה נושאים שיש להם נוכחות משמעותית באתר YouTube ויוצר באופן אוטומטי ערוצים לנושאים האלה).

• הפרמטרים הבאים של search.list עודכנו:

  • הפרמטר q כבר לא מוגדר כמסנן, מה שאומר ש...
  • הפרמטר relatedToVideo נקרא עכשיו relatedToVideoId.
  • הפרמטר published הוחלף בשני פרמטרים חדשים, publishedAfter ו-publishedBefore, שמתוארים בהמשך.

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

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

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

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

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

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

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

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

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

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