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

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

30 באוקטובר 2024

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

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

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

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

30 באפריל 2024

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

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

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

13 במרץ 2024

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

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

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

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

‫12 במרץ 2024

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

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

7 במרץ 2024

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

המאפיין brandingSettings.channel.moderateComments של המשאב channel יצא משימוש. 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 הוצא משימוש. התמיכה ב-YouTube בפרמטר הזה תסתיים ב-7 באוגוסט 2023.

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

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

22 באוגוסט 2022

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

5 באוגוסט 2022

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

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

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

12 ביולי 2022

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

method, ואם הקוד דורש משאב 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.

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

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

8 באוקטובר 2020

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

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

9 בספטמבר 2020

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

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

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

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

4 ביוני 2020

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

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

17 באפריל 2020

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

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

31 במרץ 2020

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

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

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

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

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

10 בינואר 2020

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

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

• המאפיין selfDeclaredMadeForKids מאפשר ליוצרי תוכן לציין אם ערוץ או סרטון מיועדים לילדים.
  
  בערוצים, אפשר להגדיר את המאפיין הזה בזמן הקריאה לשיטה channels.update. בסרטונים, אפשר להגדיר את המאפיין הזה בקריאה ל-method‏ videos.insert או ל-method‏ 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:

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

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

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

  נכון לעכשיו יש תמיכה בדוגמאות קוד ל-Java,‏ JavaScript,‏ PHP,‏ Python ו-curl.

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

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

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

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

9 ביולי 2018

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

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

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

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

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

22 ביוני 2018

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

27 בנובמבר 2017

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

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

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

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

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

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

16 בנובמבר 2017

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

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

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

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

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

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

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

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

2 בנובמבר 2016

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

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

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

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

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

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

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

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

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

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

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

    • אם הפרמטר 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 עודכנו כדי לציין שערכי הפרמטרים כוללים את הערך 0. לדוגמה, אם הפרמטר 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	שגיאה זו מחזירה את method ‏playlistItems.list כדי לציין שהבקשה ניסתה לאחזר פריטים מהפלייליסט 'לצפייה מאוחר יותר', אבל לא ניתן לאחזר אותם באמצעות ה-API.
    badRequest (400)	uploadLimitExceeded	השיטה videos.insert מחזירה את השגיאה הזו כדי לציין שהערוץ חרג ממספר הסרטונים שהוא יכול להעלות.
    forbidden (403)	forbiddenEmbedSetting	השיטה videos.update מחזירה את השגיאה הזו כדי לציין שבקשת ה-API מנסה להגדיר הגדרת הטמעה לא חוקית לסרטון. לתשומת ליבכם: יכול להיות שלחלק מהערוצים אין הרשאה להציע נגנים מוטמעים לשידורים חיים. מידע נוסף זמין במרכז העזרה של YouTube.

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

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

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

15 בספטמבר 2016

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

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

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

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

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

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

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

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

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

11 באוגוסט 2016

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

• התנאים וההגבלות החדשים של שירותי 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) עודכנה במשאבים activity,‏ playlistItem,‏ playlist,‏ search result,‏ thumbnail ו-video כדי לציין שזמינים גדלים נוספים של תמונות ממוזערות לסרטונים מסוימים.

  • התמונה standard צריכה להיות ברוחב 640 פיקסלים ובגובה 480 פיקסלים.
  • התמונה maxres צריכה להיות ברוחב 1,280 פיקסלים ובגובה 720 פיקסלים.

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

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

17 במאי 2016

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

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

16 במרץ 2016

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  סוג השגיאה	פרטי השגיאה	תיאור
  badRequest (400)	notEditable	השגיאה הזו מופיעה בחזרה מהשיטות channelSections.insert,‏ channelSections.update ו-channelSections.delete כדי לציין שלא ניתן ליצור, לעדכן או למחוק את הקטע שצוין בערוץ.
  badRequest (400)	styleRequired	השיטות channelSections.insert ו-channelSections.update מחזירות את השגיאה הזו כדי לציין שצריך לציין ערך למאפיין snippet.style במשאב channelSection שנשלח בבקשת ה-API.
  badRequest (400)	typeRequired	השיטות channelSections.insert ו-channelSections.update מחזירות את השגיאה הזו כדי לציין שצריך לציין ערך למאפיין snippet.type במשאב channelSection שנשלח בבקשת ה-API.
  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

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

