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

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

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.

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

22 באוגוסט 2023

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

18 באוגוסט 2023

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

7 באוגוסט 2023

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

‫28 ביוני 2023

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

12 ביוני 2023

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

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

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

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

22 באוגוסט 2022

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

5 באוגוסט 2022

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

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

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

12 ביולי 2022

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

27 באפריל 2022

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

8 באפריל 2022

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

15 בדצמבר 2021

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

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

18 בנובמבר 2021

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

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

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

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

2 ביולי 2021

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

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

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

1 ביולי 2021

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

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

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

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

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

12 במאי 2021

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

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

  • של המשאב channel contentDetails.relatedPlaylists.favorites הוצא משימוש. הפונקציונליות של סרטונים מועדפים כבר הוצאה משימוש עבור כפי שצוין במסמך 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[]

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

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

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

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

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

9 בפברואר 2021

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

‫28 בינואר 2021

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

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

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

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

15 באוקטובר 2020

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

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

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

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

8 באוקטובר 2020

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

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

9 בספטמבר 2020

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

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

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

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

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

21 ביולי 2020

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

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

7 ביולי 2020

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

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

15 ביוני 2020

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

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

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

10 בינואר 2020

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

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

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

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

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

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

10 בספטמבר 2019

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

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

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

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

4 באפריל 2019

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

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

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

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

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

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

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

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

27 בנובמבר 2017

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

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

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

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

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

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

16 בנובמבר 2017

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

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

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

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

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

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

25 באוקטובר 2017

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

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

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

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

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

