היסטוריית גרסאות

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

13 במרץ 2024

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

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

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

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

12 במרץ 2024

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

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

7 במרץ 2024

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

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

31 בינואר 2024

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

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

9 בנובמבר 2023

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

12 בספטמבר 2023

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

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

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

22 באוגוסט 2023

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

18 באוגוסט 2023

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

7 באוגוסט 2023

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

‫28 ביוני 2023

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

12 ביוני 2023

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

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

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

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

22 באוגוסט 2022

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

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

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

27 באפריל 2022

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

8 באפריל 2022

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

15 בדצמבר 2021

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

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

18 בנובמבר 2021

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

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

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

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

2 ביולי 2021

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

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

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

1 ביולי 2021

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

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

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

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

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

12 במאי 2021

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

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

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

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

• מאפייני המשאבים הבאים של channel הוצאו משימוש. המאפיינים האלה כבר לא נתמכים בממשק המשתמש של YouTube Studio וב-YouTube. כתוצאה מכך, הן גם לא נתמכות יותר דרך ה-API.

  • brandingSettings.channel.defaultTab
  • brandingSettings.channel.featuredChannelsTitle
  • brandingSettings.channel.featuredChannelsUrls[]
  • brandingSettings.channel.profileColor
  • brandingSettings.channel.showBrowseView
  • brandingSettings.channel.showRelatedChannels

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

• מאפייני המשאבים הבאים של channelSection הוצאו משימוש. המאפיינים האלה כבר לא נתמכים בממשק המשתמש של YouTube Studio וב-YouTube. כתוצאה מכך, הן גם לא נתמכות יותר דרך ה-API.

  • snippet.style
  • snippet.defaultLanguage
  • snippet.localized.title
  • localizations
  • localizations.(key)
  • localizations.(key).title
  • targeting
  • targeting.languages[]
  • targeting.regions[]
  • targeting.countries[]

  לצד השינוי הזה, גם הפרמטר hl של השיטה channelSection.list הוצא משימוש כי התכונות שנתמכות בה לא נתמכות.

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

• עבור המאפיין snippet.type של המשאב channelSection, הערכים הבאים הוצאו משימוש. הערכים האלה כבר לא נתמכים בדפי ערוצים של YouTube, וכתוצאה מכך הם גם לא נתמכים יותר דרך ה-API.

  • likedPlaylists
  • likes
  • postedPlaylists
  • postedVideos
  • recentActivity
  • recentPosts

• המאפיין snippet.tags[] של המשאב playlist הוצא משימוש. הנכס הזה כבר לא נתמך ב-YouTube, וכתוצאה מכך הוא כבר לא נתמך דרך ה-API.

9 בפברואר 2021

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

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

28 בינואר 2021

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

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

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

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

15 באוקטובר 2020

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

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

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

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

8 באוקטובר 2020

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

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

9 בספטמבר 2020

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

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

• המשאבים, השיטות, הפרמטרים ומאפייני המשאבים הבאים של API הוצאו משימוש באופן מיידי ויפסיקו לפעול בתאריך ההודעה הזו או אחריו:
  • מאפייני המשאבים הבאים של channel:
    • הנכס statistics.commentCount
    • האובייקט brandingSettings.image וכל מאפייני הצאצא שלו
    • הרשימה brandingSettings.hints וכל מאפייני הצאצא שלה
  • פרמטר המסנן categoryId של השיטה channels.list
  • המשאב guideCategories וה-method guideCategories.list
• תגובות API ל-method channels.list לא כוללות יותר את המאפיין prevPageToken אם בקשת ה-API מגדירה את הפרמטר managedByMe כ-true. השינוי הזה לא משפיע על הנכס prevPageToken בבקשות אחרות של channels.list, ולא משפיע על המאפיין nextPageToken לגבי בקשות כלשהן.
• ב-11 באוגוסט 2016 הוכרז שמאפייני contentDetails.relatedPlaylists.watchLater ו-contentDetails.relatedPlaylists.watchHistory של המשאב channel הוצאו משימוש. גם התמיכה של השיטה 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, תשתפר עוד יותר.

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

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