19 בנובמבר 2015

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

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

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

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

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

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

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

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

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

• אחזור ערכים מותאמים

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

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

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

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

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

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

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

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

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

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

4 בנובמבר 2015

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

28 באוגוסט 2015

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

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

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

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

7 באוגוסט 2015

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

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

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

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

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

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

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

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

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

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

  • הנכס החדש 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 כך שישקף את העובדה שבמקרה של הצלחה, כל השיטות האלה מחזירות את קוד התגובה 204 של HTTP (No Content).

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

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

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

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

16 באפריל 2015

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

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

  המדריך כולל גם כמה תכונות של תגובות שלא נתמכו ב-API v2 אבל נתמכות ב-API v3. למשל:

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

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

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 – מחיקת תגובה.

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

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

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

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

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

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

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

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

‫2 באפריל 2015

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

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

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

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

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

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

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

11 במרץ 2015

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

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

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

  • דיווח על סרטון

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

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

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

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

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

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

  • תמיכה בפיד RSS

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

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

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

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

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

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

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

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

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

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

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

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

‫14 בינואר 2015

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

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

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

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

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

8 באוקטובר 2014

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

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

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

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

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

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

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

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

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

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

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

12 בספטמבר 2014

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

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

13 באוגוסט 2014

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

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

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

12 באוגוסט 2014

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

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

8 ביולי 2014

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

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

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

18 ביוני 2014

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

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

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

• המשאב video תומך עכשיו ב-43 מערכות חדשות לסיווג תוכן, שמזהות את הדירוגים שהסרטונים קיבלו מסוכנויות סיווג שונות ברחבי העולם. מערכות הדירוג החדשות שנתמכות הן מארגנטינה, אוסטריה, בלגיה, בולגריה, צ'ילה (טלוויזיה), צ'ילה (סרט), הרפובליקה הצ'כית, קולומביה, דנמרק, מצרים, אסטוניה, פינלנד, צרפת, יוון, הונג קונג, איסלנד, אינדונזיה, אירלנד, ישראל, איטליה, קניה, לטביה, לוקסמבורג, מלזיה, איי מלדיבים, מלטה, הולנד, ניגריה, נורווגיה, פרו, פיליפינים, פורטוגל, רומניה, סינגפור, סלובקיה, דרום אפריקה, שוודיה, שווייץ, טייוואן, תאילנד וונצואלה.

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

2 במאי 2014

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

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

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

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

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

7 באפריל 2014

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

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

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

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

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

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

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

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

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

31 במרץ 2014

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

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

‫13 במרץ 2014

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

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

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

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

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

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

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

• מסמכי התיעוד של השגיאות כוללים עכשיו את קוד התגובה של HTTP לכל סוג שגיאה.

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

  סוג השגיאה	פרטי השגיאה	תיאור
  badRequest (400)	invalidCriteria	השיטה channels.list מחזירה את השגיאה הזו אם בבקשה צוינו פרמטרים של מסננים שאי אפשר להשתמש בהם יחד.
  badRequest (400)	channelTitleUpdateForbidden	השיטה 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	שגיאה זו מוחזרת על ידי ה-method ‏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 כפופה עכשיו למדיניות ההוצאה משימוש שמתוארת בתנאים ובהגבלות של ממשקי ה-API של YouTube. חשוב לציין שבדף שבו מפורטים ממשקי ה-API שחלים עליהם כללי המדיניות בנושא הוצאה משימוש, המדיניות לא חלה על חלק מהפונקציונליות של ממשקי API בגרסה 3.

5 בדצמבר 2013

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

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

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

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

