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

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

‫2 בנובמבר 2026

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

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

‫15 באוקטובר 2026

הבהרנו את השיטה videos.list כדי לציין שהמאפיינים status.selfDeclaredMadeForKids ו-status.madeForKids מתעדכנים רק אם הם צוינו בבקשה, ולא מוחלפים אם הם הושמטו.

‫30 בספטמבר 2026

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

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

‫14 בספטמבר 2026

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

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

‫11 בספטמבר 2026

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

‫1 בספטמבר 2026

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

‫27 באוגוסט 2026

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

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

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

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

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

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

‫6 באוגוסט 2026

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

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

7 ביולי 2026

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

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

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

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

  • ‫channelId: מזהה הערוץ החיצוני של המותג השותף.
  • ‫channelHandle: הכינוי של הערוץ של השותף עם המותג.
צריך להגדיר את channelId או את channelHandle כשיוצרים קישור, אבל רק channelId מוחזר בתגובה.

‫23 ביוני 2026

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

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

‫3 ביוני 2026

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

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

קריאה ל-method הזה מנכה יחידה אחת ממכסת הקריאות המפורטת. מכסת ברירת המחדל של השיטה היא 10,000 יחידות ביום.

‫1 ביוני 2026

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

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

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

‫4 בדצמבר 2025

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

‫10 ביולי 2025

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

‫26 במרץ 2025

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

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

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

‫30 באוקטובר 2024

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

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

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

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

30 באפריל 2024

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

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

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

‫13 במרץ 2024

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

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

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

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

‫12 במרץ 2024

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

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

‫7 במרץ 2024

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

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

‫31 בינואר 2024

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

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

‫9 בנובמבר 2023

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

‫12 בספטמבר 2023

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

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

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

‫22 באוגוסט 2023

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

‫18 באוגוסט 2023

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

‫7 באוגוסט 2023

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

‫28 ביוני 2023

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

‫12 ביוני 2023

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

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

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

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

‫22 באוגוסט 2022

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

5 באוגוסט 2022

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

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

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

12 ביולי 2022

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

‫27 באפריל 2022

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

‫8 באפריל 2022

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

‫15 בדצמבר 2021

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

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

‫18 בנובמבר 2021

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

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

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

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

‫2 ביולי 2021

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

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

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

1 ביולי 2021

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

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

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

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

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

‫12 במאי 2021

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

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

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

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

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

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

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

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

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

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

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

‫9 בפברואר 2021

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

‫28 בינואר 2021

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

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

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

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

‫15 באוקטובר 2020

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

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

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

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

‫8 באוקטובר 2020

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

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

9 בספטמבר 2020

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

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

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

‫29 ביולי 2020

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

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

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

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

‫28 ביולי 2020

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

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

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

21 ביולי 2020

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

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

7 ביולי 2020

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

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

‫15 ביוני 2020

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

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

‫4 ביוני 2020

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

התכונה "הודעות בערוץ" הוצאה משימוש באופן מלא. הודענו על השינוי הזה לראשונה ב-17 באפריל 2020, ועכשיו הוא נכנס לתוקף. כתוצאה מכך, אין יותר תמיכה ב-method‏ activities.insert, וה-method‏ 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 מאפשר ליוצרי תוכן לציין אם ערוץ או סרטון נוצרו במיוחד לילדים.

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

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

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

‫10 בספטמבר 2019

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

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

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

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

‫4 באפריל 2019

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

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

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

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

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

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

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

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

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

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

9 ביולי 2018

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

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

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

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

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

‫22 ביוני 2018

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

‫27 בנובמבר 2017

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

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

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

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

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

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

‫16 בנובמבר 2017

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

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

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

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

# JSON object:
{
 'id': 'ABC123',
 'snippet': {
   'title': 'Resource title',
   'description': 'Resource description',
 },
 'status': {
   'privacyStatus': 'private'
 }
}

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

‫25 באוקטובר 2017

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

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

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

    1. עוברים אל הכלי האינטראקטיבי של קטעי הקוד או אל מאמרי העזרה של כל שיטת 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 ל-methods של ה-API (דוגמה).

‫1 ביוני 2017

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

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

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

‫17 במאי 2017

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

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

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

    אתם יכולים גם לבצע פעולות בדוגמאות הקוד:

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

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

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

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

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

    • תמיכה בבקשות API שכותבות נתונים.
    • תמיכה בדוגמאות של Java.
    • קוד שחוזר על עצמו (boilerplate) גמיש ומקיף יותר לאימות משתמשים וליצירת בקשות API.

‫27 באפריל 2017

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

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

‫30 במרץ 2017

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

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

‫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. המאפיין הזה ייתמך עד 10 בנובמבר 2017.
    • המאפיין topicDetails.relevantTopicIds[] של המשאב video. המאפיין הזה ייתמך עד 10 בנובמבר 2017.
    • המאפיין topicDetails.topicIds[] של המשאב video. המאפיין הזה לא יכיל ערכים אחרי 10 בפברואר 2017. (אחרי התאריך הזה, ערך המאפיין topicDetails.relevantTopicIds[] יזהה את כל הנושאים שמשויכים לסרטון).

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

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

