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

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

30 באוקטובר 2024

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

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

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

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

30 באפריל 2024

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

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

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

13 במרץ 2024

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

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

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

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

12 במרץ 2024

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

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

7 במרץ 2024

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

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

‫31 בינואר 2024

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

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

9 בנובמבר 2023

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

12 בספטמבר 2023

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

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

נוספה הודעה על הוצאה משימוש לכל המסמכים שמפנים ל-method 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

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

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

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

12 ביולי 2022

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

27 באפריל 2022

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

8 באפריל 2022

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

15 בדצמבר 2021

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

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

18 בנובמבר 2021

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

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

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

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

2 ביולי 2021

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

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

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

1 ביולי 2021

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

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

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

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

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

12 במאי 2021

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

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

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

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

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

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

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

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

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

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

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

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

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

9 בפברואר 2021

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

‫28 בינואר 2021

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

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

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

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

15 באוקטובר 2020

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

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

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

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

8 באוקטובר 2020

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

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

9 בספטמבר 2020

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

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

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

29 ביולי 2020

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

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

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

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

28 ביולי 2020

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

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

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

21 ביולי 2020

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

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

7 ביולי 2020

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

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

15 ביוני 2020

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

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

4 ביוני 2020

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

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

17 באפריל 2020

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

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

31 במרץ 2020

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

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

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

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

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

10 בינואר 2020

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

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

  • המאפיין selfDeclaredMadeForKids מאפשר ליוצרי תוכן לציין אם ערוץ או סרטון מיועדים לילדים.

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

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

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

10 בספטמבר 2019

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

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

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

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

4 באפריל 2019

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

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

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

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

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

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

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

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

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

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

9 ביולי 2018

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

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

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

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

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

22 ביוני 2018

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

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

29 באוגוסט 2017

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

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

24 ביולי 2017

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

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

    הערה: הכלי מוטמע גם במאמרי העזרה של API עבור שיטות API (דוגמה).

‫1 ביוני 2017

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

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

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

17 במאי 2017

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

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

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

    אפשר גם להשתמש בדוגמאות קוד:

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

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

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

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

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

    • תמיכה בבקשות API שכותבות נתונים.
    • תמיכה בדוגמאות Java.
    • קוד תבנית גמיש ומקיף יותר להרשאת משתמשים וליצירת בקשות API.

27 באפריל 2017

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

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

‫30 במרץ 2017

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

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

27 בפברואר 2017

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

חשוב לדעת: בוצעו כמה שינויים ברשימה שנבחרה:

  • הנושאים הבאים נוספו כנושאי משנה של Society:
    שםמזהה נושא
    עסקי/m/09s1f
    בריאות/m/0kt51
    צבא/m/01h6rj
    פוליטיקה/m/05qt0
    דת/m/06bvp
  • הנושא Animated cartoon, שהיה בעבר צאצא של Entertainment, הוסר.
  • הנושא Children's music, שהיה בעבר צאצא של Music, הוסר.

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

29 בנובמבר 2016

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

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

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

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

10 בנובמבר 2016

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

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

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

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

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

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

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

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

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

2 בנובמבר 2016

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • עדכונים נוספים

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

15 בספטמבר 2016

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

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

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

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

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

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

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

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

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

11 באוגוסט 2016

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

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

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

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

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

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

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

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

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

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

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

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

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

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

13 ביוני 2016

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

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

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

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

31 במאי 2016

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

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

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

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

    • התמונה standard צריכה להיות ברוחב 640 פיקסלים ובגובה 480 פיקסלים.
    • התמונה של maxres היא ברוחב של 1280 פיקסלים ובגובה של 720 פיקסלים.
  • ההגדרה של הפרמטר part ב-method channelSection.list עודכנה, ועכשיו אפשר לאחזר את החלק targeting בעלות של 2 יחידות מכסה.

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

17 במאי 2016

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

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

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

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

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

28 באפריל 2016

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

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

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

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

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

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