• הגודל המינימלי של תמונות הבאנר של הערוץ שהעליתם הופחת ל-2,048 על 1,152 פיקסלים. (בעבר, הגודל המינימלי היה 2,120 על 1,192 פיקסלים). בנוסף, חשוב לזכור שבמסמכי העזרה של המשאב channel מצוינים הגדלים המקסימליים של כל תמונות הבאנר שמוצגות מה-API. לדוגמה, הגודל המקסימלי של התמונה brandingSettings.image.bannerTvImageUrl לאפליקציות לטלוויזיה הוא 2,120px על 1,192px, אבל התמונה בפועל עשויה להיות בגודל 2,048px על 1,152px. במרכז העזרה של 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 סיווג של Australian Classification Board‏ (ACB) לסרטים, או של Australian Communications and Media Authority‏ (ACMA) לתוכניות טלוויזיה לילדים.

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

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

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

  • activities.insert (Go)
  • channelBanners.insert (Python)
  • channels.update (Python)
  • playlistItems.list (Go)
  • search.list (Go)
  • thumbnails.set (Java)
  • videos.insert (Go)

24 באוקטובר 2013

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

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

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

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

    • upcoming – הסרטון הוא שידור חי שעדיין לא התחיל.
    • active – הסרטון הוא שידור חי מתמשך.
    • none – הסרטון הוא לא שידור חי פעיל או שידור בכורה שישודר בקרוב. זה יהיה ערך הנכס של שידורים שהסתיימו ועדיין אפשר לצפות בהם ב-YouTube.

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

    • liveStreamingDetails.actualStartTime – השעה שבה השידור התחיל בפועל. (הערך הזה יופיע ברגע שהמצב של השידור יהיה active).
    • liveStreamingDetails.actualEndTime – השעה שבה השידור הסתיים בפועל. (הערך הזה יופיע בסיום השידור).
    • liveStreamingDetails.scheduledStartTime – השעה שבה השידור מתוזמן להתחיל.
    • liveStreamingDetails.scheduledEndTime – השעה שבה השידור מתוזמן להסתיים. אם ערך המאפיין ריק או שהמאפיין לא קיים, השידור מתוזמן להימשך ללא הגבלת זמן.
    • liveStreamingDetails.concurrentViewers – מספר האנשים שצופים בשידור החי.

    כדי לאחזר את המטא-נתונים האלה, צריך לכלול את הערך liveStreamingDetails בערך הפרמטר part כשקוראים לשיטה videos.list,‏ videos.insert או videos.update.

  חשוב לדעת: ב-1 באוקטובר 2013 השקנו שתי תכונות נוספות לזיהוי תוכן של שידורים חיים – הפרמטר eventType של השיטה search.list והמאפיין snippet.liveBroadcastContent של תוצאת החיפוש.

• השיטה videos.insert תומכת עכשיו בפרמטר notifySubscribers, שמציין אם YouTube צריך לשלוח התראה על הסרטון החדש למשתמשים שנרשמו למינוי לערוץ שבו הוא מופיע. ערך ברירת המחדל של הפרמטר הוא True, והוא מציין שמנויים יקבלו התראה על סרטונים חדשים שהועלו. עם זאת, בעלי ערוץ שמעלים הרבה סרטונים עשויים להעדיף להגדיר את הערך כ-False כדי להימנע משליחת התראה על כל סרטון חדש למנויים של הערוץ.

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

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

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

• המסמכים של method ‏channels.update עודכנו כדי לשקף את העובדה שאפשר להשתמש ב-method הזה כדי לעדכן את האובייקט 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 מסוימת. למשתמש במערכת ניהול התוכן אין הרשאה לפעול בשם בעלי התוכן שצוין.
  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. שימו לב: כשמשתמשים בפרמטר הזה בקריאה לשיטה videos.insert, צריך לציין בבקשה גם ערך לפרמטר onBehalfOfContentOwnerChannel החדש, שמזהה את הערוץ שאליו יתווסף הסרטון. הערוץ חייב להיות מקושר לבעלי התוכן שצוין בפרמטר onBehalfOfContentOwner.

  הפרמטר מציין שפרטי הכניסה של הבקשה מזהים משתמש במערכת ניהול התוכן של YouTube שפועל בשם בעלי התוכן שצוין בערך הפרמטר. חשבון ה-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 (Ruby)
  • playlistItems.list (‎.NET)
  • search.list (‎.NET)
  • subscriptions.insert (Java, ‏ Ruby)
  • videos.insert‏ (‎.NET, ‏ Ruby)

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

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

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

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

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

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