28 ביולי 2020

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

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

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

21 ביולי 2020

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

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

7 ביולי 2020

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

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

15 ביוני 2020

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

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

4 ביוני 2020

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

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

17 באפריל 2020

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

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

31 במרץ 2020

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

• שיטות ומקורות מידע חדשים

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

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

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

10 בינואר 2020

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

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

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

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

10 בספטמבר 2019

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

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

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

16 בנובמבר 2017

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

• כלי קטעי הקוד האינטראקטיבי תומך עכשיו בדוגמאות קוד של Node.js. הדוגמאות מופיעות גם במסמכי התיעוד של כמעט כל שיטות ה-API, כמו השיטה 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. נכנסים אל כלי קטעי הקוד האינטראקטיבי או נכנסים למסמכי התיעוד של שיטת API כלשהי, כמו השיטה channels.list.
  2. לוחצים על הכרטיסייה Python מעל דוגמאות הקוד.
  3. אפשר ללחוץ על המתג שמעל הכרטיסיות כדי לעבור מהצגת קטע טקסט לדגימה מלאה.
     
  4. עכשיו הכרטיסייה אמורה להציג דוגמת קוד מלאה שמשתמשת בתהליך ההרשאה של InstalledAppFlow. התיאור שמעל הדוגמה מסביר זאת והוא גם מקשר לדוגמה של אפליקציית שרת אינטרנט.
  5. צריך ללחוץ על הקישור כדי לעבור לדוגמה של שרת האינטרנט. הדוגמה הזו משתמשת ב-framework של אפליקציית האינטרנט של Flask ובתהליך הרשאה שונה.

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

29 באוגוסט 2017

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

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

24 ביולי 2017

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

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

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

  • בצע בקשות על ידי לחיצה על לחצן. (כדי להוציא לפועל בקשות, צריך לתת לכלי הרשאה לקרוא ל-API בשמכם).

  לתשומת ליבכם: הכלי הזה החליף את APIs Explorer בדפים שבהם הוא זמין. (בכל דף מוצג קישור, כדי שתהיה לכם גם אפשרות לטעון את הבקשה שאתם עובדים עליה ב-APIs Explorer).

• גם הכלי קטעי קוד ב-Data API עודכן בממשק משתמש חדש שכולל את כל התכונות שתוארו למעלה. התכונות החדשות העיקריות הזמינות בדף זה הן:

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

27 בפברואר 2017

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

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

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

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

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

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

29 בנובמבר 2016

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

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

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

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

10 בנובמבר 2016

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    סוג השגיאה	פרטי השגיאה	תיאור
    forbidden (403)	homeParameterDeprecated	השיטה 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 יחזירו רשימה ריקה.

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

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

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

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

11 באוגוסט 2016

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

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

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

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

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

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

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

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

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

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

  • הפרמטר home של השיטה activities.list אפשר למשתמש מורשה לאחזר את פיד הפעילות שיוצג בדף הבית של YouTube עבור המשתמש הזה. בקשות שמשתמשות בפרמטר הזה אחרי 12 בספטמבר 2016 יחזירו רשימה ריקה.

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

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

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

13 ביוני 2016

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

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

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

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

31 במאי 2016

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

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

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

• ההגדרה של המאפיין snippet.thumbnails.(key) עודכנה עבור המשאבים הבאים: פעילות, playlistItem, פלייליסט, תוצאת חיפוש, תמונה ממוזערת וסרטון – חשוב לציין שאפשר לקבל גדלים נוספים של תמונות ממוזערות בסרטונים מסוימים.

  • התמונה של standard היא ברוחב 640 פיקסלים ובגובה של 480 פיקסלים.
  • רוחב התמונה של maxres הוא 1280 פיקסלים, וגובהה הוא 720 פיקסלים.

• ההגדרה של הפרמטר part בשיטה channelSection.list עודכנה, ועכשיו ניתן לאחזר את החלק targeting בעלות של 2 יחידות מכסה.