29 באוגוסט 2017

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

  • ההגדרה של הפרמטר forContentOwner ב-method 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.

    הכלי מציג קטעי קוד לכל שיטה נתונה, לדוגמה, וכל תרחיש לדוגמה מתאר דרך נפוצה של קריאה לשיטה הזו. לדוגמה, אפשר להפעיל את method 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 בוויקיפדיה שמתארות את תוכן הערוץ. כתובות ה-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. לכן, התג player.embedHtml יכיל נגן בגודל 640x360 אם הפרמטר maxHeight או maxWidth לא מוגדר.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • התנאים וההגבלות החדשים של שירותי ממשקי ה-API של YouTube ("התנאים המעודכנים"), שעליהם מתוארות בפירוט בבלוג ההנדסה והמפתחים של 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 יחידות מכסה.

  • ה-method videos.list מחזירה שגיאת אסור (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, שמוחזרת באמצעות ה-method 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 עודכנו, ועכשיו הגודל המומלץ לתמונה של מודעת באנר של ערוץ שאתם מעלים הוא 2,560 פיקסלים על 1,440 פיקסלים. הגודל המינימלי (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 ה-methods channelSections.insert ו-channelSections.update מחזירות את השגיאה הזו כדי לציין שהמשאב channelSection שנשלח בבקשת ה-API צריך לציין ערך בשביל המאפיין snippet.style.
    badRequest (400) typeRequired ה-methods channelSections.insert ו-channelSections.update מחזירות את השגיאה הזו כדי לציין שהמשאב channelSection שנשלח בבקשת ה-API צריך לציין ערך בשביל המאפיין snippet.type.
    badRequest (400) processingFailure ה-method 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 ה-method videos.update מחזירה את השגיאה הזו כדי לציין שהמאפיין snippet.description במשאב video שהועלה ציין ערך לא חוקי.
    badRequest (400) invalidPublishAt ה-method videos.update מחזירה את השגיאה הזו כדי לציין שהנכס status.publishAt במשאב video שהועלה ציין זמן פרסום מתוזמן לא חוקי.
    badRequest (400) invalidRecordingDetails ה-method videos.update מחזירה את השגיאה הזו כדי לציין שהאובייקט recordingDetails במשאב video שהועלה ציין פרטי הקלטה לא חוקיים.
    badRequest (400) invalidTags ה-method videos.update מחזירה את השגיאה הזו כדי לציין שהמאפיין snippet.tags במשאב video שהועלה ציין ערך לא חוקי.
    badRequest (400) invalidTitle ה-method videos.update מחזירה את השגיאה הזו כדי לציין שהמאפיין snippet.title במשאב video שהועלה ציין כותרת סרטון לא חוקית או ריקה.
    badRequest (400) invalidVideoMetadata ה-method 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 של ה-method 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 שמתוארת למעלה.

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

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

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

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

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

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

    • הנכס החדש, 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 ה-methods channelSections.insert ו-channelSections.update מחזירות את השגיאה הזו אם המשאב channelSection שהוזן הכיל ערך לא חוקי עבור המאפיין targeting.countries[].
      badRequest (400) targetInvalidLanguage ה-methods channelSections.insert ו-channelSections.update מחזירות את השגיאה הזו אם המשאב channelSection שהוזן הכיל ערך לא חוקי עבור המאפיין targeting.languages[].
      badRequest (400) targetInvalidRegion ה-methods 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

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

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

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

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

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

9 באפריל 2015

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

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

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

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

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

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

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

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

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

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

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

2 באפריל 2015

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

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

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

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

  • ההיקף החדש של 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.

    ההיקף החדש נדרש כדי לשלוח קריאות לכל ה-methods של המשאב 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 v2 ב-API v3:

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

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

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

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

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

    • תמיכה בפיד RSS

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

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

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

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

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

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

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

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

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

    • עיבוד באצווה – v3 API תומך באחד מהתרחישים לדוגמה של עיבוד ברצף (batch processing) שנתמך ב-v2 API. ה-methods channels.list, channelSections.list, guideCategories.list, playlistItems.list, playlists.list, subscriptions.list, videoCategories.list ו-videos.list של API גרסה 3 תומכות כולן בפרמטר 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 ה-method playlists.list מחזירה את השגיאה הזו אם הפרמטר channelId של הבקשה מציין ערוץ שנסגר.
    forbidden (403) channelSuspended ה-method playlists.list מחזירה את השגיאה הזו אם הפרמטר channelId של הבקשה מציין ערוץ שהושעה.
    forbidden (403) playlistForbidden ה-method playlists.list מחזירה את השגיאה הזו אם הפרמטר id של הבקשה לא תומך בבקשה או אם הבקשה לא מורשית כראוי.
    notFound (404) channelNotFound ה-method 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

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

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

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

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

11 בנובמבר 2014

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

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

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

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

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

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

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

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

8 באוקטובר 2014

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

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

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

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

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

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

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

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

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

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

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

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

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

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

28 במאי 2014

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

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

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

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

13 במאי 2014

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

  • המאפיין invideoPromotion.items[] של המשאב channel עודכן כדי לציין שבדרך כלל אפשר להגדיר רק פריט מקודם אחד בערוץ. אם תנסו להוסיף יותר מדי פריטים מקודמים, ה-API יחזיר את השגיאה tooManyPromotedItems, עם קוד הסטטוס 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 כשמבצעים קריאה ל-methods של 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 ה-method channels.update מחזירה את השגיאה הזו אם החלק invideoPromotion מציין קיזוז תזמון לא חוקי.
    badRequest (400) tooManyPromotedItems השיטה channels.update מחזירה את השגיאה הזו אם החלק invideoPromotion מציין יותר מהמספר המותר של פריטים מקודמים.
    forbidden (403) promotedVideoNotAllowed ה-method channels.update מחזירה את השגיאה הזו אם בנכס invideoPromotion.items[].id.videoId מצוין מזהה סרטון שלא ניתן למצוא או שאי אפשר להשתמש בו כפריט מקודם.
    forbidden (403) websiteLinkNotAllowed ה-method 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 עודכנו ועכשיו הם משקפים כראוי שאין צורך לציין ערך לפרמטר מסנן אחד בדיוק כששולחים בקשת חיפוש. במקום זאת, אפשר להגדיר ערך עבור אפס פרמטרים של סינון או עבור פרמטר אחד של מסנן.

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

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

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

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

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

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

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

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

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

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

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

1 באוקטובר 2013

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

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

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

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

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

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

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

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

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

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

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

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

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

27 באוגוסט 2013

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

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

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

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

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

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

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

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

10 ביוני 2013

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

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

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

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

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

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

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

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

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

    סוג השגיאה פרטי השגיאה תיאור
    forbidden insufficientCapabilities השגיאה הזו לא ספציפית ל-method של API מסוים. היא מציינת שלמשתמש במערכת ניהול התוכן שקורא ל-API אין הרשאות מספיקות לביצוע הפעולה המבוקשת. השגיאה הזו משויכת לשימוש בפרמטר onBehalfOfContentOwner, שנתמך בכמה שיטות API.
    unauthorized authorizationRequired ה-method 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 החדשה כדי לעדכן את נתוני הקמפיינים של הערוץ לפרסום בווידאו. חשוב לשים לב שה-method תומכת בעדכונים רק בחלק 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 מכיל את המאפיינים החדשים הבאים:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

25 בפברואר 2013

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

30 בינואר, 2013

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

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

16 בינואר, 2013

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

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

  • משאב 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).

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

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

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

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

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

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