19 באפריל 2013

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

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

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

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

    מדינה	מערכת סיווג	נכס
    ארצות הברית	Motion Picture Association of America‏ (MPAA)	contentDetails.contentRating.mpaaRating
    ארצות הברית	הנחיות להורים לגבי טלוויזיה	contentDetails.contentRating.tvpgRating
    אוסטרליה	Australian Classification Board‏ (ACB)	contentDetails.contentRating.acbRating
    ברזיל	Departamento de Justiça, Classificação, Qualificação e Títulos	contentDetails.contentRating.djctqRating
    קנדה	מערכת הסיווג של סרטים ביתיים בקנדה (CHVRS)	contentDetails.contentRating.chvrsRating
    צרפת	Centre national du cinéma et de l'image animée (משרד התרבות של צרפת)	contentDetails.contentRating.fmocRating
    גרמניה	Freiwillige Selbstkontrolle der Filmwirtschaft (FSK)	contentDetails.contentRating.fskRating
    בריטניה	British Board of Film Classification‏ (BBFC)	contentDetails.contentRating.bbfcRating
    הודו	Central Board of Film Certification‏ (CBFC)	contentDetails.contentRating.cbfcRating
    יפן	映倫管理委員会 (EIRIN)	contentDetails.contentRating.eirinRating
    קוריאה	영상물등급위원회 (KMRB)	contentDetails.contentRating.kmrbRating
    מקסיקו	General Directorate of Radio, Television and Cinematography (RTC)	contentDetails.contentRating.rtcRating
    ניו זילנד	Office of Film and Literature Classification	contentDetails.contentRating.oflcRating
    רוסיה	National Film Registry of the Russian Federation	contentDetails.contentRating.russiaRating
    ספרד	Instituto de la Cinematografí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 שבו המשתמש מבצע אימות חייב להיות מקושר לבעלי התוכן שצוין ב-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 – מציין אם הסרטון זמין ב-2D או ב-3D.
    • definition – מציין אם הסרטון זמין באיכות רגילה או באיכות HD.
    • caption – מציין אם יש כתוביות לסרטון.
    • licensedContent – מציין אם הסרטון מכיל תוכן שהוגשה לגביו תלונה על הפרת זכויות יוצרים על ידי שותף תוכן של YouTube.

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

    • embeddable – מציין אם ניתן להטמיע את הסרטון באתר אחר.
    • license – מציין את הרישיון של הסרטון. הערכים החוקיים הם creativeCommon ו-youtube.

• ההגדרה של הפרמטר part עודכנה בשיטות videos.list, ‏ videos.insert ו-videos.update כדי לכלול את החלקים החדשים שנוספו כפי שמתואר למעלה, וגם את החלק recordingDetails, שהושמט בטעות.

• המאפיין contentDetails.googlePlusUserId החדש של המשאב channel מציין את מזהה הפרופיל ב-Google+‎ שמשויך לערוץ. אפשר להשתמש בערך הזה כדי ליצור קישור לפרופיל Google+‎.

• עכשיו כל אובייקט של תמונה ממוזערת מציין את הרוחב והגובה של התמונה. תמונות ממוזערות מוחזרות כרגע במשאבים activity,‏ channel,‏ playlist,‏ playlistItem,‏ search result,‏ subscription ו-video.

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

  ה-API מחזיר שגיאה מסוג notFound אם לא ניתן למצוא בפלייליסט את הסרטון שאותו מזהה הפרמטר.

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

• המאפיין snippet.channelId של המשאב channel הוסר. המאפיין id של המשאב מספק את אותו ערך.

30 בינואר 2013

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

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

16 בינואר 2013

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

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

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

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

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