• השיטה videos.list מחזירה עכשיו שגיאה אסורה (403) כשבקשה שלא אושרה כראוי מנסה לאחזר את החלקים fileDetails, processingDetails או suggestions של משאב video. החלקים האלה זמינים רק לבעלים של הסרטון.

17 במאי 2016

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

16 במרץ 2016

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

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

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

  • המאפיין החדש 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	השיטה 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

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

19 בנובמבר 2015

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

4 בנובמבר 2015

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

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

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

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

  • ההגדרה של המאפיין 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 תיאור המשאב comment שנוסף או עודכן מכיל יותר מדי תווים במאפיין snippet.topLevelComment.snippet.textOriginal.
    playlistItems.insert playlistItems.update	קוד תגובת HTTP forbidden (403) סיבה playlistItemsNotAccessible תיאור הבקשה אינה מורשית כראוי להוסיף, לעדכן או למחוק את הפריט שצוין בפלייליסט.
    playlists.delete playlists.insert playlists.update	קוד תגובת HTTP badRequest (400) סיבה playlistForbidden תיאור פעולה זו אסורה או שהבקשה אינה מורשית כראוי.
    search.list	קוד תגובת HTTP badRequest (400) סיבה invalidLocation תיאור הפורמט של ערך הפרמטר location ו/או locationRadius שגוי.
    search.list	קוד תגובת HTTP badRequest (400) סיבה invalidRelevanceLanguage תיאור הפורמט של ערך הפרמטר relevanceLanguage שגוי.
    subscriptions.insert	קוד תגובת HTTP badRequest (400) סיבה subscriptionForbidden תיאור שגיאה זו מתרחשת כאשר מתקיים אחד מהתנאים הבאים: המינוי שניסית ליצור כבר קיים כבר הגעת למספר המינויים המקסימלי ניסית להירשם לערוץ שלך. הערוץ הזה לא נתמך. יצרת יותר מדי מינויים לאחרונה. עליך להמתין כמה שעות לפני ניסיון חוזר של שליחת הבקשה.
    videos.update	קוד תגובת HTTP badRequest (400) סיבה invalidDefaultBroadcastPrivacySetting תיאור הבקשה מנסה לקבוע הגדרת פרטיות לא חוקית לשידור ברירת המחדל.

28 באוגוסט 2015

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

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

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

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

7 באוגוסט 2015

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

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

  • ההגדרה של המאפיין snippet.tags[] של המשאב video עודכנה כדי לספק מידע נוסף על האופן שבו שרת ה-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 מכיל מידע על סיבה שבגללה סרטון יסומן כמכיל תוכן פוגעני. השיטה videoAbuseReportReasons.list מאפשרת לאחזר רשימה של כל הסיבות האפשריות לסימון סרטונים.

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

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

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

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

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

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

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

  • המאפיין החדש 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

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

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

  במדריך גם מפורטות כמה תכונות של הוספת תגובות שלא תמכו ב-V2 API אבל נתמכות ב-v3 API. האפשרויות הן:

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

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

9 באפריל 2015

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

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

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

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

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

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

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

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

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

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

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

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

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

2 באפריל 2015

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

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

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

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

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

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

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

11 במרץ 2015

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

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

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

  • סימון סרטון

• המדריך להעברת נתונים מ-YouTube Data API (v3) עודכן ועכשיו אין תמיכה בתכונות הבאות של v2 API ב-v3 API:

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

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

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

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

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

  • תמיכה בפיד RSS

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

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

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

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

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

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

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

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

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

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

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

4 במרץ 2015

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

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

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

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

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

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

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

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

2 במרץ 2015

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

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

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

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

14 בינואר 2015

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

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

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

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

11 בנובמבר 2014

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

• עלות המכסה של שיחה ל-method search.list השתנתה ל-100 יחידות.

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

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

    קוראים לשיטה search.list ומחפשים את GoogleDevelopers.

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

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

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