‫2 בנובמבר 2016

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

‫15 בספטמבר 2016

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

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

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

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

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

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

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

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

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

‫11 באוגוסט 2016

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

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

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

  • ההוצאה משימוש של 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 בכל הערוצים.

      אחרי 12 בספטמבר 2016, בקשות לאחזור פרטי פלייליסט (playlists.list) של היסטוריית הצפייה או של פלייליסט "לצפייה בהמשך" של ערוץ יחזירו רשימה ריקה. גם בקשות לאחזור פריטים (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,‏ תוצאת חיפוש,‏ תמונה ממוזערת ו-video כדי לציין שגדלים נוספים של תמונות ממוזערות זמינים לחלק מהסרטונים.

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

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

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

‫17 במאי 2016

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

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

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

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

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

‫28 באפריל 2016

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

  • המאפיין החדש contentDetails.projection של המשאב video מציין את פורמט ההקרנה של הסרטון. ערכי המאפיינים התקינים הם 360 ו-rectangular.

  • המאפיינים recordingDetails.location ו-fileDetails.recordingLocation של המשאב video עודכנו כדי להסביר את ההבדל בין שני המאפיינים:

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

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

  • ההגדרה של השגיאה ineligibleAccount, שיכולה להיות מוחזרת על ידי השיטה comments.insert, comments.update, commentThreads.insert או commentThreads.update, עודכנה כדי לשקף שהשגיאה מתרחשת כשחשבון YouTube שמשמש לאישור בקשת ה-API לא מוזג עם חשבון Google של המשתמש.

‫20 באפריל 2016

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

  • ההגדרה של הפרמטר part של השיטה channels.update עודכנה כדי לציין ש-localizations הוא גם ערך חוקי לפרמטר הזה.

  • הקטע Quota Usage במדריך לתחילת הדרך עודכן, ועכשיו הוא מקשר ל-Google Developer's Console, שבו אפשר לראות את המכסה בפועל ואת השימוש במכסה.

‫16 במרץ 2016

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

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

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

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

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

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

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

‫18 בדצמבר 2015

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

‫19 בנובמבר 2015

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

‫4 בנובמבר 2015

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

‫27 באפריל 2015

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

‫16 באפריל 2015

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

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

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

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

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

‫9 באפריל 2015

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

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

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

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

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

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

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

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

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

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

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

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

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

‫2 באפריל 2015

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

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

    ‫ה-API תומך בשיטות list,‏ insert,‏ update,‏ download ו-delete של רצועות כתוביות.

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

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

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

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

‫11 במרץ 2015

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

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

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

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

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

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

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

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

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

    • תמיכה בפיד RSS

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

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

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

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

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

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

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

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

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

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

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

‫4 במרץ 2015

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

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

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

    • 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 ה-methods ‏playlistItems.insert ו-playlistItems.update מחזירות את השגיאה הזו אם הבקשה מנסה להגדיר את המיקום של הפריט בפלייליסט, אבל הפלייליסט לא משתמש במיון ידני. לדוגמה, פריטים בפלייליסט יכולים להיות ממוינים לפי תאריך או פופולריות. כדי לפתור את השגיאה הזו, צריך להסיר את הרכיב snippet.position מהמשאב שנשלח בגוף הבקשה. אם רוצים שהפריט בפלייליסט יהיה במיקום ספציפי ברשימה, צריך קודם לעדכן את הגדרת הסדר של הפלייליסט לידני. אפשר לשנות את ההגדרה הזו במנהל הסרטונים ב-YouTube.
    forbidden (403) channelClosed ה-method‏ 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 ה-method‏ playlists.list מחזירה את השגיאה הזו אם הפרמטר id של הבקשה מציין פלייליסט שלא נמצא.
    notFound (404) videoNotFound השיטה videos.list מחזירה את השגיאה הזו אם הפרמטר id של הבקשה מציין סרטון שלא ניתן למצוא.
    badRequest (400) invalidRating ה-method‏ videos.rate מחזירה את השגיאה הזו אם הבקשה מכילה ערך לא צפוי בפרמטר rating.

‫2 במרץ 2015

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

‫14 בינואר 2015

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

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

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

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

‫11 בנובמבר 2014

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

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

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

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

      מפעילים את ה-method‏ search.list ומחפשים את GoogleDevelopers.

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

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

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

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

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

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

‫12 בספטמבר 2014

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

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

‫13 באוגוסט 2014

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

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

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

‫12 באוגוסט 2014

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

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

‫8 ביולי 2014

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

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

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

‫18 ביוני 2014

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

‫28 במאי 2014

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

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

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

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

‫13 במאי 2014

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

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

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

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

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

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

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

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

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

‫2 במאי 2014

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

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

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

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

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

‫7 באפריל 2014

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

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

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

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

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

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

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

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

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

‫31 במרץ 2014

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

‫13 במרץ 2014

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

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

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

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

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

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

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

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

    סוג השגיאה פרטי השגיאה תיאור
    badRequest (400) invalidCriteria ה-method‏ channels.list מחזירה את השגיאה הזו אם הבקשה מציינת פרמטרים של סינון שאי אפשר להשתמש בהם ביחד.
    badRequest (400) channelTitleUpdateForbidden ה-method‏ channels.update מחזירה את השגיאה הזו אם מנסים לעדכן את החלק brandingSettings של הערוץ ולשנות את הערך של המאפיין brandingSettings.channel.title. (שימו לב שה-API לא מחזיר את השגיאה אם משמיטים את המאפיין).
    badRequest (400) invalidRecentlyUploadedBy השיטה channels.update מחזירה את השגיאה הזו אם המאפיין invideoPromotion.items[].id.recentlyUploadedBy מציין מזהה ערוץ לא חוקי.
    badRequest (400) invalidTimingOffset ה-method‏ 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 ה-method‏ channels.update חייבת לציין אובייקט invideoPromotion.items[].timing לכל פריט מקודם.
    required (400) requiredWebsiteUrl ב-method‏ channels.update צריך לציין מאפיין invideoPromotion.items[].id.websiteUrl לכל פריט מקודם.
    badRequest (400) invalidPublishAt השיטה videos.insert מחזירה את השגיאה הזו אם המטא-נתונים של הבקשה מציינים זמן לא חוקי לפרסום מתוזמן.

‫4 במרץ 2014

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

‫5 בדצמבר 2013

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

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

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

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

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

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

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

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

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

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

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

‫24 באוקטובר 2013

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

‫1 באוקטובר 2013

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

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

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

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

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

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

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

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

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

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

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

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

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

‫27 באוגוסט 2013

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

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

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

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

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

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

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

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

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

‫15 באוגוסט 2013

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

‫8 באוגוסט 2013

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

‫30 ביולי 2013

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

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

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

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

  • ה-method‏ 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, הסיווג "unrated" משמש לעיתים קרובות לזיהוי גרסאות לא ערוכות של סרטים, שהגרסה הערוכה שלהם קיבלה סיווג רשמי.

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

  • הפרמטר mySubscribers של ה-method‏ channels.list הוצא משימוש. משתמשים ב-method‏ 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.

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

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

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

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

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

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

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

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

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

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

‫22 במאי 2013

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

‫14 במאי 2013

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

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

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

‫10 במאי 2013

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

‫8 במאי 2013

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

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

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

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

‫2 במאי 2013

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

‫19 באפריל 2013

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

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

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

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

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

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

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

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

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

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

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

  • ה-method‏ search.list תומך עכשיו בפונקציונליות הבאה:

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

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

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

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

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

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

‫12 במרץ 2013

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

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

    • activity – המאפיין מציין את שם הערוץ שאחראי לפעילות.
    • search – המאפיין מציין את שם הערוץ שמשויך למשאב שתוצאת החיפוש מזהה.
    • video – המאפיין מציין את שם הערוץ שהעלה את הסרטון.

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

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

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

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

  • השיטה playlistItems.update מחזירה עכשיו שגיאת invalidSnippet, שמוחזרת אם בקשת ה-API לא מציינת קטע קוד תקין.

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

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

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

      השיטות channels.list,‏ search.list,‏ videos.delete,‏ videos.list ו-videos.update תומכות בפרמטר הזה.

    • הפרמטר managedByMe, שנתמך על ידי השיטה channels.list, מורה ל-API להחזיר את כל הערוצים שבבעלות בעלי התוכן שצוינו בפרמטר onBehalfOfContentOwner.

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

‫25 בפברואר 2013

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

  • ה-API תומך בכמה חלקים ומאפיינים חדשים של משאבי video:

    • החלקים החדשים fileDetails,‏ processingDetails ו-suggestions מספקים לבעלי הסרטונים מידע על הסרטונים שהם העלו. הנתונים האלה שימושיים מאוד באפליקציות שמאפשרות העלאת סרטונים, והם כוללים:

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

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

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

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

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

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

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

      • dimension – מציין אם הסרטון זמין בדו-ממד או בתלת-ממד.
      • definition – מציין אם הסרטון זמין באיכות רגילה או באיכות גבוהה.
      • caption – מציין אם יש כתוביות לסרטון.
      • licensedContent – מציין אם הסרטון מכיל תוכן ששותף תוכן של YouTube הצהיר על זכויות יוצרים לגביו.

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

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

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

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

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

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

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

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

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

‫30 בינואר 2013

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

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

‫16 בינואר 2013

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

  • עכשיו יש דוגמאות קוד ל-methods ולשפות שמופיעות ברשימה הבאה:

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

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

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

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

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

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

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

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

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

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

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

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

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