20 באפריל 2016

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

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

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

16 במרץ 2016

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

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

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

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

18 בדצמבר 2015

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

19 בנובמבר 2015

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

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

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

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

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

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

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

      {
        "kind": "youtube#video",
        ...
        "snippet": {
          "title": "Playing soccer",
          "description": "We play soccer in the park on Sundays.",
          "defaultLanguage": "en",
          ...
        },
        "localizations":
          "de": {
            "title": "Fußball spielen",
            "description": "Wir spielen Fußball im Park am Sonntag"
          },
          "es": {
            "title": "Jugar al fútbol",
            "description": "Nosotros jugamos fútbol en el parque los domingos",
          }
        }
      }
    • חשוב: חשוב לזכור שכשמעדכנים את הנתונים המותאמים לשוק המקומי של משאב, בקשת ה-API חייבת לכלול את כל הגרסאות הקיימות של הנתונים, שמותאמות לשוק המקומי. למשל, אם שלחתם לאחר מכן בקשה להוסיף נתונים בפורטוגזית לסרטון בדוגמה שלמעלה, הבקשה תצטרך לכלול את הנתונים שהותאמו לשוק המקומי עבור גרמנית, ספרדית ופורטוגזית.

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

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

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

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

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

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

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

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

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

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

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

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

4 בנובמבר 2015

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

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

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

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

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

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

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

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

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

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

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

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

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

      פרטי השגיאה
      activities.insert
      קוד תגובה של 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 בפועל.

    • השיטות captions.delete, captions.download, captions.insert, captions.list ו-captions.update תומכות עכשיו בפרמטר onBehalfOfContentOwner, שכבר נתמך בכמה שיטות אחרות. בקשות שמשתמשות בשיטה הזו צריכות גם לקבל הרשאה באמצעות אסימון שמספק גישה להיקף ההרשאות של 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 מכיל מידע על הסיבה לכך שסרטון סומן כמכיל תוכן פוגעני. השיטה videoAbuseReportReasons.list מאפשרת לאחזר רשימה של כל הסיבות לסימון סרטונים.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

16 באפריל 2015

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

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

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

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

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

9 באפריל 2015

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

‫2 באפריל 2015

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

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

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

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

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

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

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

11 במרץ 2015

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

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

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

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

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

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

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

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

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

    • תמיכה בפיד RSS

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

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

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

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

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

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

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

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

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

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

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

4 במרץ, 2015

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

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

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

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

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

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

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

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

2 במרץ, 2015

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

‫14 בינואר 2015

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

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

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

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

11 בנובמבר 2014

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

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

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

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

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

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

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

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

8 באוקטובר 2014

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

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

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

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

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

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

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

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

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

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

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

12 בספטמבר 2014

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

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

13 באוגוסט 2014

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

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

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

12 באוגוסט 2014

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

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

8 ביולי 2014

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

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

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

18 ביוני 2014

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

28 במאי 2014

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

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

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

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

13 במאי 2014

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

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

  • עכשיו המשאב 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 לבקשות שבוצעו בהצלחה ל-methods האלה.

2 במאי 2014

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

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

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

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

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

7 באפריל 2014

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

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

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

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

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

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

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

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

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

‫4 במרץ 2014

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

5 בדצמבר 2013

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

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

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

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

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

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

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

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

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

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

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

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

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

24 באוקטובר 2013

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1 באוקטובר 2013

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

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

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

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

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

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

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

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

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

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

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

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

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

27 באוגוסט 2013

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

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

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

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

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

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

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

8 באוגוסט 2013

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