8 באוקטובר 2014

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

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

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

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

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

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

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

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

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

• השיטה channelBanners.insert תומכת עכשיו בשגיאה הבאה:

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

12 בספטמבר 2014

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

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

13 באוגוסט 2014

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

• השיטה subscriptions.insert תומכת עכשיו בשגיאה הבאה:

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

12 באוגוסט 2014

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

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

8 ביולי 2014

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

• השיטה playlists.insert תומכת עכשיו בשגיאה הבאה:

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

18 ביוני 2014

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

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

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

• המשאב video תומך עכשיו ב-43 מערכות חדשות לסיווג תוכן, שמזהות את הסיווגים שקיבלו סרטונים מסוכנויות סיווג לאומיות שונות. מערכות הסיווג החדשות שנוספו הן: {9Mהשגת, אוסטריה, בלגיה, בלגיה, הולנד בלגיה בלגיה {99 } אוסטריה, בלגיה, הולנד בלגיה בלגיה {/47 לשנות שוויץ1 מלזיהבלגיה, בלגיה, בלגיה, קניה, בלגיה, קניה, סין

28 במאי 2014

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

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

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

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

13 במאי 2014

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

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

• המשאב channelSection יכול עכשיו להכיל מידע על כמה סוגים חדשים של תוכן מומלץ. המאפיין snippet.type של המשאב channelSection תומך עכשיו בערכים הבאים:

  • postedPlaylists – פלייליסטים שבעל הערוץ פרסם בפיד הפעילות של הערוץ
  • postedVideos - סרטונים שפרסם בעל הערוץ בפיד הפעילות של הערוץ
  • subscriptions - ערוצים שהבעלים של הערוץ נרשם אליהם

• המאפיין החדש contentDetails.contentRating.ifcoRating של המשאב video מזהה את הדירוג שסרטון קיבל ממשרד הסיווג של סרטים באירלנד.

• ההגדרה של המאפיין position.cornerPosition של המשאב watermark עודכנה, ועכשיו סימן המים מופיע תמיד בפינה השמאלית העליונה של הנגן.

• ההגדרה של הפרמטר q בשיטה search.list עודכנה ועכשיו אפשר להשתמש באופרטור הבוליאני NOT (-) במונח השאילתה כדי להחריג סרטונים שמשויכים למונח חיפוש מסוים. הערך יכול גם להשתמש באופרטור OR בוליאני (|) כדי למצוא סרטונים המשויכים לאחד מתוך כמה מונחי חיפוש.

• ההגדרה של המאפיין pageInfo.totalResults שמוחזר בתגובת API לקריאה ל-search.list עודכנה, ועכשיו הערך הוא משוער וייתכן שלא מייצג ערך מדויק. בנוסף, הערך המקסימלי הוא 1,000,000. אין להשתמש בערך הזה ליצירת קישורי עימוד. במקום זאת, צריך להשתמש בערכי המאפיין nextPageToken ו-prevPageToken כדי לקבוע אם להציג קישורי עימוד.

• השיטות watermarks.set ו-watermarks.unset עודכנו כך שה-API מחזיר קוד תגובה 204 של HTTP עבור בקשות שבוצעו בהצלחה לשיטות האלו.

2 במאי 2014

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

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

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

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

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

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

  משאב	מאפיין (property)	אורך מקסימלי
  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	השיטה 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 פיקסלים על 1152 פיקסלים. (בעבר, הגודל המינימלי היה 2120 פיקסלים על 1192 פיקסלים). בנוסף, חשוב לשים לב שבתיעוד המשאבים של channel מצוינים הגדלים המקסימליים של כל תמונות הבאנר שיוצגו דרך ה-API. לדוגמה, הגודל המקסימלי של תמונה בגודל brandingSettings.image.bannerTvImageUrl באפליקציות טלוויזיה הוא 2120 פיקסלים על 1192 פיקסלים, אבל התמונה עצמה יכולה להיות בגודל של 2,048 על 1152 פיקסלים. במרכז העזרה של YouTube תוכלו למצוא הנחיות נוספות לאופטימיזציה של עיצוב הערוץ להצגה במכשירים שונים.

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

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

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

• השיטות playlistItems.list ו-playlistItems.insert תומכות עכשיו בפרמטר onBehalfOfContentOwner, שכבר נתמך בכמה שיטות נוספות.

• הנכס contentDetails.contentRating.acbRating יכול עכשיו לציין סיווג מהמועצה האוסטרלית לסיווג (ACB) לסרטים או מהרשות האוסטרלית לתקשורת ומדיה (ACMA) לתוכניות טלוויזיה לילדים.

• המאפיינים החדשים contentDetails.contentRating.catvRating ו-contentDetails.contentRating.catvfrRating מזהים את הסיווגים של סרטון שהתקבל במערכת הסיווג הקנדית לטלוויזיה ובמערכת הדירוג Régie du cinéma בצרפתית, המשמשים בקוויבק, בהתאמה.

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

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

  • activities.insert (התחלה)
  • channelBanners.insert (Python)
  • channels.update (Python)
  • playlistItems.list (התחלה)
  • search.list (התחלה)
  • thumbnails.set (Java)
  • videos.insert (התחלה)

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 כדי להימנע משליחת התראה על כל סרטון חדש למנויים של הערוץ.

• רשימת המאפיינים שניתן לשנות כשמבצעים קריאה ל-method channels.update עודכנה כך שתכלול את המאפיינים invideoPromotion.items[].customMessage ו-invideoPromotion.items[].websiteUrl. בנוסף, הרשימה שונתה כדי לזהות את מאפייני brandingSettings שניתנים לשינוי. כבר אפשר לשנות את מאפייני brandingSettings האלה, ולכן השינוי בתיעוד לא משקף שינוי בפונקציונליות הקיימת של ה-API.

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

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

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

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

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

  • mibacVap (VAP) – ילדים חייבים בליווי מבוגר.
  • mibacVm6 (V.M.6) – מוגבל לגילאי 6 ומעלה.
  • mibacVm12 (V.M.12) – מוגבל לגיל 12 ומעלה.

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

1 באוקטובר 2013

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

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

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

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

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

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

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

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

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

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

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

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

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

27 באוגוסט 2013

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

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

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

  תיעוד השגיאות מתאר את הודעות השגיאה שנתמכות ב-API באופן ספציפי עבור השיטות watermarks.set ו-watermarks.unset.

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

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

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

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

• השגיאות החדשות הבאות מתוארות ב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 מסוימת. משתמש ה-CMS אינו מורשה לפעול בשם בעלי התוכן שצוינו.
  notFound	contentOwnerAccountNotFound	השגיאה הזו לא ספציפית לשיטת API מסוימת. החשבון של בעלי התוכן שצוין לא נמצא.
  badRequest	invalidPart	השגיאה הזו לא ספציפית לשיטת API מסוימת. הפרמטר part של הבקשה מציין חלקים שאי אפשר לכתוב יחד.
  badRequest	videoChartNotFound	השיטה videos.list מחזירה את השגיאה הזו כאשר הבקשה מציינת תרשים וידאו לא נתמך או לא זמין.
  notFound	videoNotFound	השיטה videos.update מחזירה את השגיאה הזו כדי לציין שלא ניתן למצוא את הסרטון שאתם מנסים לעדכן. יש לבדוק את הערך של המאפיין id בגוף הבקשה כדי לוודא שהוא נכון.

10 ביוני 2013

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

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

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

• משאבי הפלייליסט מכילים עכשיו את הנכס snippet.tags. הנכס יוחזר רק למשתמשים מורשים שמאחזרים נתונים על הפלייליסטים שלהם. משתמשים מורשים יכולים גם להגדיר תגי פלייליסט כשמפעילים את השיטה playlists.insert או playlists.update.

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

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

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

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

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

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

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

• במדריך החדש עבודה עם מזהי ערוצים מוסבר איך ה-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 של השיטה videos.list הוא 5.

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

14 במאי 2013

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

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

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

10 במאי 2013

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

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

8 במאי 2013

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

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

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

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

2 במאי 2013

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

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

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

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

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

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

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

• עם השקת הפרמטר myRating, גם השיטה 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 (רובי)
  • 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.

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

  תיעוד השגיאות עודכן גם הוא ומפרט את השגיאות שה-API עשוי להחזיר בתגובה לקריאה ל-method thumbnails.set.

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

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

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

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

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

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

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

    מדינה	מערכת הסיווג	מאפיין (property)
    ארצות הברית	Motion Picture Association of America (MPAA)	contentDetails.contentRating.mpaaRating
    ארצות הברית	הנחיות להורים לגבי טלוויזיה	contentDetails.contentRating.tvpgRating
    אוסטרליה	אוסטרליה לסיווג (ACB)	contentDetails.contentRating.acbRating
    ברזיל	Ministryamento de Justiça, Classificação, Qualificação e Títulos	contentDetails.contentRating.djctqRating
    קנדה	המערכת הקנדית לדירוג סרטונים ביתיים (CHVRS)	contentDetails.contentRating.chvrsRating
    צרפת	Center National du cinéma et de l'image animée (משרד התרבות הצרפתי)	contentDetails.contentRating.fmocRating
    גרמניה	Freiwillige Selbstkontrolle der Movieswirtschaft (FSK)	contentDetails.contentRating.fskRating
    בריטניה	המועצה הבריטית לסיווג סרטים (BBFC)	contentDetails.contentRating.bbfcRating
    הודו	Central Board of Movie Certification (CBFC)	contentDetails.contentRating.cbfcRating
    יפן	映倫管理委員及 (EIRIN)	contentDetails.contentRating.eirinRating
    קוריאה	☁⃁⬼ אמורה הסתרת ודפים	contentDetails.contentRating.kmrbRating
    מקסיקו	הממשלה הכללית של רדיו, טלוויזיה וסינמטוגרפיה (RTC)	contentDetails.contentRating.rtcRating
    ניו זילנד	סיווג הסרטים והספרות	contentDetails.contentRating.oflcRating
    רוסיה	מרשם הסרטים הלאומי של הפדרציה הרוסית	contentDetails.contentRating.russiaRating
    ספרד	Instituto de la Syntografía y de las Artes Audiovisuales (ICAA)	contentDetails.contentRating.icaaRating

• המסמכים של השיטה playlistItems.update עודכנו כדי לשקף את העובדה שיש לציין את המאפיין snippet.resourceId במשאב שנשלח כגוף הבקשה.

• השיטה search.list תומכת עכשיו בפונקציות הבאות:

  • הפרמטר forMine החדש מגביל את החיפוש לאחזור רק את הסרטונים של המשתמש המאומת.

  • הפרמטר order תומך עכשיו באפשרות למיין תוצאות בסדר אלפביתי לפי שם (order=title) או לפי מספר סרטונים בסדר יורד (order=videoCount).

  • הפרמטר safeSearch החדש מציין אם תוצאות החיפוש צריכות לכלול תוכן מוגבל.

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

  סוג השגיאה	פרטי השגיאה	תיאור
  badRequest	invalidCategoryId	המאפיין snippet.categoryId מציין מזהה קטגוריה לא חוקי. אפשר להשתמש בשיטה videoCategories.list כדי לאחזר קטגוריות נתמכות.
  badRequest	invalidRecordingDetails	metadata specifies invalid recording details.
  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 שפועל בשם בעלי התוכן שצוינו בערך הפרמטר. חשבון ה-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

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

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

  • activities.insert – Java
  • playlistItems.insert – Python
  • playlistItems.list – Java, JavaScript, PHP, Python, Ruby
  • playlists.insert – Java, JavaScript, Python
  • search.list – Java, JavaScript, Python, Ruby
  • videos.insert – Java

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

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

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

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

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

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

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

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

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

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

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

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

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