30 ביולי 2013

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

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

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

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

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

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

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

  • שם המאפיין recordingDetails.location.elevation של המשאב video השתנה ל-recordingDetails.location.altitude, ושם המאפיין fileDetails.recordingLocation.location.elevation השתנה ל-fileDetails.recordingLocation.location.altitude.

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

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

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

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

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

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

    סוג השגיאה פרטי השגיאה תיאור
    forbidden accountDelegationForbidden השגיאה הזו לא ספציפית לשיטת API מסוימת. היא מציינת שהמשתמש המאומת לא מורשה לפעול בשם חשבון Google שצוין.
    forbidden authenticatedUserAccountClosed השגיאה הזו לא ספציפית לשיטת API מסוימת. הוא מציין שחשבון YouTube של המשתמש המאומת סגור. אם המשתמש פועל בשמו של חשבון Google אחר, השגיאה הזו תציין שהחשבון האחר סגור.
    forbidden authenticatedUserAccountSuspended השגיאה הזו לא ספציפית לשיטת API מסוימת. הדבר מציין שחשבון YouTube של המשתמש המאומת מושעה. אם המשתמש פועל בשמו של חשבון Google אחר, השגיאה הזו תציין שהחשבון האחר מושעה.
    forbidden authenticatedUserNotChannel השגיאה הזו לא ספציפית לשיטת API מסוימת. הסטטוס מציין ששרת ה-API לא יכול לזהות את הערוץ שמשויך לבקשת ה-API. אם הבקשה מורשית ומשתמשת בפרמטר onBehalfOfContentOwner, צריך להגדיר גם את הפרמטר onBehalfOfContentOwnerChannel.
    forbidden cmsUserAccountNotFound השגיאה הזו לא ספציפית לשיטת API מסוימת. המשתמש במערכת ניהול התוכן אינו מורשה לפעול בשם בעלי התוכן שצוינו.
    notFound contentOwnerAccountNotFound השגיאה הזו לא ספציפית ל-method של API מסוים. החשבון שצוין של בעלי התוכן לא נמצא.
    badRequest invalidPart השגיאה הזו לא ספציפית לשיטת API מסוימת. הפרמטר part של הבקשה מציין חלקים שאי אפשר לכתוב בו-זמנית.
    badRequest videoChartNotFound השיטה videos.list מחזירה את השגיאה הזו כשהבקשה מציינת תרשים וידאו שאין בו תמיכה או שהוא לא זמין.
    notFound videoNotFound השיטה videos.update מחזירה את השגיאה הזו כדי לציין שלא ניתן למצוא את הסרטון שאתם מנסים לעדכן. צריך לבדוק את ערך המאפיין id בגוף הבקשה כדי לוודא שהוא נכון.

10 ביוני 2013

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

19 באפריל 2013

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    סוג השגיאה פרטי השגיאה תיאור
    badRequest invalidCategoryId המאפיין snippet.categoryId מציין מזהה קטגוריה לא חוקי. כדי לאחזר קטגוריות נתמכות צריך להשתמש בשיטה videoCategories.list.
    badRequest invalidRecordingDetails metadata specifies invalid recording details.
    badRequest invalidVideoGameRating המטא-נתונים של הבקשה מציינים דירוג לא חוקי של משחק וידאו.
    badRequest invalidVideoMetadata המטא-נתונים של הבקשה לא תקינים.
  • הפרמטר onBehalfOfContentOwner הוסר מרשימת הפרמטרים הנתמכים ל-method videos.update ו-videos.delete.

12 במרץ 2013

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

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

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

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

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

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

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

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

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

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

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

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

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

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

25 בפברואר 2013

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

30 בינואר, 2013

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

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

16 בינואר 2013

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

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

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

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

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

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

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

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

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

    שיטה מאפיינים
    activities.insert מאפיינים נדרשים:
    • snippet.description
    נכסים שניתנים לשינוי:
    • snippet.description
    • contentDetails.bulletin.resourceId
    playlists.update המאפיינים הנדרשים:
    • id
    playlistItems.update מאפיינים נדרשים:
    • id
    videos.update מאפיינים נדרשים:
    • id
  • ה-API לא מדווח יותר על שגיאה מסוג playlistAlreadyExists אם מנסים ליצור או לעדכן פלייליסט שיש לו שם זהה לפלייליסט שכבר קיים באותו ערוץ.

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

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