דף זה מפרט את השינויים ב-YouTube Data API (v3) ועדכוני התיעוד. הרשמה ליומן שינויים זה.
30 באפריל 2024
הערה: זוהי הודעה על הוצאה משימוש.
העדכון הזה כולל את השינויים הבאים:
ה-API כבר לא תומך באפשרות להוסיף או לאחזר דיונים בערוץ. השינוי הזה תואם לפונקציונליות הנתמכת באתר YouTube, שאינה תומכת בפרסום תגובות בערוצים.
13 במרץ 2024
הערה: זוהי הודעה על הוצאה משימוש.
העדכון הזה כולל את השינויים הבאים:
הפרמטר sync
הוצא משימוש בשיטות captions.insert
ו-captions.update
. החל מ-12 באפריל 2024, המערכת של YouTube תפסיק לתמוך
בפרמטר.
בעקבות השינוי הזה, מפתחים חייבים לכלול פרטי תזמון כשהם מוסיפים או מעדכנים טראקים של כתוביות, אחרת ההעלאה תיכשל.
12 במרץ 2024
העדכון הזה כולל את השינויים הבאים:
המסמכים של המשאב captions
עודכנו, ולכן האורך המקסימלי המותר לשדה snippet.name
הוא 150 תווים. ה-API יחזיר את השגיאה nameTooLong
אם שם הטראק ארוך יותר.
7 במרץ 2024
הערה: זוהי הודעה על הוצאה משימוש.
מאפיין המשאב channel
brandingSettings.channel.moderateComments
הוצא משימוש. מערכת YouTube תפסיק
לתמוך בפרמטר ב-7 במרץ 2024.
31 בינואר 2024
העדכון הזה כולל את השינויים הבאים:
הפרמטר forHandle
החדש של השיטה channels.list
מאפשר לאחזר מידע על ערוץ על ידי ציון הכינוי שלו ב-YouTube.
9 בנובמבר 2023
כל ההפניות למשאב videoId
תחת Comments
הוסרו כי המשאב videoId
לא מוחזר באמצעות קריאה ל-API.
12 בספטמבר 2023
הערה: זוהי הודעה על הוצאה משימוש.
השיטה comments.markAsSpam
הוצאה משימוש במשך כמה שנים. השיטה הזו כבר לא נתמכת ב-YouTube
והיא לא נתמכת יותר דרך ה-API.
נוספה הודעה על הוצאה משימוש לכל המסמכים שמפנים ל-comments.markAsSpam
.
22 באוגוסט 2023
השיטה search.list
תומכת עכשיו בפרמטר videoPaidProductPlacement
. הפרמטר הזה מאפשר לסנן את תוצאות החיפוש כך שיכללו רק סרטונים
שהיוצר ציין שיש להם קידום מכירות בתשלום.
18 באוגוסט 2023
ההגדרה של
liveStreamingDetails.concurrentViewers
של המשאב video
עודכנה, ועכשיו יש לכך שספירות של צופים בו-זמנית ש-YouTube Data API מחזיר עשויות
להיות שונות מספירות של צופים בו-זמנית שעברו עיבוד ושהוסרו מהן ספאם, הזמינות דרך YouTube
Analytics. במרכז העזרה של YouTube
אפשר למצוא מידע נוסף על מדדים של סטרימינג בשידור חי.
7 באוגוסט 2023
כפי שהודענו ב-12 ביוני 2023,
הפרמטר relatedToVideoId
של השיטה search.list
הוצא משימוש. הפרמטר הזה לא נתמך יותר, וההפניות לפרמטר הוסרו ממסמכי התיעוד של ה-API.
28 ביוני 2023
השיטה thumbnails.set תומכת עכשיו בשגיאה uploadRateLimitExceeded
. השגיאה הזו מציינת שהערוץ העלה יותר מדי
תמונות ממוזערות ב-24 השעות האחרונות, וצריך לנסות שוב מאוחר יותר.
12 ביוני 2023
הערה: זוהי הודעה על הוצאה משימוש.
הפרמטר relatedToVideoId
של השיטה search.list הוצא משימוש. החל מ-7 באוגוסט 2023, המערכת של YouTube תפסיק לתמוך
בפרמטר.
בשלב הזה, נוספה הודעה על הוצאה משימוש למסמכי התיעוד של
השיטה search.list
. הפרמטר הזה יוסר לגמרי מהתיעוד של search.list
ב-7 באוגוסט 2023 או לאחר מכן.
בנוסף, דוגמה שמדגימה איך לאחזר סרטונים קשורים הוסרה מהמדריך להטמעת API.
22 באוגוסט 2022
תוקנו הערות מסוג עבור שדות video.statistics למחרוזת מאורך ללא חתימה.
5 באוגוסט 2022
מערכת YouTube שינתה את הדרך שבה מזהי כתוביות נוצרים, וכחלק מהשינוי הזה
מקצה מזהי כתוביות חדשים לכל הטראקים של כתוביות. השינוי הזה עשוי להיות שינוי שאינו תואם
לאחור לאפליקציות שמאחסנות
ערכי caption_id
, אבל לא
ישפיע על אפליקציות שלא מאחסנות
ערכי caption_id
.
מעכשיו ל-1 בדצמבר 2022, השיטות captions.list
,
captions.update
,
captions.download
,
וגם captions.delete
יתמכו
במזהים הישנים וגם במזהים החדשים של טראקים עם כתוביות. עם זאת, החל מ-1 בדצמבר 2022 או לאחר מכן, מערכת YouTube
תפסיק לתמוך במזהים הישנים של רצועות כתוביות. בשלב זה, קריאה לאחת משיטות ה-API האלה
עם מזהה ישן של רצועת כתוביות, תוביל לשגיאה
captionNotFound
.
כדי להתכונן לשינוי הזה, כדאי להחליף באופן מלא את כל הנתונים של טראקים של כתוביות שנשמרו
מעכשיו עד 1 בדצמבר 2022. כלומר, בכל סרטון שבו נשמרים נתונים של רצועות כתוביות,
צריך למחוק את הנתונים הקיימים ולאחר מכן להפעיל
את השיטה captions.list
כדי לאחזר את
הקבוצה הנוכחית של רצועות הכתוביות עבור הסרטון, ולאחסן את הנתונים בתגובת ה-API
כרגיל.
12 ביולי 2022
התנאים וההגבלות של שירותי YouTube API עודכנו. מידע נוסף זמין בתנאים ובהגבלות של שירותי YouTube API – היסטוריית גרסאות.
27 באפריל 2022
תיאור השיטה videos.insert
עודכן כדי לראות שגודל הקובץ המקסימלי של סרטונים שהועלו עלה מ-128GB ל-256GB.
8 באפריל 2022
עדכנו את הגדרות הפרמטר myRecentSubscribers
ו-mySubscribers
של השיטה subscriptions.list
, כך שמספר המנויים המקסימלי שהוחזר על ידי ה-API עשוי להיות מוגבל.
השינוי הזה מייצג תיקון של תיעוד ולא שינוי בהתנהגות של ה-API.
15 בדצמבר 2021
כפי שהודענו ב-18 בנובמבר 2021, לצד
השינויים שגרמו לספירת דיסלייקים
לסרטונים בכל פלטפורמת YouTube, נכס statistics.dislikeCount
של משאב video
מוגדר עכשיו כפרטי.
מידע נוסף על השינוי הזה זמין בבלוג הרשמי של YouTube.
18 בנובמבר 2021
לצד שינויים שיהפכו את
ספירות הדיסלייקים של סרטונים לפרטיות בכל פלטפורמת YouTube, הנכס
statistics.dislikeCount
של המשאב video
יהפוך לפרטי החל מ-13 בדצמבר 2021. כלומר, הנכס
ייכלל בתגובת API מנקודת הקצה של videos.list
רק אם בקשת ה-API
אומתה על ידי הבעלים של הסרטון.
נקודת הקצה videos.rate
לא מושפעת
מהשינוי הזה.
מפתחים שלא מציגים את מספר הדיסלייקים באופן ציבורי ועדיין זקוקים למספר הדיסלייקים עבור לקוח ה-API שלהם, יכולים להגיש בקשה להוספה לרשימת היתרים לקבלת פטור. כדי להגיש בקשה לפטור, צריך למלא את טופס הבקשה הזה.
מידע נוסף על השינוי הזה זמין בבלוג הרשמי של YouTube.
2 ביולי 2021
הערה: זוהי הודעה על הוצאה משימוש.
נקודת הקצה commentThreads.update
הוצאה משימוש ולא נתמכת יותר.
הפונקציה הזאת של נקודת הקצה (endpoint) הזו זמינה דרך נקודות קצה (endpoints) אחרות ב-API. במקום זאת, אפשר לקרוא ל-comments.update
commentThreads
, מבצעים קריאה משנית ל-method commentThreads.list
.
1 ביולי 2021
כל המפתחים המשתמשים בשירותי API של YouTube חייבים להשלים ביקורת תאימות API על מנת לקבל יותר ממכסת ברירת המחדל של 10,000 יחידות. עד כה, גם תהליך בדיקת התאימות וגם הבקשות להקצאות נוספות של יחידות מכסות בוצעו על ידי מפתחים שמילאו ושלחו את שירותי YouTube API - ביקורת ותוסף מכסה.
כדי להבהיר את התהליכים האלה ולענות טוב יותר על צורכי המפתחים שמשתמשים בשירותי ה-API שלנו, אנחנו מוסיפים שלושה טפסים חדשים ומדריך למילוי הטפסים האלה:
- טופס בקשות למפתחים שעברו ביקורת: מפתחים שכבר עברו בדיקת תאימות לממשק ה-API יכולים למלא את הטופס הקצר הזה ולשלוח אותו כדי לבקש הארכה של מכסה.
- טופס ערעור: מפתחים שהפרויקטים שלהם ב-API לא עברו בדיקת תאימות (או שבקשה להגדלת יחידת המכסות שלהם נדחתה) יכולים למלא את הטופס הזה ולשלוח אותו.
- טופס שינוי של אמצעי הבקרה: מפתחים או כל גורם שמפעיל לקוח API בשם מפתח, וחווה שינוי בשליטה (לדוגמה, עקב רכישה או מכירה של מניות, מיזוג או כל צורה אחרת של עסקה ארגונית) שמשויך לפרויקט API, חייבים למלא ולשלוח את הטופס הזה. כך צוות ה-API של YouTube יכול לעדכן את הרשומות שלנו, לבדוק את התאימות של התרחיש לדוגמה של פרויקט ה-API החדש ולאמת את הקצאת המכסות הנוכחית של המפתח.
כל טופס חדש יעזור לנו לדעת מה השימוש שאתם מתכוונים לעשות בממשק ה-API של YouTube, ויאפשר לנו לעזור לכם בצורה טובה יותר.
פרטים נוספים זמינים במדריך החדש שלנו לבקרת תאימות לממשקי API.
12 במאי 2021
הערה: זוהי הודעה על הוצאה משימוש.
העדכון הזה כולל את השינויים הבאים ב-API:
-
המאפיין
contentDetails.relatedPlaylists.favorites
של המשאבchannel
הוצא משימוש. הפונקציונליות של סרטונים מועדפים כבר הוצאה משימוש במשך כמה שנים, כפי שצוין ברשומת היסטוריית הגרסאות בתאריך 28 באפריל 2016.לפני העדכון הזה, ה-API עדיין היה יוצר פלייליסט חדש אם לקוח API ניסה להוסיף סרטון לפלייליסט מועדפים שלא קיים. מעכשיו והלאה, הפלייליסט לא ייווצר במקרה הזה, וה-API יחזיר הודעת שגיאה. גם ניסיונות לשנות פלייליסטים מועדפים על ידי הוספה, שינוי או מחיקה של פריטים הוצאו משימוש בהתאם להודעות הקודמות, והם עשויים להתחיל להחזיר שגיאות בכל שלב.
-
מאפייני המשאבים הבאים של
channel
הוצאו משימוש. המאפיינים האלה כבר לא נתמכים בממשק המשתמש של YouTube Studio וב-YouTube. כתוצאה מכך, הן גם לא נתמכות יותר דרך ה-API.brandingSettings.channel.defaultTab
brandingSettings.channel.featuredChannelsTitle
brandingSettings.channel.featuredChannelsUrls[]
brandingSettings.channel.profileColor
brandingSettings.channel.showBrowseView
brandingSettings.channel.showRelatedChannels
כל המאפיינים הוסרו מייצוג המשאבים של
channel
, וההגדרות שלהם הוסרו מרשימת המאפיינים של המשאב. בנוסף, שגיאות שמשויכות למאפיינים האלה הוסרו ממסמכי התיעוד הספציפיים לשיטה. -
מאפייני המשאבים הבאים של
channelSection
הוצאו משימוש. המאפיינים האלה כבר לא נתמכים בממשק המשתמש של YouTube Studio וב-YouTube. כתוצאה מכך, הן גם לא נתמכות יותר דרך ה-API.snippet.style
snippet.defaultLanguage
snippet.localized.title
localizations
localizations.(key)
localizations.(key).title
targeting
targeting.languages[]
targeting.regions[]
targeting.countries[]
לצד השינוי הזה, גם הפרמטר
hl
של השיטהchannelSection.list
הוצא משימוש כי התכונות שנתמכות בה לא נתמכות.כל המאפיינים הוסרו מייצוג המשאבים של
channelSection
, וההגדרות שלהם הוסרו מרשימת המאפיינים של המשאב. בנוסף, שגיאות שמשויכות למאפיינים האלה הוסרו ממסמכי התיעוד הספציפיים לשיטה. -
עבור המאפיין
snippet.type
של המשאבchannelSection
, הערכים הבאים הוצאו משימוש. הערכים האלה כבר לא נתמכים בדפי ערוצים של YouTube, וכתוצאה מכך הם גם לא נתמכים יותר דרך ה-API.likedPlaylists
likes
postedPlaylists
postedVideos
recentActivity
recentPosts
-
המאפיין
snippet.tags[]
של המשאבplaylist
הוצא משימוש. הנכס הזה כבר לא נתמך ב-YouTube, וכתוצאה מכך הוא כבר לא נתמך דרך ה-API.
9 בפברואר 2021
המשאב playlistItem
תומך בשני מאפיינים חדשים:
- המאפיין
snippet.videoOwnerChannelId
מזהה את המזהה של הערוץ שהעלה את הסרטון בפלייליסט. - המאפיין
snippet.videoOwnerChannelTitle
מזהה את שם הערוץ שהעלה את הסרטון בפלייליסט.
28 בינואר 2021
העדכון הזה כולל את השינויים הבאים:
-
השיטות
playlistItems.delete
,playlistItems.insert
,playlistItems.list
,playlistItems.update
,playlists.delete
,playlists.list
, ו-playlists.update
תומכות בשגיאתplaylistOperationUnsupported
חדשה. השגיאה מתרחשת כשבקשה מנסה לבצע פעולה שאסור לבצע בפלייליסט מסוים. לדוגמה, משתמש לא יכול למחוק סרטון מהפלייליסט של הסרטונים שהוא העלה או למחוק את הפלייליסט עצמו.בכל המקרים, השגיאה מחזירה קוד תגובת HTTP מסוג
400
(בקשה שגויה). -
השגיאות
watchHistoryNotAccessible
ו-watchLaterNotAccessible
של השיטהplaylistItems.list
הוסרו מהתיעוד. אכן אי אפשר לגשת להיסטוריית הצפייה ולרשימות הצפייה במועד מאוחר יותר דרך ה-API, אבל ה-API לא מחזיר את השגיאות הספציפיות האלה.
15 באוקטובר 2020
שני קטעים חדשים נוספו למדיניות למפתחים:
- סעיף III.E.4.i החדש מספק מידע נוסף על הנתונים שנאספים ונשלחים דרך הנגן המוטמע של YouTube. באחריותך לכל נתוני המשתמש שיישלחו אלינו דרך נגן מוטמע של YouTube לפני האינטראקציה של המשתמש עם הנגן כדי לציין את הכוונה להפעלה. אפשר להגביל את הנתונים שמשותפים עם YouTube לפני האינטראקציה של המשתמש עם הנגן. כדי לעשות זאת, מגדירים את ההפעלה האוטומטית כ-False.
- סעיף III.E.4.j החדש מתייחס לבדיקת הסטטוס של תוכן 'במיוחד לילדים' (MFK) לפני הטמעתו באתרים ובאפליקציות שלך. באחריותך לדעת מתי סרטונים שמטמיעים בלקוח ה-API שלך הם 'במיוחד לילדים', ומטפלים בנתונים שנאספו מהנגן המוטמע בהתאם. לכן, עליך לבדוק את הסטטוס של התוכן באמצעות שירות YouTube Data API לפני שמטמיעים אותו בלקוח ה-API שלך דרך נגנים מוטמעים של YouTube.
המדריך החדש איתור הסטטוס MadeForKids של סרטון מסביר איך לחפש את סטטוס MFK של סרטון באמצעות שירות YouTube Data API.
לצד השינויים האלה, נוספה תזכורת לתיעוד של הפרמטרים של הנגן המוטמע כדי להסביר שאם מפעילים את ההפעלה האוטומטית, ההפעלה תתבצע ללא אינטראקציה של המשתמש עם הנגן. לכן, האיסוף והשיתוף של נתוני ההפעלה יתרחשו עם טעינת הדף.
8 באוקטובר 2020
עדכון זה כולל שלושה שינויים קטנים הקשורים למשאב channel
:
- יכול להיות שהאובייקט
snippet.thumbnails
, שמזהה את התמונות הממוזערות של הערוץ, יהיה ריק בערוצים חדשים, והאכלוס שלו יכול להימשך עד יום אחד. - המאפיין
statistics.videoCount
משקף את מספר הסרטונים הגלויים לכולם בערוץ בלבד, אפילו לבעלים. התנהגות זו תואמת לספירות המוצגות באתר YouTube. - מילות מפתח של הערוץ שמזוהות במאפיין
brandingSettings.channel.keywords
עשויות להיקטע אם הן חורגות מהאורך המקסימלי המותר של 500 תווים, או אם הן מכילות מירכאות ללא תווי escape ("
). חשוב לשים לב: מגבלת 500 התווים אינה מגבלה לכל מילת מפתח, אלא מגבלה על האורך הכולל של כל מילות המפתח. התנהגות זו תואמת להתנהגות המוצגת באתר YouTube.
9 בספטמבר 2020
הערה: זוהי הודעה על הוצאה משימוש.
העדכון הזה כולל את השינויים הבאים ב-API. כל השינויים ייכנסו לתוקף בתאריך 9 בספטמבר 2020, תאריך ההודעה הזו. לכן, המפתחים לא צריכים יותר להסתמך על תכונות ה-API שמפורטות בהמשך.
-
המשאבים, השיטות, הפרמטרים ומאפייני המשאבים הבאים של API הוצאו משימוש
באופן מיידי ויפסיקו לפעול בתאריך ההודעה הזו או אחריו:
- מאפייני המשאבים הבאים של
channel
:- הנכס
statistics.commentCount
- האובייקט
brandingSettings.image
וכל מאפייני הצאצא שלו - הרשימה
brandingSettings.hints
וכל מאפייני הצאצא שלה
- הנכס
- פרמטר המסנן
categoryId
של השיטהchannels.list
- המשאב
guideCategories
וה-methodguideCategories.list
- מאפייני המשאבים הבאים של
-
תגובות API ל-method
channels.list
לא כוללות יותר את המאפייןprevPageToken
אם בקשת ה-API מגדירה את הפרמטרmanagedByMe
כ-true
. השינוי הזה לא משפיע על הנכסprevPageToken
בבקשות אחרות שלchannels.list
, ולא משפיע על המאפייןnextPageToken
לגבי בקשות כלשהן. -
ב-11 באוגוסט 2016 הוכרז שמאפייני
contentDetails.relatedPlaylists.watchLater
ו-contentDetails.relatedPlaylists.watchHistory
של המשאבchannel
הוצאו משימוש. גם התמיכה של השיטהplaylistItems.insert
ושל השיטהplaylistItems.delete
בפלייליסטים האלה הוצאה משימוש לחלוטין, ושני המאפיינים הוסרו מהתיעוד. -
הפרמטר
mySubscribers
של השיטהchannels.list
, שהודענו עליו שיצא משימוש ב-30 ביולי 2013, הוסר מהתיעוד. משתמשים בשיטהsubscriptions.list
ובפרמטרmySubscribers
כדי לאחזר רשימה של מנויים לערוץ של המשתמש המאומת. -
האובייקט
invideoPromotion
של המשאבchannel
וכל המאפיינים הצאצאים שלו, שהודענו על כך שהוצאו משימוש ב-27 בנובמבר 2017, הוסרו מהתיעוד.
29 ביולי 2020
הפכנו את התהליך לפשוט יותר של חיוב מכסת בקשות עבור בקשות API על ידי הסרת העלות
הנוספת שמשויכת לפרמטר part
. לתוקף באופן מיידי, נחייב רק את
העלות הבסיסית של השיטה שנקראת. כאן אפשר למצוא מידע נוסף על המכסה הפשוטה.
ההשפעה של השינוי הזה היא שעלות המכסה של רוב הקריאות ל-API תהיה נמוכה יותר באופן שולי, ואילו קריאות מסוימות ל-API ימשיכו להיות באותה עלות. השינוי הזה לא מגדיל את העלות של קריאות ל-API. באופן כללי, סביר להניח שההשפעה על המכסה שהוקצתה לכם, במסוף Google Cloud, תשתפר עוד יותר.
אנחנו ממליצים מאוד לכל המפתחים להשלים בדיקת תאימות לפרויקטים שלהם, כדי להבטיח את המשך הגישה לשירותי YouTube API.
הרשומה הזו של היסטוריית גרסאות פורסמה במקור ב-20 ביולי 2020.
28 ביולי 2020
כל הסרטונים שהועלו דרך נקודת הקצה videos.insert
מפרויקטים לא מאומתים ב-API, שנוצרו אחרי 28 ביולי 2020, יוגבלו
למצב צפייה פרטית. כדי להסיר את ההגבלה הזו, כל פרויקט צריך לערוך ביקורת כדי לוודא שהוא עומד
בתנאים ובהגבלות.
יוצרים שמשתמשים בלקוח API לא מאומת כדי להעלות סרטון יקבלו אימייל שבו מוסבר שהסרטון שלהם נעול בסטטוס 'פרטי', ושהם יכולים להימנע מההגבלה באמצעות שימוש בלקוח רשמי או מבוקר.
בשלב זה, פרויקטים של API שנוצרו לפני 28 ביולי 2020 לא מושפעים מהשינוי הזה. עם זאת, מומלץ מאוד להשלים בדיקת תאימות של הפרויקטים שלהם כדי להבטיח את המשך הגישה לשירותי YouTube API.
21 ביולי 2020
[תאריך העדכון: 28 ביולי 2020] עדכון התיעוד שמוזכר ברשומה זו של היסטוריית גרסאות פורסם מחדש ב-28 ביולי 2020.
אתמול פרסמנו עדכון מסמכים לגבי התהליך שלנו לחיוב מכסות. עם זאת, עקב נסיבות בלתי צפויות, השינוי במכסה עדיין לא נכנס לתוקף. לכן, המסמכים בוטלו כדי לשמור על דיוק. כדי למנוע בלבול, הוסרה הרשומה בהיסטוריית הגרסאות שבה מופיע השינוי, ותפורסם מחדש בעתיד הקרוב.
7 ביולי 2020
הערה: זוהי הודעה על הוצאה משימוש.
הפרמטרים autoLevels
ו-stabilize
של השיטה videos.insert
הוצאו משימוש, ושני הפרמטרים הוסרו מהתיעוד. המערכת מתעלמת מהערכים שלהם ולא משפיעה על אופן העיבוד של סרטונים חדשים שהועלו.
15 ביוני 2020
המדריך החדש עמידה במדיניות למפתחים של YouTube כולל הנחיות ודוגמאות שיעזרו לכם לוודא שלקוחות ה-API שלכם פועלים בהתאם לחלקים ספציפיים בתנאים ובכללי המדיניות של שירותי YouTube API.
הנחיות אלה מספקות תובנות לגבי האופן שבו YouTube אוכפת היבטים מסוימים של התנאים וההגבלות של ה-API, אבל היא לא מחליפה אף מסמך קיים. המדריך עוסק בכמה מהשאלות הנפוצות ביותר שמפתחים שואלים במהלך ביקורות של תאימות ל-API. אנחנו מקווים שהוא יקל עליך את תהליך פיתוח התכונות ויעזור לך להבין איך אנחנו מפרשים את המדיניות שלנו ואוכפים אותה.
4 ביוני 2020
הערה:זהו עדכון להודעה קודמת על הוצאה משימוש.
תכונת מבזק הערוץ הוצאה משימוש לחלוטין. השינוי הזה הוכרז לראשונה ב-17 באפריל 2020 והוא נכנס לתוקף עכשיו. כתוצאה מכך, אין יותר תמיכה בשיטה activities.insert
, וה-method activities.list
לא מחזירה יותר מבזקי ערוץ. פרטים נוספים זמינים
במרכז העזרה של YouTube.
17 באפריל 2020
הערה: זוהי הודעה על הוצאה משימוש.
YouTube מוציאה משימוש את התכונה 'מבזק ערוץ'. כתוצאה מכך, השיטה activities.insert
תצא משימוש, וה-method activities.list
תפסיק להחזיר את מבזקי הערוץ. השינויים האלה ייכנסו לתוקף ב-API
החל מ-18 במאי 2020. פרטים נוספים זמינים
במרכז העזרה של YouTube.
31 במרץ 2020
העדכון הזה כולל את השינויים הבאים:
-
שיטות ומקורות מידע חדשים
-
המשאב החדש
member
מייצג חבר במועדון של ערוץ YouTube. חבר מועדון מספק תמיכה כספית קבועה ליוצר ומקבל הטבות מיוחדות. לדוגמה, חברי המועדון יוכלו להתכתב בצ'אט כשהיוצר הפעיל את מצב 'לחברי מועדון בלבד' בצ'אט.המשאב הזה מחליף את המשאב
sponsor
, שמתועד כחלק מ-YouTube Live Streaming API. המשאבsponsor
הוצא משימוש, ולקוחות ה-API צריכים לעדכן את הקריאות ל-methodsponsors.list
כדי שישתמשו בשיטהmembers.list
במקום זאת. -
המשאב החדש
membershipsLevel
מזהה רמת תמחור שמנוהלת על ידי היוצר שאישר את בקשת ה-API. השיטהmembershipsLevels.list
מאחזרת רשימה של כל רמות החברות של היוצר.
-
10 בינואר 2020
ה-API תומך עכשיו ביכולת לזהות תוכן שמיועד לילדים, וההגדרה של YouTube מסווגת כ"במיוחד לילדים". מידע נוסף על תוכן שמוגדר 'במיוחד לילדים' זמין במרכז העזרה של YouTube.
המשאבים channel
ו-video
תומכים בשני נכסים חדשים שמאפשרים ליוצרי תוכן ולצופים לזהות תוכן שהוא 'במיוחד לילדים':
-
המאפיין
selfDeclaredMadeForKids
מאפשר ליוצרי תוכן לציין אם ערוץ או סרטון הם 'במיוחד לילדים'.
בערוצים, אפשר להגדיר את המאפיין הזה כשמפעילים את השיטהchannels.update
. לסרטונים, אפשר להגדיר את המאפיין הזה כשמפעילים את השיטהvideos.insert
או השיטהvideos.update
.
הערה: הנכס הזה נכלל בתגובות API שמכילות משאבים מסוגchannel
אוvideo
רק אם הבעלים של הערוץ אישרו את בקשת ה-API. -
הנכס
madeForKids
מאפשר לכל משתמש לאחזר את הסטטוס 'במיוחד לילדים' של ערוץ או של סרטון. לדוגמה, ייתכן שהסטטוס ייקבע לפי הערך של המאפייןselfDeclaredMadeForKids
. כדאי לעיין במרכז העזרה של YouTube כדי לקבל מידע נוסף על הגדרת הקהל של הערוץ, הסרטונים או השידורים שלך.
עדכנו גם את התנאים וההגבלות של שירותי YouTube API ואת המדיניות למפתחים. מידע נוסף זמין בתנאים ובהגבלות של שירותי YouTube API – היסטוריית גרסאות. השינויים בתנאים ובהגבלות של שירותי YouTube API ובמדיניות למפתחים ייכנסו לתוקף ב-10 בינואר 2020, לפי שעון החוף המערבי של ארה"ב.
10 בספטמבר 2019
מסמכי התיעוד של ה-API עודכנו כדי לשקף שינוי באופן הדיווח על ספירת מנויים ב-YouTube, וכתוצאה מכך גם בתגובות ל-API. כתוצאה מהשינוי, מספרי המנויים שמוחזרים על ידי שירות YouTube Data API מעוגלים כלפי מטה לשלושה מספרים משמעותיים
אם מדובר במספר המנויים הכולל מעל 1,000 מנויים. השינוי הזה משפיע על
המאפיין statistics.subscriberCount
של המשאב channel
.
הערה: השינוי הזה משפיע על ערך הנכס הזה גם במקרים שבהם משתמש שולח בקשה מורשית לנתונים לגבי הערוץ שלו. בעלי הערוצים עדיין יכולים לראות את מספר המנויים המדויק ב-YouTube Studio.
לדוגמה, אם לערוץ יש 123,456 מנויים, הנכס statistics.subscriberCount
יכיל את הערך 123000
.
בטבלה הבאה מוצגות דוגמאות לאופן שבו מספר המנויים מעוגל בתגובות API
ומופיע בקיצורים בממשקי משתמש אחרים של YouTube שגלויים לכולם:
דוגמה למספר מנויים | YouTube Data API | ממשקי משתמש של YouTube שגלויים לכולם |
---|---|---|
1,234 | 1230 | 1.23K |
12,345 | 12300 | 12.3K |
123,456 | 123000 | 123K |
1,234,567 | 1230000 | 1.23M |
12,345,678 | 12300000 | 12.3M |
123,456,789 | 123000000 | 123M |
4 באפריל 2019
העדכון הזה כולל את השינויים הבאים:
-
מסמכי התיעוד של ה-API עודכנו כדי להסביר טוב יותר תרחישים נפוצים של שימוש בכל שיטה, וכדי לספק דוגמאות קוד דינמיות ואיכותיות דרך הווידג'ט של APIs Explorer. כדי לקבל דוגמה, אפשר לעיין במסמכים של השיטה
channels.list
. עכשיו יש שני רכיבים חדשים בדפים שמתארים שיטות API:-
הווידג'ט של APIs Explorer מאפשר לבחור היקפי הרשאות, להזין ערכים של פרמטרים ומאפיינים לדוגמה ואז לשלוח בקשות API בפועל ולראות את התגובות בפועל ל-API. הווידג'ט כולל גם תצוגת מסך מלא שמציגה דוגמאות קוד מלאות, והן מתעדכנות באופן דינמי כדי להשתמש בהיקף ובערכים שהזנת.
-
בקטע תרחישים נפוצים לדוגמה מתואר תרחיש נפוץ אחד או יותר של השיטה שמוסברת בדף. לדוגמה, אפשר להפעיל את השיטה
channels.list
כדי לאחזר נתונים על ערוץ מסוים או כדי לאחזר נתונים על הערוץ של המשתמש הנוכחי.בקטע הזה תוכלו להשתמש בקישורים כדי לאכלס ב-APIs Explorer ערכים לדוגמה בשביל התרחיש לדוגמה שלכם, או לפתוח את APIs Explorer במסך מלא כשהערכים האלה כבר מאוכלסים. מטרת השינויים האלה היא להקל עליכם לראות דוגמאות קוד הרלוונטיות באופן ישיר לתרחיש לדוגמה שאתם מנסים להטמיע באפליקציה שלכם.
דוגמאות קוד נתמכות כרגע עבור Java , JavaScript , PHP , Python ו-curl.
-
-
גם הכלי דוגמאות קוד עודכן והוספנו ממשק משתמש חדש שכולל את כל התכונות שתוארו למעלה. בעזרת הכלי הזה תוכלו לסקור תרחישים לדוגמה לשיטות שונות, לטעון ערכים ל-APIs Explorer ולפתוח את APIs Explorer במסך מלא כדי לקבל דוגמאות קוד ב-Java , JavaScript , PHP ו-Python.
במסגרת השינוי הזה, הוסרו הדפים שציינו בעבר דוגמאות קוד זמינות עבור Java , JavaScript , PHP ו-Python.
-
עודכנו המדריכים למתחילים ב-Java, JavaScript, PHP ו-Python. במדריכים המעודכנים מוסבר איך להריץ דוגמה אחת עם מפתח API ודוגמה נוספת עם מזהה לקוח של OAuth 2.0 באמצעות דוגמאות קוד מ-API Explorer.
לתשומת ליבכם: השינויים שמתוארים למעלה מחליפים כלי אינטראקטיבי שהתווסף למסמכי התיעוד בנושא API בשנת 2017.
9 ביולי 2018
העדכון הזה כולל את השינויים הבאים:
-
ההגדרה של מאפיין
snippet.thumbnails
של המשאבchannel
עודכנה כדי לציין שבעת הצגת תמונות ממוזערות באפליקציה, הקוד צריך להשתמש בכתובות ה-URL של התמונות בדיוק כפי שהן מוחזרות בתגובות API. לדוגמה, האפליקציה שלך לא יכולה להשתמש בדומייןhttp
במקום בדומייןhttps
בכתובת URL שמוחזרת בתגובת API.החל מיולי 2018, כתובות URL של תמונות ממוזערות של ערוצים יהיו זמינות רק בדומיין
https
. כלומר, כתובות ה-URL יופיעו בתגובות API. לאחר פרק הזמן הזה, אם האפליקציה תנסה לטעון תמונות ל-YouTube מהדומייןhttp
, ייתכן שיוצגו תמונות לא תקינות באפליקציה. -
הערה: זוהי הודעה על הוצאה משימוש.
המאפיין
recordingDetails.location.altitude
של המשאבvideo
הוצא משימוש. אנחנו לא מבטיחים שסרטונים יחזירו ערכים של הנכס הזה. באופן דומה, גם אם בקשות API מנסות להגדיר ערך עבור הנכס, ייתכן שהנתונים הנכנסים לא יישמרו.
22 ביוני 2018
מדריך ההטמעה, שנקרא בעבר 'המדריך להטמעה והעברה', עודכן ועכשיו הן הוסרו מ-V2 API ל-v3 API. בנוסף, הסרנו הוראות גם עבור תכונות שהוצאו משימוש מאז ב-API של גרסה 3, כמו סרטונים מועדפים.
27 בנובמבר 2017
העדכון הזה כולל את השינויים הבאים:
-
הערה: זוהי הודעה על הוצאה משימוש.
המערכת של YouTube מסירה את התמיכה בתכונות של סרטון נבחר ושל אתר מוצג, שנתמכות ב-API באמצעות אובייקט
invideoPromotion
של המשאבchannel
. כתוצאה מכך, האובייקט הזה, כולל כל מאפייני הצאצא שלו, יוצא משימוש.עדיין ניתן לאחזר ולהגדיר נתונים מסוג
invideoPromotion
עד 14 בדצמבר 2017. אחרי התאריך הזה:- ניסיונות לאחזר את החלק
invideoPromotion
במהלך הקריאה ל-channels.list
יחזירוinvideoPromotion
ריק או לא יחזירו נתוניinvideoPromotion
בכלל. - ניסיונות לעדכן את הנתונים של
invideoPromotion
בחיוג ל-channels.update
יחזירו תשובה מוצלחת עד 27 במאי 2018 לפחות. עם זאת, המערכת תתייחס אליהם כאל פעולות ללא פעולות, כלומר לא יתבצעו עדכונים בפועל.
אחרי 27 במאי 2018, ייתכן שהבקשות האלה יחזירו הודעות שגיאה כדי לציין, למשל, ש-
invalidPromotion
הוא חלק לא חוקי. - ניסיונות לאחזר את החלק
16 בנובמבר 2017
העדכון הזה כולל את השינויים הבאים:
-
כלי קטעי הקוד האינטראקטיבי תומך עכשיו בדוגמאות קוד של Node.js. הדוגמאות מופיעות גם במסמכי התיעוד של כמעט כל שיטות ה-API, כמו השיטה
channels.list
.הדוגמאות הניתנות להתאמה אישית נועדו לספק נקודת התחלה ספציפית לתרחיש לדוגמה עבור יישום Node.js. הפונקציונליות דומה לקוד שמופיע במדריך למתחילים של Node.js. עם זאת, הדוגמאות כן מכילות כמה פונקציות שימושיות שלא מופיעות במדריך למתחילים:
- הפונקציה
removeEmptyParameters
מקבלת רשימה של צמדי מפתח/ערך שתואמים לפרמטרים של בקשות ל-API, ומסירה את הפרמטרים שאין להם ערכים. - הפונקציה
createResource
מתייחסת לרשימה של צמדי מפתח/ערך שתואמים לנכסים במשאב API. לאחר מכן היא ממירה את המאפיינים לאובייקט JSON, שניתן להשתמש בו בפעולותinsert
ו-update
. בדוגמה הבאה מוצגת קבוצה של שמות וערכים של מאפיינים ואת אובייקט ה-JSON שהקוד יוצר עבורם:# Key-value pairs: {'id': 'ABC123', 'snippet.title': 'Resource title', 'snippet.description': 'Resource description', 'status.privacyStatus': 'private'} # JSON object: { 'id': 'ABC123', 'snippet': { 'title': 'Resource title', 'description': 'Resource description', }, 'status': { 'privacyStatus': 'private' } }
כל הדוגמאות האלה נועדו להורדה ולהפעלה באופן מקומי. למידע נוסף, אפשר לעיין בדרישות המוקדמות להרצת דוגמאות קוד מלאות באופן מקומי שבהוראות לכלי קטע הקוד.
- הפונקציה
25 באוקטובר 2017
העדכון הזה כולל את השינויים הבאים:
-
דוגמאות הקוד של Python בכלי קטעי הקוד האינטראקטיבי עודכנו כך שישתמשו בספריות
google-auth
ו-google-auth-oauthlib
במקום בספרייתoauth2client
, שהוצאה משימוש.בנוסף לשינוי הזה, הכלי מספק עכשיו דוגמאות קוד מלאות לאפליקציות Python מותקנות ואפליקציות של שרת האינטרנט של Python, שמשתמשות בתהליכי הרשאה שונים במקצת. כדי לראות את הדוגמאות המלאות (והשינוי הזה):
- נכנסים אל כלי קטעי הקוד האינטראקטיבי או נכנסים למסמכי התיעוד של שיטת API כלשהי, כמו השיטה
channels.list
. - לוחצים על הכרטיסייה
Python
מעל דוגמאות הקוד. - אפשר ללחוץ על המתג שמעל הכרטיסיות כדי לעבור מהצגת קטע טקסט לדגימה מלאה.
- עכשיו הכרטיסייה אמורה להציג דוגמת קוד מלאה שמשתמשת בתהליך ההרשאה של
InstalledAppFlow
. התיאור שמעל הדוגמה מסביר זאת והוא גם מקשר לדוגמה של אפליקציית שרת אינטרנט. - צריך ללחוץ על הקישור כדי לעבור לדוגמה של שרת האינטרנט. הדוגמה הזו משתמשת ב-framework של אפליקציית האינטרנט של Flask ובתהליך הרשאה שונה.
כל הדוגמאות האלה נועדו להורדה ולהפעלה באופן מקומי. אם אתם רוצים להריץ את הדוגמאות, עיינו בהוראות להרצה של דוגמאות קוד מלאות באופן מקומי בהוראות לכלי קטע הקוד.
- נכנסים אל כלי קטעי הקוד האינטראקטיבי או נכנסים למסמכי התיעוד של שיטת API כלשהי, כמו השיטה
29 באוגוסט 2017
העדכון הזה כולל את השינויים הבאים:
- ההגדרה של הפרמטר
forContentOwner
בשיטהsearch.list
עודכנה, ועכשיו אם הפרמטר מוגדר לערךtrue
, חובה להגדיר את הפרמטרtype
לערךvideo
. - ההגדרה של הפרמטר
regionCode
של שיטתsearch.list
עודכנה כדי להבהיר שהפרמטר מגביל את תוצאות החיפוש לסרטונים שניתן לצפות בהם באזור שצוין. - סמלי הלוגו והסמלים של המיתוג של YouTube עודכנו. אפשר להוריד סמלי לוגו חדשים בפורמט "שפותח עם YouTube" מהדף הנחיות מיתוג. בדף הזה מוצגים גם סמלי לוגו וסמלים חדשים אחרים של YouTube, וניתן להוריד אותם מאתר המותג של YouTube.
24 ביולי 2017
העדכון הזה כולל את השינויים הבאים:
- מדריך למתחילים חדש של YouTube Data API זמין ל-iOS. המדריך מסביר כיצד להשתמש ב-YouTube Data API באפליקציית iOS פשוטה שכתובה ב-Objective-C או ב-Swift.
- כלי קטע הקוד האינטראקטיבי של YouTube Data API כולל עכשיו מסמכים שמסבירים כמה מתכונות הכלי:
- ביצוע בקשות API
- החלפה בין קטעי קוד לדוגמאות קוד מלאות
- שימוש בפונקציות סטנדרטיות
- טעינת משאבים קיימים (לשיטות עדכון)
הערה: הכלי גם מוטמע בתיעוד של הפניית API לשיטות API (דוגמה).
1 ביוני 2017
העדכון הזה כולל את השינויים הבאים:
-
הערה: זוהי הודעה על הוצאה משימוש.
אנחנו מוציאים משימוש את נכסי המשאבים הבאים של
video
. התמיכה בנכסים תימשך עד 1 בדצמבר 2017, אבל אי אפשר להבטיח שסרטונים ימשיכו להחזיר ערכים לנכסים האלה עד לתאריך הזה. באופן דומה, בקשות שלvideos.insert
ו-videos.update
שמגדירות את ערכי המאפיינים האלה לא יגרמו לשגיאות לפני התאריך הזה, אבל יכול להיות שהנתונים הנכנסים לא יישמרו.
17 במאי 2017
העדכון הזה כולל את השינויים הבאים:
-
תיעוד הפניית ה-API עודכן כדי להפוך את קטעי הקוד להיות נפוצים ואינטראקטיביים יותר. דפים עם הסברים על שיטות API, כמו
channels.list
אוvideos.rate
, כוללים עכשיו כלי אינטראקטיבי שמאפשר להציג קטעי קוד ולהתאים אותם אישית ב-Java , JavaScript , PHP , Python , Ruby , Apps Script ו-Go.לכל שיטה נתונה, הכלי מציג קטעי קוד של תרחיש שימוש אחד או יותר, וכל תרחיש לדוגמה מתאר דרך מקובלת לקרוא לשיטה הזו. לדוגמה, אתם יכולים לקרוא לשיטה
channels.list
כדי לאחזר נתונים על ערוץ מסוים או על הערוץ של המשתמש הנוכחי.אפשר גם לבצע פעולות עם דוגמאות הקוד:
-
משנים את ערכי הפרמטרים והמאפיינים, וקטעי הקוד מתעדכנים באופן דינמי כדי לשקף את הערכים שאתם מספקים.
-
מעבר בין קטעי קוד לדוגמאות מלאות. קטע קוד מציג את החלק בקוד שמבצע קריאה לשיטת ה-API. דוגמה מלאה מכילה את קטע הקוד הזה וגם קוד סטנדרטי לאישור ולשליחה של בקשות. אפשר להעתיק ולהריץ דוגמאות מלאות משורת הפקודה או משרת אינטרנט מקומי.
-
בצע בקשות על ידי לחיצה על לחצן. (כדי להוציא לפועל בקשות, צריך לתת לכלי הרשאה לקרוא ל-API בשמכם).
לתשומת ליבכם: הכלי הזה החליף את APIs Explorer בדפים שבהם הוא זמין. (בכל דף מוצג קישור, כדי שתהיה לכם גם אפשרות לטעון את הבקשה שאתם עובדים עליה ב-APIs Explorer).
-
-
גם הכלי קטעי קוד ב-Data API עודכן בממשק משתמש חדש שכולל את כל התכונות שתוארו למעלה. התכונות החדשות העיקריות הזמינות בדף זה הן:
- תמיכה בבקשות API שכותבות נתונים.
- תמיכה בדוגמאות Java.
- קוד סטנדרטי וגמיש ומקיף יותר לאישור משתמשים וליצירת בקשות API.
27 באפריל 2017
העדכון הזה כולל את השינויים הבאים:
- במדריכים החדשים למתחילים מוסבר איך להגדיר אפליקציה פשוטה ששולחת בקשות ל-YouTube Data API. המדריכים זמינים כרגע ב-Android, ב-Apps Script, ב-Go, ב-Java, ב-JavaScript, ב-Node.js, ב-PHP, ב-Python וב-Ruby.
30 במרץ 2017
העדכון הזה כולל את השינויים הבאים:
- המאפיין החדש
topicDetails.topicCategories[]
של המשאבchannel
מכיל רשימה של כתובות URL של ויקיפדיה שמתארות את תוכן הערוץ. כתובות ה-URL תואמות למזהי הנושאים שהוחזרו בנכסtopicDetails.topicIds[]
של המשאב. - המאפיין החדש
contentDetails.videoPublishedAt
של המשאבplaylistItem
מזהה את השעה שבה הסרטון פורסם ב-YouTube. המשאב כבר מכיל את המאפייןsnippet.publishedAt
, שמזהה את הזמן שבו הפריט נוסף לפלייליסט. - בדומה למשאב
channel
, המשאבvideo
מחזיר עכשיו את המאפייןtopicDetails.topicCategories[]
, שמכיל רשימה של כתובות URL של ויקיפדיה שמתארות את תוכן הסרטון. שלvideo
משאבים, כתובות ה-URL תואמות למזהי הנושאים שהוחזרו בנכסtopicDetails.relevantTopicIds[]
של המשאב. - המאפיין החדש
contentDetails.contentRating.mpaatRating
של המשאבvideo
מזהה את הדירוג שנתן Motion Picture Association of America לטריילר או לתצוגה מקדימה של סרט.
27 בפברואר 2017
כפי שהודענו במקור ב-11 באוגוסט 2016, מערכת YouTube החליפה את הרשימה הנתמכת של מזהי נושאים לרשימה קיימת. הרשימה המלאה של מזהי הנושאים הנתמכים כלולה בנכסי topicDetails
של המשאבים channel
ו-video
, וגם בפרמטר topicId
של שיטת search.list
.
לתשומת ליבכם: יש כמה שינויים ברשימה שנאספה:
- הנושאים הבאים נוספו כנושאי משנה של
Society
:שם מזהה נושא העסק /m/09s1f
בריאות /m/0kt51
צבא /m/01h6rj
פוליטיקה /m/05qt0
דת /m/06bvp
- הנושא
Animated cartoon
, שהיה בעבר צאצא שלEntertainment
, הוסר. - הנושא
Children's music
, שהיה בעבר צאצא שלMusic
, הוסר.
כתוצאה מהשינוי הזה, נושאים שקשורים לסרטון תמיד מוחזרים עכשיו בערך המאפיין topicDetails.relevantTopicIds[]
של המשאב video
.
29 בנובמבר 2016
העדכון הזה כולל את השינויים הבאים:
-
החל מ-10 בפברואר 2017 נתמוך בשלושה שינויים קטנים ברשימת מזהי הנושאים:
- הקטגוריה
Professional wrestling
, שהייתה בעבר צאצא של הקטגוריהSports
, היא עכשיו קטגוריית צאצא שלEntertainment
. - הקטגוריה
TV shows
, שהיא צאצא שלEntertainment
, היא חדשה. - הקטגוריה
Health
, שהייתה בעבר צאצא שלLifestyle
, הוסרה.
חשוב גם לשים לב שיש כמה קטגוריות הורה (
Entertainment
,Gaming
,Lifestyle
,Music
ו-Sports
). כל סרטון שמשויך לקטגוריית צאצא, כמוTennis
, ישויך גם לקטגוריית ההורה (Sports
). - הקטגוריה
10 בנובמבר 2016
העדכון הזה כולל את השינויים הבאים:
-
כפי שהודענו לראשונה ב-11 באוגוסט 2016, ההוצאה של Freebase ו-Freebase API מחייבת שימוש במספר שינויים שקשורים למזהי נושאים. מזהי נושאים מזהים נושאים המשויכים למשאבים
channel
ו-video
, ואפשר גם להשתמש בפרמטר החיפושtopicId
כדי למצוא ערוצים או סרטונים הקשורים לנושא מסוים.ב-10 בפברואר 2017, המערכת של YouTube תתחיל להחזיר קבוצה קטנה של מזהי נושאים במקום את הקבוצה הרבה יותר מפורטת של המזהים שהוחזרו עד כה. בנוסף, חשוב לזכור שלא בטוח שערוצים וסרטונים ישויכו לנושאים כלשהם, בהתאם להתנהגות הנוכחית של ה-API.
כדי שתוכלו להכין את לקוחות ה-API שלכם לשינויים האלה, ההגדרות של הפרמטרים והמאפיינים הבאים של ה-API עודכנו. ההגדרות של הפרמטרים והמאפיינים הבאים של ה-API עודכנו ומפורטות בהם מזהי הנושאים שתהיה תמיכה בהם אחרי התקופה הזו. שימו לב שרשימת הקטגוריות זהה בכל הנכסים.
- המאפיין
topicDetails.topicIds[]
של המשאבchannel
. - המאפיין
topicDetails.relevantTopicIds[]
של המשאבvideo
. - הפרמטר
topicId
של השיטהsearch.list
.
- המאפיין
-
הערה: זוהי הודעה על הוצאה משימוש.
המאפיינים הבאים עומדים לצאת משימוש:
- המאפיין
topicDetails.topicIds[]
של המשאבchannel
. תמיכה בנכס הזה עד 10 בנובמבר 2017. - המאפיין
topicDetails.relevantTopicIds[]
של המשאבvideo
. תמיכה בנכס הזה עד 10 בנובמבר 2017. - המאפיין
topicDetails.topicIds[]
של המשאבvideo
. הנכס הזה לא יכלול ערכים אחרי 10 בפברואר 2017. (אחרי התאריך הזה, ערך המאפייןtopicDetails.relevantTopicIds[]
יזהה את כל הנושאים המשויכים לסרטון.)
- המאפיין
-
מכיוון ש-Freebase כבר הוצא משימוש, המדריך Searching with Freebase Topics הוסר מהתיעוד. המדריך כלל דוגמאות קוד שהראו איך אפליקציה תפעל עם ממשק ה-API של Freebase.
בנוסף, מספר דוגמאות קוד הקשורות למזהי נושאים הוסרו מהתיעוד של השיטה
search.list
.
2 בנובמבר 2016
העדכון הזה כולל את השינויים הבאים:
-
מאפיינים ופרמטרים חדשים
-
המשאב
video
מכיל מספר מאפיינים חדשים:-
המאפיין
player.embedHtml
מכיל תג<iframe>
שניתן להשתמש בו כדי להטמיע נגן שמפעיל את הסרטון. המאפיינים החדשיםplayer.embedHeight
ו-player.embedWidth
מזהים את המידות של הנגן המוטמע. המאפיינים האלה מוחזרים רק אם בקשת ה-API מציינת ערך לפחות באחד מהפרמטריםmaxHeight
אוmaxWidth
. שני הפרמטרים החדשים האלה מוסברים בהמשך רשומה זו בהיסטוריית גרסאות. -
המאפיין החדש
hasCustomThumbnail
מציין אם מעלה הסרטון סיפק תמונה ממוזערת מותאמת אישית לסרטון. שימו לב שהנכס הזה גלוי רק למעלה הסרטון. -
fpbRatingReasons[]
החדש מציין סיבות לכך שהסרטון קיבל את סיווג FPB (דרום אפריקה). -
התג החדש
mcstRating
מציין את הדירוג שהסרטון קיבל בווייטנאם.
-
-
השיטה
videos.list
תומכת בשני פרמטרים חדשים,maxHeight
ו-maxWidth
. אפשר להשתמש בכל אחד מהפרמטרים או בשניהם כדי לאחזר את החלקplayer
במשאביvideo
.כברירת מחדל, הגובה של
<iframe>
שמוחזר במאפייןplayer.embedHtml
הוא 360 פיקסלים. הרוחב מותאם ליחס הגובה-רוחב של הסרטון, וכך להבטיח שלא יהיו בנגן המוטמע פסים שחורים בתוך המסגרת של הסרטון. לדוגמה, אם יחס הגובה-רוחב של הסרטון הוא 16:9, רוחב הנגן יהיה 640 פיקסלים.באמצעות הפרמטרים החדשים, תוכל לציין שבמקום את מאפייני ברירת המחדל, קוד ההטמעה צריך להשתמש בגובה ו/או ברוחב המתאימים לפריסת האפליקציה שלך. שרת ה-API משנה את מידות הנגן בהתאם לצורך, כדי להבטיח שבנגן המוטמע לא יהיו פסים שחורים שמשמשים כמסגרת לסרטון. שימו לב ששני הפרמטרים מציינים את המידות המקסימליות של הנגן המוטמע. לכן, אם שני הפרמטרים צוינו, יכול להיות שמאפיין אחד יהיה קטן מהסכום המקסימלי המותר למאפיין הזה.
לדוגמה, נניח שיחס הגובה-רוחב של סרטון הוא 16:9. לכן, התג
player.embedHtml
יכיל נגן בגודל 640x360 אם לא מגדירים את הפרמטרmaxHeight
אוmaxWidth
.- אם הפרמטר
maxHeight
מוגדר לערך720
, והפרמטרmaxWidth
לא מוגדר, ה-API יחזיר נגן בגודל 1280x720. - אם הפרמטר
maxWidth
מוגדר לערך960
, והפרמטרmaxHeight
לא מוגדר, ה-API יחזיר נגן בגודל 960x540. - אם הפרמטר
maxWidth
מוגדר לערך960
והפרמטרmaxHeight
מוגדר ל-450
, ה-API יחזיר נגן בגודל 800x450.
המאפיינים החדשים של
player.embedHeight
ו-player.embedWidth
, שמתוארים למעלה, מזהים את המידות של הנגן. - אם הפרמטר
-
-
עדכונים של שיטות, מאפיינים ופרמטרים קיימים
-
תיאור המשאב
channelSection
עודכן כדי לדעת שערוץ יכול ליצור עד 10 מדפים בלי להגדיר נתוני טירגוט, ויכול ליצור עד 100 מדפים עם נתוני טירגוט.כמו כן, המאפיין
targeting
של המשאבchannelSection
עודכן כדי לשקף את העובדה שאפשר להגדיר אפשרויות טירגוט רק באמצעות ה-API. אפשרויות הטירגוט נמחקות אם משנים את קטע הערוץ באמצעות ממשק המשתמש באתר של YouTube. -
ההגדרה של המאפיין
snippet.name
של המשאבi18nLanguage
תוקנה כך שהערך מייצג שם של שפה, כפי שהוא כתוב בשפה שצוינה בפרמטרhl
של השיטהi18nLanguage.list
. -
המאפיין
contentDetails.note
של המשאבplaylistItem
עודכן, ועכשיו האורך המקסימלי של הערך הוא 280 תווים. -
המאפיינים
contentDetails.startAt
ו-contentDetails.endAt
של המשאבplaylistItem
הוצאו משימוש. המערכת מתעלמת מהשדות האלה אם הם מוגדרים בבקשותplaylistItems.insert
אוplaylistItems.update
. -
השיטות
playlistItems.delete
ו-playlistItems.update
תומכות עכשיו בפרמטרonBehalfOfContentOwner
, שכבר נתמך בכמה שיטות נוספות. גם בקשות שמשתמשות בשיטה הזו צריכות לקבל הרשאה באמצעות אסימון שמספק גישה להיקףhttps://www.googleapis.com/auth/youtubepartner
. -
הפרמטרים
publishedBefore
ו-publishedAfter
של השיטהsearch.list
עודכנו כדי לציין שערכי הפרמטרים כוללים. לדוגמה, אם הפרמטרpublishedBefore
מוגדר, ה-API מחזיר משאבים שנוצרו לפני או בזמן שצוין. -
המאפיין
contentDetails.contentRating.grfilmRating
של המשאבvideo
תומך בשלושה ערכים נוספים:grfilmK12
,grfilmK15
ו-grfilmK18
. -
תיאור השיטה
videos.insert
עודכן כדי לראות שגודל הקובץ המקסימלי של סרטונים שהועלו עלה מ-64GB ל-128GB.
-
-
שגיאות חדשות ומעודכנות
-
ה-API תומך בשגיאות החדשות הבאות:
סוג השגיאה פרטי השגיאה תיאור forbidden (403)
homeParameterDeprecated
השיטה activities.list
מחזירה את השגיאה הזו כדי לציין שנתוני הפעילות בדף הבית של המשתמש לא זמינים דרך ה-API הזה. השגיאה הזו יכולה להתרחש אם מגדירים את הפרמטרhome
לערךtrue
במסגרת בקשה לא מורשית.invalidValue (400)
invalidContentDetails
השיטה playlistItems.insert
מחזירה את השגיאה הזו כדי לציין שהאובייקטcontentDetails
בבקשה לא חוקי. אחת הסיבות לשגיאה הזו היא שהשדהcontentDetails.note
מכיל יותר מ-280 תווים.forbidden (403)
watchHistoryNotAccessible
השיטה playlistItems.list
מחזירה את השגיאה הזו כדי לציין שהבקשה ניסתה לאחזר את פריטי הפלייליסט 'היסטוריית צפייה', אבל לא ניתן לאחזר אותם באמצעות ה-API.forbidden (403)
watchLaterNotAccessible
השיטה playlistItems.list
מחזירה את השגיאה הזו כדי לציין שהבקשה ניסתה לאחזר את הפריטים בפלייליסט 'לצפייה בהמשך', אבל לא ניתן לאחזר אותם באמצעות ה-API.badRequest (400)
uploadLimitExceeded
השיטה videos.insert
מחזירה את השגיאה הזו כדי לציין שהערוץ חרג ממספר הסרטונים שהוא יכול להעלות.forbidden (403)
forbiddenEmbedSetting
השיטה videos.update
מחזירה את השגיאה הזו כדי לציין שבקשת ה-API מנסה לקבוע הגדרת הטמעה לא חוקית לסרטון. שימו לב: ייתכן שלערוצים מסוימים אין הרשאה להציע נגנים מוטמעים לשידורים חיים. מידע נוסף זמין במרכז העזרה של YouTube. -
השיטה
playlistItems.insert
כבר לא מחזירה הודעת שגיאה אם תוסיפו סרטון כפול לפלייליסט. השגיאה הזו אירעה בעבר בפלייליסטים מסוימים, למשל סרטונים מועדפים, שלא אפשרו כפילויות אבל אינם נתמכים יותר. בדרך כלל, פלייליסטים מאפשרים העלאה של סרטונים כפולים.
-
-
עדכונים נוספים
-
הרשומה בהיסטוריית הגרסאות ל-15 בספטמבר 2016 עודכנה, ומבהירה שבכל פעם שמאפייני
contentDetails.relatedPlaylists.watchHistory
ו-contentDetails.relatedPlaylists.watchLater
של המשאבchannel
נכללים בתגובה, הם תמיד מכילים את הערכיםHL
ו-WL
, בהתאמה. בנוסף, המאפיינים האלה נכללים רק אם משתמש מורשה מאחזר נתונים לגבי הערוץ של המשתמש עצמו.
-
15 בספטמבר 2016
העדכון הזה כולל את השינויים הבאים:
-
בעדכון של היסטוריית הגרסאות ב-11 באוגוסט 2016 נדון במספר שינויים הקשורים למזהי נושאים, כולל העובדה ש ב-10 בפברואר 2017 תשתנה קבוצת מזהי הנושאים הנתמכים. רשימת הנושאים שנתמכים תפורסם עד 10 בנובמבר 2016.
-
השינויים הבאים נכנסו לתוקף. הודעה על השינויים האלה נמסרה בעדכון של היסטוריית הגרסאות ב-11 באוגוסט 2016:
-
אם מפעילים את השיטה
activities.list
והפרמטרhome
מוגדר ל-true
, תגובת ה-API מכילה עכשיו פריטים שדומים לאלה שיראה משתמש YouTube שמתנתק בדף הבית.זהו שינוי קטן שנועד לספק חוויית משתמש טובה יותר מההתנהגות שמתוארת בעדכון היסטוריית הגרסאות ב-11 באוגוסט 2016. בעדכון הזה צוין שבקשות שמשתמשות בפרמטר
home
יחזירו רשימה ריקה. -
המאפיינים
contentDetails.relatedPlaylists.watchHistory
ו-contentDetails.relatedPlaylists.watchLater
של המשאבchannel
מכילים עכשיו את הערכיםHL
ו-WL
, בהתאמה, לכל הערוצים.חשוב להבהיר: המאפיינים האלה גלויים רק למשתמש מורשה שמאחזר נתונים לגבי הערוץ של המשתמש. המאפיינים תמיד מכילים את הערכים
HL
ו-WL
, גם אם משתמש מורשה מאחזר נתונים לגבי הערוץ של המשתמש. לכן, לא ניתן לאחזר באמצעות ה-API את היסטוריית הצפייה ואת מזהי הפלייליסטים של 'צפייה בהמשך'.בנוסף, בקשות לאחזור פרטי פלייליסט (
playlists.list
) או פריטים בפלייליסט (playlistItems.list
) להיסטוריית הצפייה של הערוץ או לפלייליסט 'לצפייה בהמשך' יחזירו עכשיו רשימות ריקות. ההתנהגות הזו רלוונטית לערכים החדשים,HL
ו-WL
, וגם לכל מזהה של פלייליסטים בהיסטוריית הצפייה או לצפייה מאוחרת יותר, שייתכן שלקוח ה-API שלך כבר אחסן.
-
-
האובייקט
fileDetails.recordingLocation
של המשאבvideo
ומאפייני הצאצא שלו לא מוחזרים יותר. בעבר, רק הבעלים של הסרטון יכלו לאחזר את הנתונים האלה (כמו אובייקט ההורהfileDetails
).
11 באוגוסט 2016
העדכון הזה כולל את השינויים הבאים:
-
התנאים וההגבלות החדשים של שירותי YouTube API ("התנאים המעודכנים"), המפורטים בבלוג ההנדסה והמפתחים של YouTube, מספקים מגוון עשיר של עדכונים לתנאים ולהגבלות הנוכחיים. בנוסף לתנאים המעודכנים, שייכנסו לתוקף ב-10 בפברואר 2017, העדכון כולל כמה מסמכים תומכים שיעזרו להסביר את המדיניות שהמפתחים צריכים לציית לה.
הקבוצה המלאה של המסמכים החדשים מתוארת בהיסטוריית הגרסאות של התנאים המעודכנים. בנוסף, שינויים עתידיים בתנאים המעודכנים או במסמכים תומכים יוסברו גם הם בהיסטוריית הגרסאות. ניתן להירשם לעדכון RSS שבו מופיעים שינויים בהיסטוריית הגרסאות דרך קישור במסמך הזה.
-
ההוצאה משימוש של Freebase ו-Freebase API גורמת לכמה שינויים שקשורים למזהי הנושאים. מזהי הנושאים משמשים במשאבים ובשיטות הבאים של ה-API:
- החלק
topicDetails
של המשאבchannel
מזהה את הנושאים שמשויכים לערוץ. - החלק
topicDetails
של המשאבvideo
מזהה את הנושאים המשויכים לסרטון. - הפרמטר
topicId
של השיטהsearch.list
מאפשר לחפש סרטונים או ערוצים שקשורים לנושא מסוים.
השינויים בתכונות אלו הם:
-
החל מ-10 בפברואר 2017, המערכת של YouTube תתחיל להחזיר קבוצה קטנה של מזהי נושאים במקום את הקבוצה הרבה יותר מפורטת של המזהים שהוחזרו עד כה. קבוצת הנושאים הנתמכים תזהה קטגוריות ברמה גבוהה כמו ספורט או כדורסל, אבל לדוגמה, הן לא יזהו קבוצות או שחקנים ספציפיים. אנחנו נודיע על רשימת הנושאים הנתמכים כדי שיהיה לכם זמן להכין את הבקשה שלכם לשינוי הזה.
-
כל מזהי הנושאים של Freebase שכבר אחזרת יוכלו לשמש לחיפוש תוכן עד 10 בפברואר 2017. עם זאת, לאחר מכן, תוכלו להשתמש רק בקבוצה הקטנה יותר של הנושאים שזוהו בפריט הקודם כדי לאחזר תוצאות חיפוש לפי נושא.
-
אחרי 10 בפברואר 2017, אם תנסו לחפש תוצאות באמצעות מזהה נושא שלא נכלל בקבוצה הקטנה יותר של מזהי נושאים נתמכים, ה-API יחזיר קבוצת תוצאות ריקה.
- החלק
-
ב-12 בספטמבר 2016 נוציא משימוש כמה שדות ופרמטרים ב-API:
-
הפרמטר
home
של השיטהactivities.list
אפשר למשתמש מורשה לאחזר את פיד הפעילות שיוצג בדף הבית של YouTube עבור המשתמש הזה. בקשות שמשתמשות בפרמטר הזה אחרי 12 בספטמבר 2016 יחזירו רשימה ריקה. -
המאפיינים
contentDetails.relatedPlaylists.watchHistory
ו-contentDetails.relatedPlaylists.watchLater
של המשאבchannel
גלויים רק למשתמש מורשה שמאחזר נתונים לגבי הערוץ של המשתמש. אחרי 12 בספטמבר 2016,contentDetails.relatedPlaylists.watchHistory
יחזיר את הערךHL
והמאפייןcontentDetails.relatedPlaylists.watchLater
יחזיר ערך שלWL
לכל הערוצים.בקשות לאחזור פרטי פלייליסט (
playlists.list
) להיסטוריית הצפייה של ערוץ או לפלייליסט 'לצפייה בהמשך' יחזירו רשימה ריקה אחרי 12 בספטמבר 2016. בקשות לאחזור פריטים בפלייליסט (playlistItems.list
) בכל אחד מהפלייליסטים האלה יחזירו גם רשימה ריקה לאחר פרק הזמן הזה. הדבר נכון גם לגבי הערכים החדשים,HL
ו-WL
, וגם לגבי כל מזהה של פלייליסטים בהיסטוריית הצפייה או לצפייה במועד מאוחר יותר שייתכן שלקוח ה-API שלך כבר אחסן. -
האובייקט
fileDetails.recordingLocation
של המשאבvideo
, או כל מאפייני הצאצא שלו, לא יוחזרו אחרי 12 בספטמבר 2016. רק הבעלים של הסרטון יכולים לאחזר את הנתונים האלה, כי אובייקט ההורהfileDetails
יכול לאחזר את הנתונים רק על ידי בעלי הסרטון.
-
13 ביוני 2016
העדכון הזה כולל את השינויים הבאים:
-
המאפיין
contentDetails.googlePlusUserId
של המשאבchannel
הוצא משימוש. בעבר, הנכס היה קיים רק אם הערוץ היה משויך לפרופיל Google+. לאחר ההוצאה משימוש, הנכס לא ייכלל יותר באף אחד מהמשאבים שלchannel
. -
המאפיין
snippet.authorGoogleplusProfileUrl
של המשאבcomment
הוצא משימוש. בעבר, הנכס היה קיים רק אם הערוץ היה משויך לפרופיל Google+. לאחר ההוצאה משימוש, הנכס לא ייכלל יותר באף אחד מהמשאבים שלcomment
.
מאחר שאף אחד מהנכסים האלה לא יוחזר לאחר ההוצאה משימוש, שני הנכסים הוסרו מתיעוד המשאבים המתאים.
31 במאי 2016
העדכון הזה כולל את השינויים הבאים:
-
הפרמטר
myRecentSubscribers
החדש של השיטהsubscriptions.list
מאחזר רשימה של המנויים לערוץ של המשתמש המאומת בסדר כרונולוגי הפוך של הזמן שבו הם נרשמו לערוץ.שימו לב שהפרמטר החדש תומך רק באחזור של 1,000 המנויים האחרונים לערוץ של המשתמש המאומת. כדי לאחזר רשימה מלאה של מנויים, צריך להשתמש בפרמטר
mySubscribers
. הפרמטר הזה, שלא מחזיר מנויים בסדר מסוים, לא מגביל את מספר המנויים שאפשר לאחזר. -
ההגדרה של המאפיין
snippet.thumbnails.(key)
עודכנה עבור המשאבים הבאים: פעילות, playlistItem, פלייליסט, תוצאת חיפוש, תמונה ממוזערת וסרטון – חשוב לציין שאפשר לקבל גדלים נוספים של תמונות ממוזערות בסרטונים מסוימים.- התמונה של
standard
היא ברוחב 640 פיקסלים ובגובה של 480 פיקסלים. - רוחב התמונה של
maxres
הוא 1280 פיקסלים, וגובהה הוא 720 פיקסלים.
- התמונה של
-
ההגדרה של הפרמטר
part
בשיטהchannelSection.list
עודכנה, ועכשיו ניתן לאחזר את החלקtargeting
בעלות של2
יחידות מכסה. -
השיטה
videos.list
מחזירה עכשיו שגיאה אסורה (403
) כשבקשה שלא אושרה כראוי מנסה לאחזר את החלקיםfileDetails
,processingDetails
אוsuggestions
של משאבvideo
. החלקים האלה זמינים רק לבעלים של הסרטון.
17 במאי 2016
הכלי החדש קטעי קוד ב-Data API מספק קטעי קוד קצרים לתרחישי שימוש נפוצים ב-YouTube Data API. קטעי הקוד זמינים כרגע לכל שיטות ה-API לקריאה בלבד ב-Apps Script, ב-Go, ב-JavaScript, ב-PHP, ב-Python וב-Ruby.
עבור כל שיטה, הכלי מציג דוגמאות קוד של תרחיש שימוש אחד או יותר. לדוגמה, הוא מספק חמישה קטעי קוד עבור השיטה search.list
:
- רשימה של סרטונים לפי מילת מפתח
- הצגת רשימה של סרטונים לפי מיקום
- הצגת רשימה של אירועים בשידור חי
- חיפוש סרטונים של המשתמש המאומת
- רשימה של סרטונים קשורים
לכל תרחיש לדוגמה, הכלי מציג את הפרמטרים שנעשה בהם שימוש בבקשת ה-API. תוכלו לשנות את ערכי הפרמטרים, ובמקרה כזה הכלי יעדכן את קטעי הקוד כך שישקפו את ערכי הפרמטרים שציינתם.
לבסוף, הכלי מציג את תגובת ה-API לכל בקשה. אם שיניתם את הפרמטרים של הבקשה, תגובת ה-API תתבסס על ערכי הפרמטרים שסיפקתם. לתשומת ליבכם, אתם צריכים לאשר לכלי לשלוח בקשות בשמכם כדי שתשובות ה-API יוצגו.
28 באפריל 2016
העדכון הזה כולל את השינויים הבאים:
-
המאפיין
contentDetails.projection
החדש של המשאבvideo
מציין את פורמט ההקרנה של הסרטון. ערכי הנכס החוקיים הם360
ו-rectangular
. -
המאפיינים
recordingDetails.location
ו-fileDetails.recordingLocation
של המשאבvideo
עודכנו כדי להסביר את ההבדל בין שני המאפיינים:- הנכס
recordingDetails.location
מזהה את המיקום שבעלי הסרטון רוצים לשייך לסרטון. ניתן לערוך את המיקום הזה, לחפש אותו בסרטונים ציבוריים, וייתכן שהוא יוצג למשתמשים בסרטונים ציבוריים. - ערך המאפיין
fileDetails.recordingLocation
לא ניתן לשינוי ומייצג את המיקום המשויך לקובץ הסרטון המקורי שהועלה. רק הבעלים של הסרטון יכולים לראות את הערך הזה.
- הנכס
-
ההגדרה של המאפיין
contentDetails.relatedPlaylists.favorites
של המשאבchannel
עודכנה, ועכשיו אפשר לאחזר אותו: ערך המאפיין עשוי להכיל מזהה פלייליסט שמפנה לפלייליסט ריק. הסיבה לכך היא שהפונקציונליות של הסרטונים המועדפים כבר הוצאה משימוש. שימו לב שהנכס הזה לא כפוף למדיניות בנושא הוצאה משימוש של API. -
ההגדרה של השגיאה
ineligibleAccount
, שניתן להחזיר באמצעות השיטהcomments.insert
,comments.update
,commentThreads.insert
אוcommentThreads.update
, עודכנה ומשקף את השגיאה כאשר חשבון YouTube המשמש לאישור בקשת ה-API לא מוזג עם חשבון Google של המשתמש.
20 באפריל 2016
העדכון הזה כולל את השינויים הבאים:
-
הגדרת הפרמטר
part
של השיטהchannels.update
עודכנה, ועכשיו הערךlocalizations
הוא ערך חוקי לפרמטר הזה. -
הקטע Quota Usage במדריך לתחילת העבודה, עודכן כך שיהיה לכם קישור ל-Google Developer Console, שם תוכלו לראות את המכסה שלכם בפועל ואת השימוש במכסות.
16 במרץ 2016
העדכון הזה כולל את השינויים הבאים:
-
עדכונים של שיטות ומשאבים קיימים
-
תיעוד המשאבים של
channelBanner
עודכן, ועכשיו הגודל המומלץ לתמונת הבאנר של הערוץ הוא 2,560 פיקסלים על 1,440 פיקסלים. הגודל המינימלי (2048 על 1152 פיקסלים) לא השתנה. -
המאפיין החדש
snippet.customUrl
של המשאבchannel
מזהה את כתובת ה-URL המותאמת אישית שמשויכת לערוץ. (לא לכל הערוצים יש כתובות URL מותאמות אישית). במרכז העזרה של YouTube יש הסבר על דרישות הסף לקבלת כתובת URL מותאמת אישית והסבר על הגדרת כתובת ה-URL. -
האובייקט
brandingSettings.watch
של המשאבchannel
וכל מאפייני הצאצא שלו הוצאו משימוש. -
תגובת ה-API לבקשת
search.list
כוללת עכשיו את הנכסregionCode
. הנכס מזהה את קוד האזור ששימש לשאילתת החיפוש. קוד האזור מורה ל-API להחזיר תוצאות חיפוש עבור המדינה שצוינה.ערך המאפיין הוא קוד מדינה בן שתי אותיות לפי תקן ISO, שמזהה את האזור. השיטה
i18nRegions.list
מחזירה רשימה של אזורים נתמכים. ערך ברירת המחדל הואUS
. אם יצוין אזור שאינו נתמך, המערכת של YouTube עדיין עשויה לבחור אזור אחר, במקום ערך ברירת המחדל, לטיפול בשאילתה. -
ההגדרות של המאפיינים
snippet.label
ו-snippet.secondaryReasons[].label
של המשאבvideoAbuseReportReason
עודכנו כדי לראות שהמאפיינים מכילים טקסט של תווית שמותאמת לשוק המקומי מסיבות של דיווח על התנהלות פוגעת.בנוסף, השיטה
videoAbuseReportReasons.list
תומכת עכשיו בפרמטרhl
, שמציין את השפה שבה יש להשתמש לטקסט תווית בתגובת ה-API. ערך ברירת המחדל של הפרמטר הואen_US
. -
הנכס החדש
contentDetails.contentRating.ecbmctRating
של המשאבvideo
מציין את הדירוג של סרטון ממועצת ההערכה והסיווג של משרד התרבות והתיירות של טורקיה.בנוסף, מאפייני API של מערכות סיווג אחרות תומכים בערכי הנכסים החדשים הבאים:
contentDetails.contentRating.fpbRating
(דרום אפריקה)
דירוג: 10; ערך הנכס:fpb10
contentDetails.contentRating.moctwRating
(טייוואן)
דירוג: R-12; ערך הנכס:moctwR12
contentDetails.contentRating.moctwRating
(טייוואן)
דירוג: R-15; ערך הנכס:moctwR15
-
המאפיין
liveStreamingDetails.activeLiveChatId
של המשאבvideo
מכיל את המזהה של הצ'אט הפעיל המשויך לסרטון. ערך הנכס מוצג רק אם הסרטון הוא שידור חי נוכחי שמופעל בו צ'אט בשידור חי. אחרי שהשידור יסתיים והצ'אט בשידור חי יסתיים, הנכס לא יוחזר לסרטון. -
המאפיין
status.rejectionReason
של המשאבvideo
תומך בערך המאפיין החדשlegal
.
-
-
ה-API תומך בשגיאות החדשות הבאות:
סוג השגיאה פרטי השגיאה תיאור badRequest (400)
notEditable
השיטות channelSections.insert
,channelSections.update
ו-channelSections.delete
מחזירות את השגיאה הזו כדי לציין שלא ניתן ליצור, לעדכן או למחוק את קטע הערוץ שצוין.badRequest (400)
styleRequired
השיטות channelSections.insert
ו-channelSections.update
מחזירות את השגיאה הזו כדי לציין שהמשאבchannelSection
שנשלח בבקשת ה-API חייב לציין ערך עבור המאפייןsnippet.style
.badRequest (400)
typeRequired
השיטות channelSections.insert
ו-channelSections.update
מחזירות את השגיאה הזו כדי לציין שהמשאבchannelSection
שנשלח בבקשת ה-API חייב לציין ערך עבור המאפייןsnippet.type
.badRequest (400)
processingFailure
השיטה commentThreads.list
מחזירה את השגיאה הזו כדי לציין ששרת ה-API לא הצליח לעבד את הבקשה. זו יכולה להיות שגיאה זמנית, אבל בדרך כלל היא מעידה על כך שהקלט של הבקשה לא חוקי. כדי לוודא שהוא תקין, צריך לבדוק את המבנה של המשאבcommentThread
בגוף הבקשה.forbidden (403)
commentsDisabled
השיטה commentThreads.list
מחזירה את השגיאה הזו כדי לציין שהסרטון שזוהה על ידי הפרמטרvideoId
השבית תגובות.badRequest (400)
commentTextTooLong
השיטה commentThreads.insert
מחזירה את השגיאה הזו כדי לציין שהמשאבcomment
שמוכנס מכיל יותר מדי תווים במאפייןsnippet.topLevelComment.snippet.textOriginal
.invalidValue (400)
videoAlreadyInAnotherSeriesPlaylist
השיטה playlistItems.insert
מחזירה את השגיאה הזו כדי לציין שהסרטון שאתם מנסים להוסיף לפלייליסט כבר נמצא בפלייליסט אחר של סדרה. מידע נוסף על פלייליסטים של סדרות זמין במרכז העזרה של YouTube.badRequest (400)
subscriptionForbidden
השיטה subscriptions.insert
מחזירה את השגיאה הזו כדי לציין שהגעת למספר המקסימלי של מינויים או שיצרת יותר מדי מינויים לאחרונה. במקרה השני, תוכל לנסות שוב את הבקשה לאחר מספר שעות.badRequest (400)
invalidCategoryId
השיטה videos.update
מחזירה את השגיאה הזו כדי לציין שהמאפייןsnippet.categoryId
במשאבvideo
שהועלה ציין מזהה קטגוריה לא חוקי. אפשר להשתמש בשיטהvideoCategories.list
כדי לאחזר קטגוריות נתמכות.badRequest (400)
invalidDescription
השיטה videos.update
מחזירה את השגיאה הזו כדי לציין שהמאפייןsnippet.description
במשאבvideo
שהועלה ציין ערך לא חוקי.badRequest (400)
invalidPublishAt
השיטה videos.update
מחזירה את השגיאה הזו כדי לציין שהמאפייןstatus.publishAt
במשאבvideo
שהועלה ציין זמן פרסום מתוזמן לא חוקי.badRequest (400)
invalidRecordingDetails
השיטה videos.update
מחזירה את השגיאה הזו כדי לציין שבאובייקטrecordingDetails
במשאבvideo
שהועלה צוינו פרטי הקלטה לא חוקיים.badRequest (400)
invalidTags
השיטה videos.update
מחזירה את השגיאה הזו כדי לציין שהמאפייןsnippet.tags
במשאבvideo
שהועלה ציין ערך לא חוקי.badRequest (400)
invalidTitle
השיטה videos.update
מחזירה את השגיאה הזו כדי לציין שהמאפייןsnippet.title
במשאבvideo
שהועלה ציין כותרת סרטון לא חוקית או ריקה.badRequest (400)
invalidVideoMetadata
השיטה videos.update
מחזירה את השגיאה הזו כדי לציין שהמטא-נתונים של הבקשה לא חוקיים. השגיאה הזו מתקבלת אם הבקשה מעדכנת את החלקsnippet
במשאבvideo
, אבל לא מגדירה ערך לנכסיםsnippet.title
ו-snippet.categoryId
.
18 בדצמבר 2015
חוקי האיחוד האירופי מחייבים להציג הודעות גילוי נאות מסוימות למשתמשי קצה באיחוד האירופי, ולקבל את הסכמתם לכך. לכן, משתמשי קצה באיחוד האירופי חייבים לפעול בהתאם למדיניות Google בנושא הסכמת משתמשים באיחוד האירופי. הוספנו הודעה על הדרישה הזו בתנאים ובהגבלות של YouTube API.
19 בנובמבר 2015
ה-API תומך עכשיו באפשרות להגדיר ולאחזר טקסט שעבר לוקליזציה למאפיינים snippet.title
ו-snippet.description
של המשאבים playlist
ו-video
, המאפיין snippet.title
של המשאב channelSection
והמאפיין snippet.description
של המשאב channel
.
-
הגדרת שמות ותיאורים שמותאמים לשוק המקומי
אפשר להגדיר למשאב ערכים מותאמים לשוק המקומי כשמפעילים את השיטה
insert
אוupdate
של המשאב. כדי להגדיר ערכים מותאמים לשוק המקומי למשאב, מבצעים את שתי הפעולות הבאות:-
חשוב לוודא שמוגדר ערך למאפיין
snippet.defaultLanguage
של המשאב. המאפיין הזה מזהה את השפה של המאפייניםsnippet.title
ו-snippet.description
של המשאב. הערך שלו יכול להיות כל שפת אפליקציה נתמכת או רוב קודי השפה האחרים לפי תקן ISO 639-1:2002. לדוגמה, אם מעלים סרטון עם שם ותיאור באנגלית, צריך להגדיר את נכסsnippet.defaultLanguage
כ-en
.הערה לגבי עדכון של
channel
משאבים: כדי להגדיר את הנכסsnippet.defaultLanguage
למשאבchannel
, צריך למעשה לעדכן את הנכסbrandingSettings.channel.defaultLanguage
. -
מוסיפים את האובייקט
localizations
למשאב שמעדכנים. כל מפתח אובייקט הוא מחרוזת שמזהה שפת יישום או קוד שפה ISO 639-1:2002, וכל מפתח ממופה לאובייקט שמכיל את הכותרת (והתיאור) של המשאב המותאם לשוק המקומי.קטע הקוד לדוגמה שבהמשך מגדיר את שפת ברירת המחדל של המשאב לאנגלית. כמו כן, היא מוסיפה לסרטון שמות ותיאורים בגרמנית ובספרדית שמותאמים לשוק המקומי:
{ "kind": "youtube#video", ... "snippet": { "title": "Playing soccer", "description": "We play soccer in the park on Sundays.", "defaultLanguage": "en", ... }, "localizations": "de": { "title": "Fußball spielen", "description": "Wir spielen Fußball im Park am Sonntag" }, "es": { "title": "Jugar al fútbol", "description": "Nosotros jugamos fútbol en el parque los domingos", } } }
חשוב: חשוב לזכור שכשמעדכנים את הנתונים המותאמים לשוק המקומי של משאב, בקשת ה-API חייבת לכלול את כל הגרסאות הקיימות של הנתונים שהותאמו לשוק המקומי. לדוגמה: אם שלחתם לאחר מכן בקשה להוספת נתונים בפורטוגזית לסרטון בדוגמה שלמעלה, הבקשה תצטרך לכלול את הנתונים המותאמים לשוק המקומי עבור גרמנית, ספרדית ופורטוגזית.
-
-
אחזור ערכים שהותאמו לשוק המקומי
ה-API תומך בשתי דרכים לאחזור ערכים מותאמים לשוק המקומי למשאב:
-
מוסיפים את הפרמטר
hl
לבקשה ל-channels.list
, ל-channelSections.list
, ל-playlists.list
או ל-videos.list
כדי לאחזר נתונים שמותאמים לשוק המקומי בשפת אפליקציה ספציפית שנתמכת באתר YouTube. אם פרטי המשאב שעברו לוקליזציה זמינים בשפה הזו, האובייקטsnippet.localized
של המשאב יכיל את הערכים שהותאמו לשוק המקומי. עם זאת, אם אין פרטים שמותאמים לשוק המקומי, האובייקטsnippet.localized
יכיל את פרטי המשאב בשפת ברירת המחדל של המשאב.לדוגמה, נניח שבקשה של
videos.list
אחזרה נתונים עבור הסרטון שתואר למעלה, עם נתונים מגרמנית ומספרדית שהותאמו לשוק המקומי. אם הפרמטרhl
היה מוגדר ל-de
, המשאב יכלול את הנתונים הבאים:{ "kind": "youtube#video", ... "snippet": { "title": "Playing soccer", "description": "We play soccer in the park on Sundays.", "defaultLanguage": "en", "localized": { "title": "Fußball spielen", "description": "Wir spielen Fußball im Park am Sonntag" } ... } }
עם זאת, אם הפרמטר
hl
מוגדר לערךfr
, האובייקטsnippet.localized
יכלול את הכותרת והתיאור באנגלית, כי שפת ברירת המחדל של המשאב היא אנגלית, ואין פרטים זמינים בצרפתית שמותאמת לשוק המקומי.חשוב: הפרמטרhl
תומך רק בערכים שמזהים את שפות האפליקציה הנתמכות באתר של YouTube. כדי לקבוע אם טקסט מקומי זמין בשפות אחרות, צריך לאחזר את החלקlocalizations
של המשאב ולסנן כדי לקבוע אם קיים הטקסט המותאם לשוק המקומי.
לדוגמה, צריך לאחזר את הרשימה המלאה של ההתאמות לשוק המקומי כדי לקבוע אם טקסט מקומי זמין באנגלית אפלצ'ית.
-
בעת אחזור משאב, יש לכלול
localizations
בערך הפרמטרpart
כדי לאחזר את כל הפרטים המותאמים לשוק המקומי של אותו משאב. אם אתם מאחזרים נתונים מותאמים לשוק המקומי עבור שפה שאינה השפה העדכנית של אפליקציית YouTube, עליכם להשתמש בגישה הזו כדי לאחזר את כל ההתאמות המקומיות ולאחר מכן לסנן כדי לקבוע אם הנתונים המקומיים הרצויים קיימים.
-
-
שגיאות שקשורות לערכי טקסט שהותאמו לשוק המקומי
ה-API תומך גם בשגיאות החדשות הבאות לגבי ערכי טקסט שהותאמו לשוק המקומי:
סוג השגיאה פרטי השגיאה תיאור badRequest (400)
defaultLanguageNotSetError
השגיאה הזו מציינת שבקשה שמנסה להוסיף או לעדכן את האובייקט localizations
של משאב נכשלת כי המאפייןsnippet.defaultLanguage
לא מוגדר למשאב הזה. השיטותchannels.update
,channelSections.insert
,channelSections.update
,playlists.insert
,playlists.update
,videos.insert
ו-videos.update
תומכות בשגיאה הזו.badRequest (400)
localizationValidationError
השגיאה הזו מציינת שאחד מהערכים באובייקט localizations
של המשאב נכשל באימות. לדוגמה, השגיאה הזו יכולה להתרחש אם האובייקט מכיל קוד שפה לא חוקי. השיטותchannels.update
,channelSections.insert
,channelSections.update
,playlists.insert
, וגםplaylists.update
תומכות בשגיאה הזו.
4 בנובמבר 2015
העדכון הזה כולל את השינויים הבאים:
-
עדכונים של שיטות ומשאבים קיימים
-
הפרמטר
order
של שיטתsearch.list
עודכן, כך שאם ממיינים שידורים חיים לפיviewCount
, תוצאות ה-API ממוינות לפי מספר הצופים בו-זמנית בשידורים השונים בזמן שהשידורים עדיין מתקיימים. -
הפרמטר
relatedToVideoId
של שיטת הבידינגsearch.list
עודכן ועכשיו הוא מוגדר כך: אם הפרמטר מוגדר, הפרמטרים היחידים הנוספים הנתמכים הםpart
,maxResults
,pageToken
,regionCode
,relevanceLanguage
,safeSearch
,type
(צריך להגדיר אותם כ-video
) ו-fields
. העדכון הזה לא משקף שינוי בהתנהגות של ה-API. -
ההגדרה של המאפיין
snippet.publishedAt
של המשאבvideo
עודכנה כדי לציין שערך המאפיין, שמציין את התאריך והשעה שבהם הסרטון פורסם, עשוי להיות שונה מהשעה שבה הסרטון הועלה. לדוגמה, אם סרטון מועלה כסרטון פרטי ואז הפך לגלוי לכולם במועד מאוחר יותר, ערך המאפיין מציין את הזמן שבו הסרטון הפך לגלוי לכולם. ההגדרה המעודכנת גם מסבירה איך הערך מאוכלס בסרטונים פרטיים ובסרטונים לא רשומים.השינוי הזה לא משקף שינוי בהתנהגות של ה-API.
-
ההגדרה של המאפיין
status.publishAt
של המשאבvideo
עודכנה ועכשיו היא:- אם מגדירים את הערך של המאפיין הזה כשמפעילים את השיטה
videos.update
, צריך להגדיר גם את ערך המאפייןstatus.privacyStatus
ל-private
גם אם הסרטון כבר מוגדר כפרטי. - אם הבקשה מתזמנת פרסום של סרטון למועד מסוים בעבר, הסרטון מתפרסם מיד. לכן, ההשפעה של הגדרת המאפיין
status.publishAt
לתאריך ולשעה קודמים זהה להשפעה של שינוי הערך שלprivacyStatus
בסרטון מ-private
ל-public
.
- אם מגדירים את הערך של המאפיין הזה כשמפעילים את השיטה
-
המאפיין
contentDetails.contentRating.cncRating
של המשאבvideo
מציין את סיווג הסרטון לפי הסיווג 'סינמטוגרפיה' של הנציבות הצרפתית. הנכס הזה מחליף את הנכסcontentDetails.contentRating.fmocRating
, שהוצא משימוש. -
ההגדרה של brandingSettings.channel.keywords של המשאב
channel
עודכנה כדי לשקף כראוי שערך המאפיין מכיל רשימת מחרוזות שמופרדות ברווחים, ולא רשימה שמופרדת בפסיקים, כפי שתועד בעבר. העדכון הזה לא משקף שינוי בהתנהגות של ה-API. -
התיעוד של השיטה
thumbnails.set
עודכן כדי לשקף במדויק שגוף הבקשה מכיל את התמונה הממוזערת שבחרת להעלות ולשייך לסרטון. גוף הבקשה לא מכיל משאבthumbnail
. בעבר, במסמכים צוין שאסור לספק את גוף הבקשה כשקוראים לשיטה הזו. העדכון הזה לא משקף שינוי בהתנהגות של ה-API. -
התיאור של המשאב
activity
עודכן כדי לשקף את העובדה ששיטתactivities.list
לא כוללת כרגע משאבים הקשורים לתגובות חדשות לסרטונים. גםsnippet.type
וגםcontentDetails.comment
של המשאב עודכנו.
-
-
שגיאות חדשות ומעודכנות
-
ה-API תומך עכשיו בשגיאות הבאות:
פרטי השגיאה activities.insert
קוד תגובת HTTP badRequest (400)
סיבה invalidMetadata
תיאור המאפיין ב- kind
לא תואם לסוג המזהה שסופק.commentThreads.update
comments.insert
comments.update
קוד תגובת HTTP badRequest (400)
סיבה commentTextTooLong
תיאור המשאב comment
שנוסף או עודכן מכיל יותר מדי תווים במאפייןsnippet.topLevelComment.snippet.textOriginal
.playlistItems.insert
playlistItems.update
קוד תגובת HTTP forbidden (403)
סיבה playlistItemsNotAccessible
תיאור הבקשה אינה מורשית כראוי להוסיף, לעדכן או למחוק את הפריט שצוין בפלייליסט. playlists.delete
playlists.insert
playlists.update
קוד תגובת HTTP badRequest (400)
סיבה playlistForbidden
תיאור פעולה זו אסורה או שהבקשה אינה מורשית כראוי. search.list
קוד תגובת HTTP badRequest (400)
סיבה invalidLocation
תיאור הפורמט של ערך הפרמטר location
ו/אוlocationRadius
שגוי.search.list
קוד תגובת HTTP badRequest (400)
סיבה invalidRelevanceLanguage
תיאור הפורמט של ערך הפרמטר relevanceLanguage
שגוי.subscriptions.insert
קוד תגובת HTTP badRequest (400)
סיבה subscriptionForbidden
תיאור שגיאה זו מתרחשת כאשר מתקיים אחד מהתנאים הבאים: - המינוי שניסית ליצור כבר קיים
- כבר הגעת למספר המינויים המקסימלי
- ניסית להירשם לערוץ שלך. הערוץ הזה לא נתמך.
- יצרת יותר מדי מינויים לאחרונה. עליך להמתין כמה שעות לפני ניסיון חוזר של שליחת הבקשה.
videos.update
קוד תגובת HTTP badRequest (400)
סיבה invalidDefaultBroadcastPrivacySetting
תיאור הבקשה מנסה לקבוע הגדרת פרטיות לא חוקית לשידור ברירת המחדל.
-
28 באוגוסט 2015
העדכון הזה כולל את השינויים הבאים:
-
עדכונים של שיטות ומשאבים קיימים
-
המאפיין
statistics.favoriteCount
של המשאבvideo
הוצא משימוש.בהתאם למדיניות שלנו בנושא הוצאה משימוש, הנכס הזה ימשיך להיכלל ב-
video
משאבים למשך שנה לפחות אחרי ההכרזה הזו. עם זאת, ערך הנכס מוגדר עכשיו תמיד כ-0
.
-
7 באוגוסט 2015
העדכון הזה כולל את השינויים הבאים:
-
עדכונים של שיטות ומשאבים קיימים
-
ההגדרה של המאפיין
snippet.tags[]
של המשאבvideo
עודכנה כדי לספק מידע נוסף על האופן שבו שרת ה-API מחשב את אורך הערך של המאפיין. לתשומת ליבכם: העדכון הזה לא משקף שינוי בהתנהגות של ה-API.באופן ספציפי, ההגדרה מסבירה עכשיו שאם תג מכיל רווח, שרת ה-API מטפל בערך התג כאילו הוא מוקף במירכאות כפולות, והמירכאות מתחלקות למגבלת התווים. לכן, למטרת מגבלת תווים, התג Foo-Baz מכיל שבעה תווים, אבל התג Foo-Baz מכיל תשעה תווים.
-
השיטה
commentThreads.insert
לא תומכת יותר בפרמטרshareOnGooglePlus
, שלפיו קודם לכן יש לפרסם תגובה ותשובות לתגובה הזו גם בפרופיל Google+ של המחבר. אם הבקשה שולחת את הפרמטר, שרת ה-API מתעלם מהפרמטר אבל מטפל בבקשה אחרת.
-
18 ביוני 2015
העדכון הזה כולל את השינויים הבאים:
-
עדכונים של שיטות ומשאבים קיימים
-
הפרמטר
order
החדש של השיטהcommentThreads.list
מציין את הסדר שבו שרשורי התגובות צריכים להופיע בתגובת ה-API. אתם יכולים לסדר את השרשורים לפי זמן או רלוונטיות. ברירת המחדל היא לסדר אותם לפי זמן. -
המאפיין החדש
snippet.defaultAudioLanguage
של המשאבvideo
מציין את השפה המדוברת בטראק האודיו שמוגדר כברירת מחדל בסרטון. -
ההגדרה של מאפיין
contentDetails.licensedContent
של המשאבvideo
עודכנה כדי להבהיר שהתוכן צריך להעלות במקור לערוץ שמקושר לשותף תוכן של YouTube, ולאחר מכן הצהירו על זכויות יוצרים לגביו. הנתון הזה לא מייצג שינוי בהתנהגות של ה-API בפועל. -
השיטות
captions.delete
,captions.download
,captions.insert
,captions.list
, וגםcaptions.update
תומכות עכשיו בפרמטרonBehalfOfContentOwner
, שכבר נתמך בכמה שיטות נוספות. גם בקשות שמשתמשות בשיטה הזו צריכות לקבל הרשאה באמצעות אסימון שמספק גישה להיקףhttps://www.googleapis.com/auth/youtubepartner
.
-
-
שגיאות חדשות ומעודכנות
-
ה-API תומך עכשיו בשגיאות הבאות:
פרטי השגיאה videos.rate
קוד תגובת HTTP badRequest (400)
סיבה emailNotVerified
תיאור המשתמשת צריכה לאמת את כתובת האימייל שלה לפני דירוג הסרטון. videos.rate
קוד תגובת HTTP badRequest (400)
סיבה videoPurchaseRequired
תיאור סרטונים ששכרתם ניתנים לדירוג רק על ידי משתמשים ששכרו אותם. -
השיטות
subscriptions.delete
ו-subscriptions.insert
לא תומכות יותר בשגיאותaccountClosed
ו-accountSuspended
.
-
27 באפריל 2015
העדכון הזה כולל את השינויים הבאים:
-
שיטות ומקורות מידע חדשים
-
המשאב החדש
videoAbuseReportReason
מכיל מידע על סיבה שבגללה סרטון יסומן כמכיל תוכן פוגעני. השיטהvideoAbuseReportReasons.list
מאפשרת לאחזר רשימה של כל הסיבות האפשריות לסימון סרטונים. -
השיטה החדשה
videos.reportAbuse
מספקת דרך לסימון בפועל של סרטון שמכיל תוכן פוגעני. גוף הבקשה מכיל אובייקט JSON שמציין את הסרטון שסומן ואת הסיבה לכך שהסרטון מכיל תוכן פוגעני. ניתן לקבל סיבות תקפות באמצעות השיטהvideoAbuseReportReason.list
שמתוארת למעלה.גם המדריך להעברת נתונים עודכן ועכשיו הוא כולל דוגמה לדיווח על סרטון פוגעני. בעקבות השינוי הזה, גרסת V3 של ה-API תומכת עכשיו בכל התכונות של V2 שהוא מתוזמן לתמוך בהן. כל התכונות האלה מוסברות גם במדריך להעברת נתונים (מיגרציה).
-
-
עדכונים של שיטות ומשאבים קיימים
-
פרמטר המסנן החדש
forDeveloper
של השיטהsearch.list
מגביל את החיפוש לאחזור רק סרטונים שהועלו דרך האפליקציה או האתר של המפתח. אפשר להשתמש בפרמטרforDeveloper
ביחד עם פרמטרים אופציונליים של חיפוש, כמו הפרמטרq
.בתכונה הזו, כל סרטון שהועלה מתויג באופן אוטומטי באמצעות מספר הפרויקט שמשויך לאפליקציה של המפתח ב-Google Developers Console.
לאחר מכן, כשבקשת חיפוש מגדירה את הפרמטר
forDeveloper
ל-true
, שרת ה-API משתמש בפרטי הכניסה של ההרשאה של הבקשה כדי לזהות את המפתח. לכן, המפתח יכול להגביל את התוצאות לסרטונים שהועלו דרך האפליקציה או האתר של המפתח, אבל לא לסרטונים שהועלו דרך אפליקציות או אתרים אחרים.התכונה החדשה מציעה פונקציונליות שדומה לפונקציונליות של תגים למפתחים, אבל לא זהה לה ב-V2 API.
-
המאפיין החדש
snippet.country
של המשאבchannel
מאפשר לבעלי ערוצים לשייך את הערוצים שלהם למדינה מסוימת.הערה: כדי להגדיר את המאפיין
snippet.country
למשאבchannel
, צריך למעשה לעדכן את הנכסbrandingSettings.channel.country
. -
ה-API תומך עכשיו בטירגוט למשאבים של
channelSection
. בעזרת טירגוט לפי קטעים בערוץ, אתם יכולים להגביל את החשיפה של קטע התוכן למשתמשים שתואמים לקריטריונים מסוימים.ה-API חושף שלוש אפשרויות מיקוד. כדי שקטע מסוים בערוץ יהיה גלוי, המשתמש חייב לעמוד בכל הגדרות הטירגוט.
-
targeting.languages[]
: רשימה של שפות של אפליקציות ב-YouTube. משתמשים שבחרו באחת מהשפות האלה יכולים לראות את קטע הערוץ המתאים. -
targeting.regions[]
: רשימה של אזורי תוכן מועדפים של YouTube. קטע הערוץ גלוי למשתמשים שבחרו אחד מהאזורים האלה, וגם למשתמשים שאחד מהאזורים האלה נבחר באופן אוטומטי. -
targeting.countries[]
: רשימה של המדינות שבהן הקטע בערוץ גלוי. כל ערך ברשימה הוא קוד מדינה לפי תקן ISO 3166-1 alpha-2.
-
-
ההגדרה של המאפיין
contentDetails.duration
של המשאבvideo
תוקנה, כך שהערך יכול לשקף שעות, ימים וכן הלאה. -
התיעוד של השיטה
channelSections.delete
,playlistItems.delete
,playlists.delete
,subscriptions.delete
, ו-videos.delete
תוקן ומשקף את העובדה שכשהפעולה מצליחה, כל השיטות מחזירות קוד תגובה של HTTP204
(No Content
).
-
-
שגיאות חדשות ומעודכנות
-
ה-API תומך עכשיו בשגיאות הבאות:
סוג השגיאה פרטי השגיאה תיאור badRequest (400)
targetInvalidCountry
השיטות channelSections.insert
ו-channelSections.update
מחזירות את השגיאה הזו אם המשאבchannelSection
שהוזן הכיל ערך לא חוקי עבור המאפייןtargeting.countries[]
.badRequest (400)
targetInvalidLanguage
השיטות channelSections.insert
ו-channelSections.update
מחזירות את השגיאה הזו אם המשאבchannelSection
שהוזן הכיל ערך לא חוקי עבור המאפייןtargeting.languages[]
.badRequest (400)
targetInvalidRegion
השיטות channelSections.insert
ו-channelSections.update
מחזירות את השגיאה הזו אם המשאבchannelSection
שהוזן הכיל ערך לא חוקי עבור המאפייןtargeting.regions[]
.badRequest (400)
operationNotSupported
השיטה comments.insert
מחזירה את השגיאה הזו אם משתמש ה-API לא יכול להוסיף תגובה בתגובה לתגובה ברמה העליונה שזוהתה על ידי נכסsnippet.parentId
. במשאבcommentThread
, המאפייןsnippet.canReply
מציין אם הצופה הנוכחי יכול להשיב לשרשור.badRequest (400)
invalidChannelId
השיטה search.list
מחזירה את השגיאה הזו אם הפרמטרchannelId
בבקשה ציין מזהה ערוץ לא חוקי.badRequest (400)
subscriptionForbidden
השיטה subscriptions.insert
מחזירה את השגיאה הזו אם משתמש ה-API מנסה להירשם לערוץ של המשתמש. -
השיטה
captions.update
לא תומכת יותר בשגיאותinvalidMetadata
ו-videoNotFound
.
-
16 באפריל 2015
העדכון הזה כולל את השינויים הבאים:
-
עודכן המדריך להעברה כדי להסביר איך להעביר אפליקציות שעדיין משתמשות בפונקציונליות של תגובות מ-v2 API.
במדריך גם מפורטות כמה תכונות של הוספת תגובות שלא תמכו ב-V2 API אבל נתמכות ב-v3 API. רשימת המדינות כוללת את:
- אחזור תגובות על ערוץ
- אחזור של כל שרשורי התגובות שקשורים לערוץ, כלומר תגובת ה-API יכולה להכיל תגובות על הערוץ או על כל אחד מהסרטונים שבו.
- עדכון הטקסט של תגובה
- סימון של תגובה כספאם
- הגדרת סטטוס ניהול של תגובה
-
המדריך להרשמה להתראות עודכן ועכשיו הוא משקף את העובדה שההתראות נשלחות רק למרכז העדכונים של Google PubSubHubBub, ולא גם ל-Superfeedr Hub, כפי שצוין קודם.
9 באפריל 2015
העדכון הזה כולל את השינויים הבאים:
-
המשאבים החדשים
commentThread
ו-comment
של ה-API מאפשרים לך לאחזר, להוסיף, לעדכן, למחוק ולנהל תגובות.-
משאב של
commentThread
מכיל מידע על שרשור תגובות ב-YouTube, שמורכב מתגובה ברמה העליונה ומתשובות לתגובה הזו, אם יש כאלה. משאבcommentThread
יכול לייצג תגובות על סרטון או על ערוץ.התגובה ברמה העליונה והתשובות הן למעשה
comment
משאבים שמוצבים בתוך המשאבcommentThread
. חשוב לציין שהמשאבcommentThread
לא בהכרח מכיל את כל התשובות לתגובה, וצריך להשתמש בשיטהcomments.list
כדי לאחזר את כל התשובות לתגובה מסוימת. בנוסף, לחלק מהתגובות אין תשובות.ה-API תומך בשיטות הבאות למשאבים של
commentThread
:commentThreads.list
– אחזור רשימה של שרשורי תגובות. אפשר להשתמש בשיטה הזו כדי לאחזר תגובות שמשויכות לסרטון או לערוץ מסוים.commentThreads.insert
– יצירת תגובה חדשה ברמה העליונה. (משתמשים בשיטהcomments.insert
כדי להשיב לתגובה קיימת).commentThreads.update
– שינוי תגובה ברמה העליונה.
-
משאב
comment
מכיל מידע על תגובה אחת ב-YouTube. משאבcomment
יכול לייצג תגובה על סרטון או על ערוץ. בנוסף, התגובה יכולה להיות תגובה ברמה עליונה או תשובה לתגובה ברמה עליונה.ה-API תומך בשיטות הבאות למשאבים של
comment
:comments.list
– אחזור רשימת תגובות. השתמש בשיטה זו כדי לאחזר את כל התשובות לתגובה מסוימת.comments.insert
– יצירת תשובה לתגובה קיימת.comments.update
– שינוי תגובה.comments.markAsSpam
– סימון תגובה אחת או יותר כספאם.comments.setModerationStatus
– הגדרת סטטוס הניהול של תגובה אחת או יותר. לדוגמה, אפשר למחוק תגובה כדי שלא תוצג באופן גלוי לכולם או לדחות אותה כלא מתאימה להצגה. בקשת ה-API צריכה לקבל אישור מהבעלים של הערוץ או של הסרטון שמשויכים לתגובות.comments.delete
– מחיקת תגובה.
שימו לב שההיקף החדש של
https://www.googleapis.com/auth/youtube.force-ssl
ב-API, שמתואר בהיסטוריית הגרסאות ל-2 באפריל 2015, נדרש עבור קריאות לשיטותcomments.insert
,comments.update
,comments.markAsSpam
,comments.setModerationStatus
,comments.delete
,commentThreads.insert
ו-commentThreads.update
. -
-
במדריך החדש הרשמה להתראות מוסבר על התמיכה החדשה של ה-API בהתראות שנשלחות מהאפליקציה דרך PubSubHubBub, פרוטוקול פרסום/הרשמה משרת-לשרת למשאבים נגישים באינטרנט. שרת PubSubHubBub יכול לקבל התראות בפיד Atom כשערוץ מבצע אחת מהפעילויות הבאות:
- מעלה סרטון
- מעדכן שם של סרטון
- מעדכן תיאור של סרטון
-
בנוסף, במדריך להעברת נתונים עדכנו את התמיכה החדשה בנושא התראות. עם זאת, מכיוון ש-V2 API תמך במספר סוגים אחרים של התראות שלא נתמכים ב-API של v3, האזכור של התמיכה ב-PubSubHubBub עדיין מופיע בקטע הוצא משימוש במדריך הזה.
-
היקף ההרשאות החדש של
https://www.googleapis.com/auth/youtube.force-ssl
ב-API הוא עכשיו היקף חוקי לכל שיטת API שתמכה בעבר בהיקףhttps://www.googleapis.com/auth/youtube
. -
ה-API תומך עכשיו בשגיאות הבאות:
סוג השגיאה פרטי השגיאה תיאור badRequest (400)
invalidRating
השיטה videos.rate
מחזירה את השגיאה הזו אם הבקשה הכילה ערך בלתי צפוי עבור הפרמטרrating
. -
השיטה
subscriptions.insert
לא תומכת יותר בשגיאהsubscriptionLimitExceeded
. השגיאה הזו מציינת בעבר שהמנוי שצוין בבקשה חרג ממגבלת כמות המינויים.
2 באפריל 2015
העדכון הזה כולל את השינויים הבאים:
-
המשאב החדש
captions
מייצג רצועת כתוביות של YouTube. רצועת כתוביות משויכת לסרטון אחד בלבד ב-YouTube.ה-API תומך בשיטות להצגת רשימה, הוספה, עדכון, הורדה ומחיקה של רצועות כתוביות.
-
נוסף לכך גם המדריך להעברה כדי להסביר איך להעביר אפליקציות שעדיין משתמשות בפונקציונליות של כתוביות ב-v2 API.
-
ההיקף החדש של
https://www.googleapis.com/auth/youtube.force-ssl
של ה-API מחייב תקשורת עם שרת ה-API כדי להתבצע בחיבור SSL.ההיקף החדש מעניק את אותה הרשאת גישה כמו להיקף ההרשאות
https://www.googleapis.com/auth/youtube
. למעשה, שני ההיקפים האלה זהים מבחינה פונקציונליות מכיוון ששרת ה-API של YouTube זמין רק דרך נקודת קצה (endpoint) מסוג HTTPS. כתוצאה מכך, על אף שההיקף שלhttps://www.googleapis.com/auth/youtube
לא מחייב חיבור SSL, למעשה אין דרך אחרת לשלוח בקשת API.ההיקף החדש נדרש לקריאות לכל השיטות של המשאב
caption
.
11 במרץ 2015
העדכון הזה כולל את השינויים הבאים:
-
המדריך להעברת נתונים מ-YouTube Data API (v3) מכיל כרטיסייה חדשה בשם חדש ב-v3 API, שמפרטת את התכונות שנתמכות ב-v3 API ושאין תמיכה בהן ב-v2 API. אותן התכונות הוצגו קודם, ועדיין מופיעות בכרטיסיות אחרות במדריך. לדוגמה, התכונה החדשה שמסבירה איך לעדכן נתוני קמפיין של קידום מכירות בתוך הסרטון מופיעה גם היא בכרטיסייה ערוצים (פרופילים).
-
מדריך להעברת נתונים מ-YouTube Data API (גרסה 3) עודכן ועכשיו הוא יתמוך בתכונה v2 API של גרסה 3:
-
המדריך להעברת נתונים מ-YouTube Data API (v3) עודכן ועכשיו אין תמיכה בתכונות הבאות של v2 API ב-v3 API:
-
אחזור המלצות לסרטונים – גרסה 3 של ה-API לא מאחזרת רשימה שמכילה רק סרטונים שמומלצים למשתמש ה-API הנוכחי. עם זאת, תוכלו להשתמש ב-v3 API כדי למצוא סרטונים מומלצים. לשם כך, קוראים לשיטה
activities.list
ומגדירים את ערך הפרמטרhome
ל-true
.בתגובת ה-API, משאב מתאים לסרטון מומלץ אם הערך של המאפיין
snippet.type
הואrecommendation
. במקרה כזה, המאפייניםcontentDetails.recommendation.reason
ו-contentDetails.recommendation.seedResourceId
יכילו מידע לגבי הסיבה לקבלת המלצה על הסרטון. שימו לב: לא בטוח שהתשובה תכיל מספר מסוים של סרטונים מומלצים. -
אחזור סרטונים של מינויים חדשים – גרסה 3 של ה-API לא מאחזרת רשימה שמכילה רק סרטונים שהועלו לאחרונה לערוצים שמשתמש ה-API נרשם אליהם. עם זאת, תוכלו להשתמש ב-v3 API כדי למצוא סרטונים חדשים מסוג מינוי. לשם כך, קוראים לשיטה
activities.list
ומגדירים את ערך הפרמטרhome
ל-true
.בתגובת ה-API, משאב תואם לסרטון מינוי חדש אם הערך של המאפיין
snippet.type
הואupload
. שימו לב: לא מובטח שהתשובה תכיל מספר מסוים של סרטונים חדשים שיירשמו במסגרת המינוי. -
התראות על עדכוני פידים – גרסה 2 של ה-API תומכת בהתראות, באמצעות Simple Update Protocol (SUP) או PubSubHubbub, כדי לעקוב אחר הפידים של פעילות המשתמשים אצל משתמשי YouTube. קיבלת התראות על הרשמות חדשות לערוץ ועל סרטונים שבהם דורגו, שותפו, סומנו כמועדפים, הגיבו עליהם או הועלו.
ממשק ה-API של גרסה 3 יתמוך בהתראות דחיפה באמצעות פרוטוקול PubSubHubbub, אבל ההתראות יכסו רק העלאות ועדכונים של סרטונים בשמות או בתיאורי סרטונים.
-
מיקום הערוץ – גרסה 2 של ה-API השתמשה בתג
<yt:location>
כדי לזהות את מיקום המשתמש כפי שהוזן בפרופיל הציבורי של הערוץ ב-YouTube. למרות שחלק מהמפתחים השתמשו בשדה הזה כדי לשייך ערוץ למדינה מסוימת, לא ניתן היה להשתמש באופן עקבי בנתוני השדה למטרה הזו. -
הגדרה או אחזור של תגי מפתח – גרסה 2 של ה-API תמכה באפשרות לשייך מילות מפתח או תגי מפתחים לסרטון בזמן העלאת הסרטון. תגי המפתח לא יוצגו למשתמשי YouTube, אבל בעלי סרטונים יוכלו לאחזר סרטונים שתואמים לתג מפתח ספציפי.
ממשק ה-API של v3 יספק תכונה דומה, אך לא זהה. באופן ספציפי, מפתח יוכל לחפש סרטונים שהועלו על ידי האפליקציה של המפתח. בתכונה הזו, כל סרטון שהועלה מתויג באופן אוטומטי באמצעות מספר הפרויקט שמשויך לאפליקציה של המפתח ב-Google Developers Console. לאחר מכן, המפתח משתמש באותו מספר פרויקט לחיפוש סרטונים.
-
הצגת רשימת סרטונים לפי תאריך פרסום, ספירת צפיות או דירוג – בממשק ה-API של גרסה 2, הפרמטר
orderby
מאפשר למיין סרטונים בפלייליסט לפי מיקום, משך זמן, תאריך פרסום, כותרת ומספר ערכים נוספים. בממשק ה-API של גרסה 3, פריטי הפלייליסט בדרך כלל ממוינים לפי מיקום בסדר עולה, ואפשרויות מיון אחרות לא זמינות.יש כמה יוצאים מן הכלל. העלאה חדשה, סרטון מועדף, סרטון שאהבת או סרטון שצפית בו לאחרונה מתווספים באופן אוטומטי כפריט הראשון (
snippet.position
=0
) בסוגי הפלייליסטים הבאים. לכן, כל אחת מהרשימות ממוינת ביעילות לפי סדר הפריטים, מהחדש ביותר לישן ביותר, בהתאם למועד שבו הפריטים נוספו לרשימה.- העלאות של משתמשים
- סרטונים מועדפים
- סרטונים שאהבתי
- היסטוריית צפייה
עם זאת, חשוב לשים לב שפריט חדש שמתווסף לפלייליסט 'לצפייה בהמשך' מתווסף בתור הפריט האחרון ברשימה, כך שהרשימה ממוינת בפועל מהפריט הישן לחדש ביותר.
-
עיבוד אצווה – ה-API של גרסה 3 תומך באחד מהתרחישים לדוגמה של עיבוד ברצף (batch processing) שנתמכים ב-v2 API. השיטות
channels.list
,channelSections.list
,guideCategories.list
,playlistItems.list
,playlists.list
,subscriptions.list
,videoCategories.list
ו-videos.list
של ממשק ה-API של גרסה 3 תומכות כולן בפרמטרid
, שבו ניתן להשתמש כדי לציין רשימת מזהים מופרדת בפסיקים (מזהי וידאו, מזהי ערוצים וכו'). באמצעות השיטות האלה, תוכלו לאחזר רשימה של משאבים מרובים באמצעות בקשה אחת.
בעקבות השינויים האלה, המדריך יזהה את כל הפונקציונליות שנתמכה בגרסה הקודמת (v2) של ה-API, שתוצא משימוש בגרסת ה-API הנוכחית (v3).
-
4 במרץ 2015
העדכון הזה כולל את השינויים הבאים:
-
השיטות
channelSections.delete
ו-channelSections.update
תומכות עכשיו בפרמטרonBehalfOfContentOwner
, שכבר נתמך בכמה שיטות נוספות. -
המאפיינים הבאים ונכסי הצאצא שלהם הוצאו משימוש:
brandingSettings.image.backgroundImageUrl
brandingSettings.image.largeBrandedBannerImageImapScript
brandingSettings.image.largeBrandedBannerImageUrl
brandingSettings.image.smallBrandedBannerImageImapScript
brandingSettings.image.smallBrandedBannerImageUrl
הערה: אף אחד מהנכסים האלה לא היה כפוף למדיניות ההוצאה משימוש של ה-API.
-
הנכס החדש
contentDetails.contentRating.contentDetails.contentRating.djctqRatingReasons
של המשאבvideo
מציין את הסיבות לכך שהסרטון קיבל את דירוג ה-DJCQT (ברזיל). -
ה-API תומך עכשיו בשגיאות הבאות:
סוג השגיאה פרטי השגיאה תיאור notFound (404)
channelNotFound
השיטה channels.update
מחזירה את השגיאה הזו אם הפרמטרid
של הבקשה מציין ערוץ שלא ניתן למצוא.badRequest (400)
manualSortRequiredinvalidValue
השיטות playlistItems.insert
ו-playlistItems.update
מחזירות את השגיאה הזו אם הבקשה מנסה להגדיר את המיקום של פריט הפלייליסט, אבל הפלייליסט לא משתמש במיון ידני. לדוגמה, פריטים בפלייליסט יכולים להיות ממוינים לפי תאריך או פופולריות. כדי לטפל בשגיאה הזו, אפשר להסיר את הרכיבsnippet.position
מהמשאב שנשלח בגוף הבקשה. אם רוצים שפריט הפלייליסט יקבל מיקום ספציפי ברשימה, צריך קודם לעדכן את הגדרת סדר הפלייליסט לידני. אפשר לשנות את ההגדרה הזו במנהל הסרטונים של YouTube.forbidden (403)
channelClosed
השיטה playlists.list
מחזירה את השגיאה הזו אם הפרמטרchannelId
של הבקשה מציין ערוץ שנסגר.forbidden (403)
channelSuspended
השיטה playlists.list
מחזירה את השגיאה הזו אם הפרמטרchannelId
של הבקשה מציין ערוץ שהושעה.forbidden (403)
playlistForbidden
השיטה playlists.list
מחזירה את השגיאה הזו אם הפרמטרid
של הבקשה לא תומך בבקשה או אם הבקשה לא מורשית כראוי.notFound (404)
channelNotFound
השיטה playlists.list
מחזירה את השגיאה הזו אם הפרמטרchannelId
של הבקשה מציין ערוץ שלא ניתן למצוא.notFound (404)
playlistNotFound
השיטה playlists.list
מחזירה את השגיאה הזו אם הפרמטרid
של הבקשה מציין פלייליסט שלא ניתן למצוא.notFound (404)
videoNotFound
השיטה videos.list
מחזירה את השגיאה הזו אם הפרמטרid
של הבקשה מציין סרטון שלא נמצא.badRequest (400)
invalidRating
השיטה videos.rate
מחזירה את השגיאה הזו אם הבקשה מכילה ערך בלתי צפוי עבור הפרמטרrating
.
2 במרץ 2015
העדכון הזה כולל את השינויים הבאים:
-
השיטה
search.list
תומכת עכשיו בפרמטרrelevanceLanguage
, שמאפשר לבקש את התוצאות הרלוונטיות ביותר לשפה מסוימת.גם המדריך להעברת נתונים מ-YouTube Data API (גרסה 3) עודכן כדי להסביר איך להשתמש בפרמטר החדש. הפרמטר מתייחס לפער בתכונות שהיה קיים בעבר בין גרסת ה-API הנוכחית (v3) לבין הגרסה הקודמת (v2), שכבר הוצאה משימוש.
-
נוסף עדכון גם במדריך להעברת נתונים (v3) ל-YouTube Data API כדי לציין שהוצאנו משימוש את השדות המיוחדים של פידים ומטא-נתונים שסופקו על ידי ממשק ה-API של v2 לתיאור סרטים, טריילרים, תוכניות טלוויזיה, עונות טלוויזיה ופרקים של תוכניות טלוויזיה.
14 בינואר 2015
העדכון הזה כולל את השינויים הבאים:
-
המדריך להעברת נתונים מ-YouTube Data API (גרסה 3) עודכן כדי להסביר איך להשתמש ב-API של גרסה 3 כדי להעלות סרטונים באמצעות JavaScript. (פרטים נוספים זמינים בקטע העלאת סרטון). פונקציונליות זו דומה לפונקציונליות של העלאה מבוססת דפדפן שנתמכת ב-v2 API. שימו לב שהשינוי הזה במדריך להעברת נתונים לא משקף שינוי בפועל ב-API, אלא את הזמינות של קוד לדוגמה חדש להעלאת סרטונים עם JavaScript בצד הלקוח.
לאור התמיכה בהעלאת סרטונים באמצעות ספריית הלקוח של JavaScript ו-CORS, מדריך ההעברה כבר לא מציג העלאה מבוססת דפדפן כתכונה שאפשר להוציא משימוש ב-v3 API.
-
המסמכים של השיטה
videos.insert
עודכנו כך שיכללו את הדוגמה החדשה של קוד JavaScript, כפי שמתואר למעלה. הרשימה של דוגמאות הקוד של JavaScript עבור YouTube Data API (גרסה 3) עודכנה גם היא.
11 בנובמבר 2014
העדכון הזה כולל את השינויים הבאים:
-
עלות המכסה של שיחה ל-method
search.list
השתנתה ל-100 יחידות.חשוב: במקרים רבים אפשר להשתמש בשיטות API אחרות כדי לאחזר מידע בעלות נמוכה יותר. לדוגמה, כדאי לשקול את שתי הדרכים הבאות למציאת סרטונים שהועלו לערוץ GoogleDevelopers.
-
עלות המכסה: 100 יחידות
קוראים לשיטה
search.list
ומחפשים אתGoogleDevelopers
. -
עלות מכסה: 6 יחידות
קוראים ל-method
channels.list
כדי למצוא את מזהה הערוץ הנכון. מגדירים את הפרמטרforUsername
לערךGoogleDevelopers
ואת הפרמטרpart
כ-contentDetails
. בתגובת ה-API, המאפייןcontentDetails.relatedPlaylists.uploads
מציין את מזהה הפלייליסט של הסרטונים שהועלו לערוץ.לאחר מכן קוראים לשיטה
playlistItems.list
ומגדירים לפרמטרplaylistId
את המזהה שתועד ואת הפרמטרpart
לערךsnippet
.
-
8 באוקטובר 2014
העדכון הזה כולל את השינויים הבאים:
-
המשאב
channel
מכיל שני מאפיינים חדשים:-
המאפיין
status.longUploadsStatus
מציין אם הערוץ עומד בדרישות להעלאת סרטונים שאורכם יותר מ-15 דקות. הנכס הזה מוחזר רק אם הבעלים של הערוץ אישר את בקשת ה-API. ערכי המאפיין החוקיים הם:allowed
– הערוץ יכול להעלות סרטונים שאורכם יותר מ-15 דקות.eligible
– הערוץ כשיר להעלאת סרטונים שאורכם יותר מ-15 דקות, אבל קודם צריך להפעיל את התכונה הזו.disallowed
– הערוץ אינו יכול או עומד בקריטריונים להעלאת סרטונים שאורכם יותר מ-15 דקות.
מידע נוסף על הערכים האלה זמין בהגדרת הנכס. גם מרכז העזרה של YouTube מספק מידע מפורט יותר על התכונה הזו.
-
המאפיין
invideoPromotion.useSmartTiming
מציין אם קמפיין קידום המכירות של הערוץ משתמש ב'תזמון חכם'. התכונה הזו מנסה להציג קידומי מכירות בשלב מסוים בסרטון, כאשר יש סיכוי גבוה יותר שילחצו עליהם ופחות סיכוי שהם יפריעו לחוויית הצפייה. התכונה הזו גם לוקחת קידום מכירות אחד להצגה בכל סרטון.
-
-
ההגדרות של מאפייני
snippet.title
ו-snippet.categoryId
של המשאבvideo
עודכנו כדי להבהיר את האופן שבו ה-API מטפל בקריאות ל-methodvideos.update
. אם קוראים לשיטה הזו לעדכן את החלקsnippet
במשאבvideo
, צריך להגדיר ערך לשני הנכסים.אם מנסים לעדכן את החלק
snippet
במשאבvideo
ולא מגדירים ערך לשני הנכסים, ה-API יחזיר את השגיאהinvalidRequest
. גם התיאור של השגיאה עודכן. -
המאפיין
contentDetails.contentRating.oflcRating
של המשאבvideo
, שמזהה את הדירוג של סרטון מהמשרד לסיווג סרטים וספרות בניו זילנד, תומך עכשיו בשני סיווגים חדשים:oflcRp13
ו-oflcRp16
. הדירוגים האלה תואמים לדירוגיםRP13
ו-RP16
, בהתאמה. -
השיטה
channelBanners.insert
תומכת עכשיו בשגיאה הבאה:סוג השגיאה פרטי השגיאה תיאור badRequest
bannerAlbumFull
באלבום 'גרפיקה של ערוץ YouTube' של הבעלים של הערוץ יש יותר מדי תמונות. על הבעלים של הערוץ להיכנס לכתובת http://photos.google.com, לנווט לדף האלבומים ולהסיר חלק מהתמונות מהאלבום.
12 בספטמבר 2014
העדכון הזה כולל את השינויים הבאים:
-
עלות המכסה של שיחה ל-method
search.list
השתנתה מיחידה אחת לשתי יחידות, בנוסף לעלות של חלקי המשאבים שצוינו.
13 באוגוסט 2014
העדכון הזה כולל את השינויים הבאים:
-
השיטה
subscriptions.insert
תומכת עכשיו בשגיאה הבאה:סוג השגיאה פרטי השגיאה תיאור badRequest
subscriptionLimitExceeded
המנוי שצוין בבקשה חרג ממגבלת קצב שליחת המינויים. אפשר יהיה לנסות מינויים נוספים בעוד כמה שעות.
12 באוגוסט 2014
העדכון הזה כולל את השינויים הבאים:
-
מדריך חדש בשם העברת האפליקציה שלכם ל-YouTube Data API (גרסה 3) מסביר איך להשתמש ב-YouTube Data API (גרסה 3) כדי לבצע פונקציונליות שזמינה ב-YouTube Data API (גרסה 2). ה-API הישן הוצא משימוש באופן רשמי ב-4 במרץ 2014. המדריך נועד לעזור לכם להעביר אפליקציות שעדיין משתמשות ב-V2 API לגרסת ה-API העדכנית ביותר.
8 ביולי 2014
העדכון הזה כולל את השינויים הבאים:
-
השיטה
playlists.insert
תומכת עכשיו בשגיאה הבאה:סוג השגיאה פרטי השגיאה תיאור badRequest
maxPlaylistExceeded
השגיאה הזו מתקבלת אם לא ניתן ליצור פלייליסט, מאחר שבערוץ כבר יש את מספר הפלייליסטים המרבי המותר.
18 ביוני 2014
העדכון הזה כולל את השינויים הבאים:
-
התיאור של כל שיטת API עודכן כך שיכלול את עלות המכסה שנובעת מקריאה לשיטה זו. באופן דומה, ההגדרות של הפרמטרים
part
עודכנו כדי לציין את עלות המכסה של כל חלק שאפשר לאחזר בקריאה ל-API. לדוגמה, לשיחה לשיטהsubscriptions.insert
יש מכסה של כ-50 יחידות. המשאבsubscription
מכיל גם שלושה חלקים (snippet
,contentDetails
ו-subscriberSnippet
), ולכל אחד מהם יש עלות של שתי יחידות.חשוב לזכור שעלויות המכסה יכולות להשתנות ללא אזהרה.
-
המשאב
video
תומך עכשיו ב-43 מערכות חדשות לסיווג תוכן, שמזהות את הסיווגים שקיבלו סרטונים מסוכנויות סיווג לאומיות שונות. מערכות הסיווג החדשות שנוספו הן: {9Mהשגת, אוסטריה, בלגיה, בלגיה, הולנד בלגיה בלגיה {99 } אוסטריה, בלגיה, הולנד בלגיה בלגיה {/47 לשנות שוויץ1 מלזיהבלגיה, בלגיה, בלגיה, קניה, בלגיה, קניה, סין
28 במאי 2014
העדכון הזה כולל את השינויים הבאים:
-
השיטה
search.list
תומכת עכשיו בפרמטריםlocation
ו-locationRadius
שמאפשרים לחפש סרטונים שמשויכים למיקום גיאוגרפי. בקשה חייבת לציין ערך לשני הפרמטרים כדי לאחזר תוצאות על סמך מיקום, וה-API יחזיר שגיאה אם הבקשה כוללת רק אחד משני הפרמטרים.-
הפרמטר
location
מציין את הקואורדינטות של קווי האורך והרוחב במרכז האזור הגיאוגרפי העגול. -
הפרמטר
locationRadius
מציין את המרחק המקסימלי שבו המיקום המשויך לסרטון יכול להיות ממרכז האזור כדי שהסרטון עדיין ייכלל בתוצאות החיפוש.
-
13 במאי 2014
העדכון הזה כולל את השינויים הבאים:
-
המאפיין
invideoPromotion.items[]
של המשאבchannel
עודכן, ועכשיו אפשר להגדיר בדרך כלל רק פריט מקודם אחד לערוץ. אם תנסו להוסיף יותר מדי פריטים מקודמים, ה-API יחזיר שגיאתtooManyPromotedItems
, עם קוד הסטטוס HTTP400
. -
המשאב
channelSection
יכול עכשיו להכיל מידע על כמה סוגים חדשים של תוכן מוצג. המאפייןsnippet.type
של המשאבchannelSection
תומך עכשיו בערכים הבאים:postedPlaylists
– פלייליסטים שבעל הערוץ פרסם בפיד הפעילות של הערוץpostedVideos
- סרטונים שפרסם בעל הערוץ בפיד הפעילות של הערוץsubscriptions
- ערוצים שהבעלים של הערוץ נרשם אליהם
-
המאפיין החדש
contentDetails.contentRating.ifcoRating
של המשאבvideo
מזהה את הדירוג שסרטון קיבל ממשרד הסיווג של סרטים באירלנד. -
ההגדרה של המאפיין
position.cornerPosition
של המשאבwatermark
עודכנה, ועכשיו סימן המים מופיע תמיד בפינה השמאלית העליונה של הנגן. -
ההגדרה של הפרמטר
q
בשיטהsearch.list
עודכנה ועכשיו אפשר להשתמש באופרטור הבוליאני NOT (-
) במונח השאילתה כדי להחריג סרטונים שמשויכים למונח חיפוש מסוים. הערך יכול גם להשתמש באופרטור OR בוליאני (|
) כדי למצוא סרטונים המשויכים לאחד מתוך כמה מונחי חיפוש. -
ההגדרה של המאפיין
pageInfo.totalResults
שמוחזר בתגובת API לקריאה ל-search.list
עודכנה, ועכשיו הערך הוא משוער וייתכן שלא מייצג ערך מדויק. בנוסף, הערך המקסימלי הוא 1,000,000. אין להשתמש בערך הזה ליצירת קישורי עימוד. במקום זאת, צריך להשתמש בערכי המאפייןnextPageToken
ו-prevPageToken
כדי לקבוע אם להציג קישורי עימוד. -
השיטות
watermarks.set
ו-watermarks.unset
עודכנו כך שה-API מחזיר קוד תגובה204
של HTTP עבור בקשות שבוצעו בהצלחה לשיטות האלו.
2 במאי 2014
העדכון הזה כולל את השינויים הבאים:
-
המשאב החדש
i18nLanguage
מזהה שפת אפליקציה שנתמכת באתר YouTube. אפשר להתייחס לשפת האפליקציה גם כשפת ממשק המשתמש. עבור אתר YouTube, ניתן לבחור באופן אוטומטי שפת יישום על סמך הגדרות חשבון Google, שפת הדפדפן או מיקום ה-IP, ומשתמש גם יכול לבחור באופן ידני את שפת ממשק המשתמש הרצויה מהכותרת התחתונה של האתר של YouTube.ה-API תומך בשיטה להצגת רשימה של שפות האפליקציה הנתמכות. השפות הנתמכות יכולות לשמש כערך הפרמטר
hl
כשמפעילים שיטות API כמוvideoCategories.list
ו-guideCategories.list
. -
משאב
i18nRegion
החדש מזהה אזור גיאוגרפי שמשתמש YouTube יכול לבחור כאזור התוכן המועדף. אפשר להתייחס לאזור התוכן גם כאזור התוכן. באתר YouTube, ניתן לבחור באופן אוטומטי אזור תוכן על סמך נתונים כמו דומיין YouTube או מיקום ה-IP של המשתמש, ומשתמש יכול גם לבחור באופן ידני את אזור התוכן הרצוי מתוך הכותרת התחתונה של אתר YouTube.ה-API תומך בשיטה לפירוט של אזורי תוכן נתמכים. קודי אזורים נתמכים יכולים לשמש כערך הפרמטר
regionCode
כשמפעילים שיטות API כמוsearch.list
,videos.list
,activities.list
ו-videoCategories.list
.
7 באפריל 2014
העדכון הזה כולל את השינויים הבאים:
-
המשאב החדש
channelSection
מכיל מידע על קבוצת סרטונים שהערוץ בחר להציג. לדוגמה, קטע יכול להציג את ההעלאות האחרונות בערוץ, את ההעלאות הפופולריות ביותר או סרטונים מפלייליסט אחד או יותר.ה-API תומך בשיטות להצגת רשימה, הוספה, עדכון או מחיקה של אוספים בערוץ. כדי לאחזר רשימה של אוספים של ערוצים עבור הערוץ של המשתמש המאומת, אפשר לציין מזהה ערוץ ספציפי או לציין רשימה של מזהים ייחודיים של קטעי ערוצים.
תיעוד השגיאות עודכן גם הוא כדי לתאר את הודעות השגיאה שנתמכות על ידי ה-API באופן ספציפי עבור השיטות החדשות האלו.
-
ההגדרה של אובייקט
fileDetails
של המשאבvideo
עודכנה כדי להסביר שהאובייקט יוחזר רק אם למאפייןprocessingDetails.fileDetailsAvailability
של הסרטון יש ערך שלavailable
.באופן דומה, ההגדרה של אובייקט
suggestions
של המשאבvideo
עודכנה כדי להסביר שהאובייקט יוחזר רק אם למאפייןprocessingDetails.tagSuggestionsAvailability
של הסרטון או למאפייןprocessingDetails.editorSuggestionsAvailability
שלו יש ערך שלavailable
. -
מסמכי התיעוד של השיטות
videos.insert
ו-videos.update
עודכנו, כדי לשקף שניתן להגדיר את המאפייןstatus.publishAt
כשמפעילים את השיטות האלה. -
ההגדרה של האובייקט
invideoPromotion
של המשאבchannel
עודכנה כדי להסביר שרק הבעלים של הערוץ יכול לאחזר את האובייקט. -
רשימת הפרמטרים של השיטה
videos.rate
עודכנה כדי לשקף שהשיטה הזו לא תומכת בפועל בפרמטרonBehalfOfContentOwner
. זו הייתה שגיאת תיעוד כי הבקשות שלvideos.rate
מגדירות את הפרמטר הזה מחזירות שגיאה מסוג500
.
31 במרץ 2014
העדכון הזה כולל את השינויים הבאים:
-
המאפיין החדש
status.publishAt
של המשאבvideo
מאפשר לציין את התאריך והשעה שבהם מתוזמן הפרסום של סרטון פרטי. ניתן להגדיר את המאפיין הזה רק אם סטטוס הפרטיות של הסרטון הואprivate
והסרטון אף פעם לא פורסם. הנכס החדש לא כפוף למדיניות ההוצאה משימוש.
13 במרץ 2014
העדכון הזה כולל את השינויים הבאים:
-
ה-API תומך עכשיו בחלק
contentOwnerDetails
ל-channel
משאבים. החלק החדש מכיל נתונים על הערוץ שרלוונטיים לשותפי YouTube המקושרים לערוץ, כולל המזהה של בעלי התוכן המקושרים לערוץ והתאריך והשעה שבהם בעלי התוכן והערוץ קושרו. שימו לב שהחלק החדש לא כפוף למדיניות ההוצאה משימוש. -
התיעוד מפרט את אורך התווים המקסימלי הנתמך עבור המאפיינים הבאים:
משאב מאפיין (property) אורך מקסימלי channel
invideoPromotion.items[].customMessage
40 תווים video
snippet.title
100 תווים video
snippet.description
5,000 בייטים video
snippet.tags
500 תווים חשוב לשים לב שערך המאפיין הוא רשימה ושהפסיקים בין הפריטים ברשימה נספרים כחלק מהמגבלה. -
המאפיין
brandingSettings.watch.featuredPlaylistId
של המשאבchannel
הוצא משימוש. ה-API יחזיר שגיאה אם תנסו להגדיר את הערך שלו. -
מאפייני המשאבים הבאים של
video
נוספו לרשימת הערכים שניתן להגדיר כאשר מוסיפים או מעדכנים סרטון: -
תיעוד השגיאות מציין עכשיו את קוד התגובה של ה-HTTP לכל סוג שגיאה.
-
ה-API תומך עכשיו בשגיאות הבאות:
סוג השגיאה פרטי השגיאה תיאור badRequest (400)
invalidCriteria
השיטה channels.list
מחזירה את השגיאה הזו אם הבקשה מציינת פרמטרים של סינון שלא ניתן להשתמש בהם בשילוב עם זה.badRequest (400)
channelTitleUpdateForbidden
השיטה channels.update
מחזירה את השגיאה הזו אם מנסים לעדכן את החלקbrandingSettings
של ערוץ ולשנות את הערך של המאפייןbrandingSettings.channel.title
. (שימו לב שה-API לא מחזיר את השגיאה אם משמיטים את המאפיין).badRequest (400)
invalidRecentlyUploadedBy
השיטה channels.update
מחזירה את השגיאה הזו אם המאפייןinvideoPromotion.items[].id.recentlyUploadedBy
מציין מזהה ערוץ לא חוקי.badRequest (400)
invalidTimingOffset
השיטה channels.update
מחזירה את השגיאה הזו אם החלקinvideoPromotion
מציין קיזוז תזמון לא חוקי.badRequest (400)
tooManyPromotedItems
השיטה channels.update
מחזירה את השגיאה הזו אם החלקinvideoPromotion
מציין יותר ממספר הפריטים המקודמים המותר.forbidden (403)
promotedVideoNotAllowed
השיטה channels.update
מחזירה את השגיאה הזו אם המאפייןinvideoPromotion.items[].id.videoId
מציין מזהה וידאו שלא ניתן למצוא או שאי אפשר להשתמש בו כפריט מקודם.forbidden (403)
websiteLinkNotAllowed
השיטה channels.update
מחזירה את השגיאה הזו אם המאפייןinvideoPromotion.items[].id.websiteUrl
מציין כתובת URL אסורה.required (400)
requiredTimingType
השיטה channels.update
מחזירה את השגיאה הזו אם בקשה לא מציינת הגדרות ברירת מחדל לתזמון, למקרים שבהם יש להציג פריט מקודם ב-YouTube.required (400)
requiredTiming
השיטה channels.update
חייבת לציין אובייקטinvideoPromotion.items[].timing
לכל פריט שמקודם.required (400)
requiredWebsiteUrl
השיטה channels.update
חייבת לציין מאפייןinvideoPromotion.items[].id.websiteUrl
לכל פריט מקודם.badRequest (400)
invalidPublishAt
השיטה videos.insert
מחזירה את השגיאה הזו אם המטא-נתונים של הבקשה מציינים זמן פרסום מתוזמן לא חוקי.
4 במרץ 2014
העדכון הזה כולל את השינויים הבאים:
-
גרסה 3 של YouTube Data API כפופה עכשיו למדיניות ההוצאה משימוש שמתוארת בתנאים ובהגבלות של YouTube APIs. שימו לב: בדף שבו מופיעה רשימת ממשקי ה-API שכפופים למדיניות ההוצאה משימוש מוחרגת באופן ספציפי מהמדיניות הזו פונקציונליות של ה-API בגרסה 3.
5 בדצמבר 2013
העדכון הזה כולל את השינויים הבאים:
-
המסמכים של השיטה
search.list
עודכנו כדי לשקף כראוי את העובדה שאין צורך לציין ערך לפרמטר מסנן אחד בדיוק כששולחים בקשת חיפוש. במקום זאת, אפשר להגדיר ערך עבור פרמטר סינון אפס או פרמטר מסנן אחד. -
ההגדרות של הפרמטרים של השיטה
search.list
עודכנו, ועכשיו צריך להגדיר את ערך הפרמטרtype
ל-video
אם מציינים ערך גם לאחד מהפרמטרים הבאים:eventType
videoCaption
videoCategoryId
videoDefinition
videoDimension
videoDuration
videoEmbeddable
videoLicense
videoSyndicated
videoType
-
הגודל המינימלי של תמונות באנר של ערוצים שהועלו הוקטן ל-2,048 פיקסלים על 1152 פיקסלים. (בעבר, הגודל המינימלי היה 2120 פיקסלים על 1192 פיקסלים). בנוסף, חשוב לשים לב שבתיעוד המשאבים של
channel
מצוינים הגדלים המקסימליים של כל תמונות הבאנר שיוצגו דרך ה-API. לדוגמה, הגודל המקסימלי של תמונה בגודלbrandingSettings.image.bannerTvImageUrl
באפליקציות טלוויזיה הוא 2120 פיקסלים על 1192 פיקסלים, אבל התמונה עצמה יכולה להיות בגודל של 2,048 על 1152 פיקסלים. במרכז העזרה של YouTube תוכלו למצוא הנחיות נוספות לאופטימיזציה של עיצוב הערוץ להצגה במכשירים שונים. -
עודכנו כמה הגדרות של נכסי משאבים ב-
channel
כדי לשקף את המידע הבא:- האורך המקסימלי של ערך המאפיין
brandingSettings.channel.description
הוא 1,000 תווים. - האורך המקסימלי של המאפיין
brandingSettings.channel.featuredChannelsTitle
הוא 30 תווים. - הנכס
brandingSettings.channel.featuredChannelsUrls[]
יכול עכשיו לפרט עד 100 ערוצים. - ערך המאפיין
brandingSettings.channel.unsubscribedTrailer
, אם הוגדר, חייב לציין את מזהה הווידאו ב-YouTube של סרטון גלוי לכולם או לא רשום שנמצא בבעלות הבעלים של הערוץ.
- האורך המקסימלי של ערך המאפיין
-
השיטה
channels.update
תומכת עכשיו בעדכונים של הנכסinvideoPromotion.items[].promotedByContentOwner
. המאפיין הזה מציין אם השם של בעלי התוכן יוצג כשקידום המכירות יוצג. אפשר להגדיר אותה רק אם בקשת ה-API שמגדירה את ערך הנכס מתבצעת בשמו של בעלי התוכן באמצעות הפרמטרonBehalfOfContentOwner
. -
השיטות
playlistItems.list
ו-playlistItems.insert
תומכות עכשיו בפרמטרonBehalfOfContentOwner
, שכבר נתמך בכמה שיטות נוספות. -
הנכס
contentDetails.contentRating.acbRating
יכול עכשיו לציין סיווג מהמועצה האוסטרלית לסיווג (ACB) לסרטים או מהרשות האוסטרלית לתקשורת ומדיה (ACMA) לתוכניות טלוויזיה לילדים. -
המאפיינים החדשים
contentDetails.contentRating.catvRating
ו-contentDetails.contentRating.catvfrRating
מזהים את הסיווגים של סרטון שהתקבל במערכת הסיווג הקנדית לטלוויזיה ובמערכת הדירוג Régie du cinéma בצרפתית, המשמשים בקוויבק, בהתאמה. -
המאפיין החדש
snippet.assignable
של המשאבvideoCategory
מציין אם ניתן לשייך סרטונים שעודכנו או סרטונים חדשים שהועלו לקטגוריה הזו. -
דוגמאות קוד נוספו לשיטות הבאות:
activities.insert
(התחלה)channelBanners.insert
(Python)channels.update
(Python)playlistItems.list
(התחלה)search.list
(התחלה)thumbnails.set
(Java)videos.insert
(התחלה)
24 באוקטובר 2013
העדכון הזה כולל את השינויים הבאים:
-
ממשק ה-API כולל שתי תכונות נוספות שנועדו לעזור באיתור ובהצגה של תוכן בשידור חי:
המאפיין החדש
snippet.liveBroadcastContent
בתוצאות החיפוש מציין אם למשאב של סרטון או של ערוץ יש תוכן בשידור חי. ערכי הנכס החוקיים הםupcoming
,active
ו-none
.-
המאפיין
snippet.liveBroadcastContent
החדש של המשאבvideo
מציין אם הסרטון הוא שידור חי קרוב או שידור חי פעיל. ברשימה הבאה מפורטים הערכים האפשריים של הנכס:upcoming
– הסרטון הוא שידור חי שעדיין לא התחיל.active
– הסרטון הוא שידור חי מתמשך.none
– הסרטון לא משודר בשידור חי בקרוב או פעיל. זה יהיה ערך המאפיין של שידורים שהושלמו שעדיין ניתן לצפות בהם ב-YouTube.
-
המאפיין החדש
liveStreamingDetails
של המשאבvideo
הוא אובייקט שמכיל מטא-נתונים לגבי שידור וידאו בשידור חי. כדי לאחזר את המטא-נתונים האלה, צריך לכלול את הערךliveStreamingDetails
ברשימת חלקי המשאבים של ערך הפרמטרpart
. המטא-נתונים כוללים את המאפיינים החדשים הבאים:liveStreamingDetails.actualStartTime
– השעה שבה השידור התחיל בפועל. (הערך הזה יוצג ברגע שמצב השידור הואactive
).liveStreamingDetails.actualEndTime
– השעה שבה השידור הסתיים בפועל. (הערך הזה יוצג בסיום השידור).liveStreamingDetails.scheduledStartTime
– השעה שבה השידור מתוזמן להתחיל.liveStreamingDetails.scheduledEndTime
– השעה שבה השידור אמור להסתיים. אם ערך המאפיין ריק או לא קיים, השידור מתוזמן להימשך ללא הגבלת זמן.liveStreamingDetails.concurrentViewers
– מספר האנשים שצופים בשידור החי.
כדי לאחזר את המטא-נתונים האלה, יש לכלול
liveStreamingDetails
בערך הפרמטרpart
כשמפעילים את השיטהvideos.list
,videos.insert
אוvideos.update
.
לתשומת ליבך, שתי תכונות נוספות לזיהוי תוכן בשידור חי פורסמו ב-1 באוקטובר 2013 – הפרמטר
eventType
של שיטתsearch.list
והמאפייןsnippet.liveBroadcastContent
של תוצאת החיפוש. -
-
השיטה
videos.insert
תומכת עכשיו בפרמטרnotifySubscribers
, שמציין אם מערכת YouTube צריכה לשלוח התראה על הסרטון החדש למשתמשים שנרשמים לערוץ של הסרטון. ערך ברירת המחדל של הפרמטר הואTrue
, שמציין שהמנויים יקבלו התראה על סרטונים חדשים שיועלו. עם זאת, ייתכן שבעלים של ערוץ שמעלה סרטונים רבים יעדיף להגדיר את הערך ל-False
כדי להימנע משליחת התראה על כל סרטון חדש למנויים של הערוץ. -
רשימת המאפיינים שניתן לשנות כשמבצעים קריאה ל-method
channels.update
עודכנה כך שתכלול את המאפייניםinvideoPromotion.items[].customMessage
ו-invideoPromotion.items[].websiteUrl
. בנוסף, הרשימה שונתה כדי לזהות את מאפייניbrandingSettings
שניתנים לשינוי. כבר אפשר לשנות את מאפייניbrandingSettings
האלה, ולכן השינוי בתיעוד לא משקף שינוי בפונקציונליות הקיימת של ה-API. -
השיטות
playlists.insert
,playlists.update
ו-playlists.delete
תומכות עכשיו בפרמטרonBehalfOfContentOwner
, שכבר נתמך בכמה שיטות נוספות. -
השיטה
playlists.insert
תומכת עכשיו בפרמטרonBehalfOfContentOwnerChannel
, שכבר נתמך בכמה שיטות אחרות. -
המאפיין
contentDetails.contentRating.tvpgRating
של המשאבvideo
תומך עכשיו בערך שלpg14
שתואם לדירוג שלTV-14
. -
ההגדרה של המאפיין
snippet.liveBroadcastContent
, שהוא חלק מתוצאות החיפוש, תוקנה כך ש-live
הוא ערך מאפיין חוקי, אבלactive
אינו ערך מאפיין חוקי. -
המאפיין
contentDetails.contentRating.mibacRating
של המשאבvideo
תומך עכשיו בשני דירוגים נוספים:mibacVap
(VAP) – ילדים חייבים בליווי מבוגר.mibacVm6
(V.M.6) – מוגבל לגילאי 6 ומעלה.mibacVm12
(V.M.12) – מוגבל לגיל 12 ומעלה.
-
המאפיין החדש
invideoPromotion.items[].promotedByContentOwner
של המשאבchannel
מציין אם השם של בעלי התוכן יוצג כשקידום המכירות יוצג. ניתן להגדיר את השדה הזה רק אם בקשת ה-API שמגדירה את הערך מתבצעת בשם בעלי התוכן. מידע נוסף זמין בפרמטרonBehalfOfContentOwner
.
1 באוקטובר 2013
העדכון הזה כולל את השינויים הבאים:
-
האובייקט
auditDetails
החדש של המשאבchannel
מכיל נתוני ערוץ שרשת מרובת ערוצים (MCN) תעריך כדי לקבוע אם לאשר או לדחות ערוץ מסוים. הערה: כל בקשת API שמאחזרת את החלק הזה של המשאב חייבת לספק אסימון הרשאה שמכיל את ההיקףhttps://www.googleapis.com/auth/youtubepartner-channel-audit
. בנוסף, יש לבטל כל אסימון שמוגדר בו ההיקף הזה כשרשת ה-MCN מחליטה לאשר או לדחות את הערוץ, או בתוך שבועיים ממועד הנפקת האסימון. -
המאפיין
invideoPromotion.items[].id.type
של המשאבchannel
תומך עכשיו בערך שלrecentUpload
, שמציין שהפריט המקודם הוא הסרטון האחרון שהועלה מערוץ מסוים.כברירת מחדל, הערוץ זהה לערוץ שעבורו מוגדרים נתוני קידום מכירות בתוך הסרטון. עם זאת, אפשר לקדם את הסרטון האחרון שהועלה מערוץ אחר על ידי הגדרת הערך של נכס
invideoPromotion.items[].id.recentlyUploadedBy
החדש למזהה הערוץ של אותו ערוץ. -
המשאב
channel
מכיל שלושה מאפיינים חדשים –brandingSettings.image.bannerTvLowImageUrl
,brandingSettings.image.bannerTvMediumImageUrl
,brandingSettings.image.bannerTvHighImageUrl
– שמציינים את כתובות ה-URL של תמונות הבאנר שמוצגות בדפי ערוצים באפליקציות לטלוויזיה. -
המאפיין החדש
snippet.liveBroadcastContent
בתוצאות החיפוש מציין אם למשאב של סרטון או של ערוץ יש תוכן בשידור חי. ערכי הנכס החוקיים הםupcoming
,active
ו-none
.- למשאב
video
, הערךupcoming
מציין שהסרטון הוא שידור חי שעדיין לא התחיל, ואילו ערך שלactive
מציין שהסרטון הוא שידור חי מתמשך. - למשאב
channel
, הערךupcoming
מציין שלערוץ יש שידור מתוזמן שעדיין לא התחיל, ואילו ערך שלacive
מציין שלערוץ יש שידור חי מתמשך.
- למשאב
-
במשאב
watermark
, המאפייןtargetChannelId
השתנה מאובייקט למחרוזת. במקום לכלול נכס צאצא שמציין את מזהה הערוץ ב-YouTube של הערוץ שאליו מקשרת תמונת סימן המים, הנכסtargetChannelId
מציין עכשיו את הערך עצמו. לכן, המאפייןtargetChannelId.value
של המשאב הוסר. -
השיטה
thumbnails.set
תומכת עכשיו בפרמטרonBehalfOfContentOwner
, שכבר נתמך בכמה שיטות אחרות. -
השיטה
search.list
תומכת עכשיו בפרמטרeventType
, שמגביל חיפוש כך שיחזיר רק אירועי שידור פעילים, אירועים קרובים או אירועים שהושלמו. -
הנכס החדש ב-
contentDetails.contentRating.mibacRating
מציין את הדירוג שקיבל סרטון מ-Ministero dei Beni e delle Attivita Culturei e del Turismo מאיטליה. -
ה-API תומך עכשיו בשגיאות הבאות:
סוג השגיאה פרטי השגיאה תיאור badRequest
invalidImage
השיטה thumbnails.set
מחזירה את השגיאה הזו אם תוכן התמונה שסופק לא תקין.forbidden
videoRatingDisabled
השיטה videos.rate
מחזירה את השגיאה הזו אם הבעלים של הסרטון שאתם מדרגים השבית את הדירוגים שלו.
27 באוגוסט 2013
העדכון הזה כולל את השינויים הבאים:
-
המשאב החדש
watermark
מזהה תמונה שמוצגת בזמן הפעלת סרטונים של ערוץ מסוים. תוכלו גם לציין ערוץ יעד שאליו התמונה תקושר, וכן פרטי תזמון שקובעים מתי סימן המים יופיע במהלך הפעלות של סרטונים, ולמשך הזמן שבו הוא יהיה גלוי.השיטה
watermarks.set
מעלה ומגדירה תמונה של סימן מים בערוץ. השיטהwatermarks.unset
מוחקת את תמונת סימן המים של הערוץ.תיעוד השגיאות מתאר את הודעות השגיאה שנתמכות ב-API באופן ספציפי עבור השיטות
watermarks.set
ו-watermarks.unset
. -
המאפיין החדש
statistics.hiddenSubscriberCount
של המשאבchannel
מכיל ערך בוליאני שמציין אם מספר המנויים של הערוץ מוסתר. לכן, ערך הנכס הואfalse
אם מספר המנויים בערוץ גלוי לכולם. -
השיטה
playlists.list
תומכת עכשיו בפרמטריםonBehalfOfContentOwner
ו-onBehalfOfContentOwnerChannel
. שני הפרמטרים כבר נתמכים בכמה שיטות אחרות. -
השיטה
videos.list
תומכת עכשיו בפרמטרregionCode
, שמזהה את אזור התוכן שעבורו יש לאחזר את התרשים. אפשר להשתמש בפרמטר הזה רק בשילוב עם הפרמטרchart
. ערך הפרמטר הוא קוד מדינה לפי תקן ISO 3166-1 alpha-2. -
ב-
error documentation
מתוארת שגיאת הבקשה השכיחה הבאה, שעלולה לקרות במספר שיטות API:סוג השגיאה פרטי השגיאה תיאור forbidden
insufficientPermissions
ההיקפים המשויכים לאסימון OAuth 2.0 שסופק עבור הבקשה לא מספיקים כדי לגשת לנתונים המבוקשים.
15 באוגוסט 2013
העדכון הזה כולל את השינויים הבאים:
-
לאובייקט
invideoPromotion
של המשאבchannel
יש את המאפיינים החדשים והמעודכנים הבאים:-
עכשיו ה-API תומך באפשרות לציין אתר כפריט מקודם. כדי לעשות את זה, צריך להגדיר את ערך המאפיין
invideoPromotion.items[].id.type
ל-website
ולהשתמש בנכסinvideoPromotion.items[].id.websiteUrl
החדש כדי לציין את כתובת ה-URL. צריך להשתמש בנכסinvideoPromotion.items[].customMessage
החדש גם כדי להגדיר הודעה מותאמת אישית שתוצג עבור המבצע.הקישורים יכולים להיות אתרים משויכים, אתרים של מוכרים או רשתות חברתיות. אפשר לעיין בהוראות של מרכז העזרה של YouTube לאתרים משויכים ולאתרי מוכרים כדי לקבל מידע נוסף על הפעלת קישורים לתוכן שלכם.
הוספת קישורים שיווקיים מבטאת את הסכמתך לכך שהקישורים האלה לא ישמשו להפניה אוטומטית לאתרים לא מורשים, ולכך שהקישורים האלה יעמדו בדרישות של מדיניות AdWords, המדיניות של YouTube בנושא מודעות, הנחיות הקהילה של YouTube והתנאים וההגבלות של YouTube.
-
שינו מחדש את המאפיינים הקשורים להגדרות התזמון להצגת פריטים מקודמים במהלך הפעלת סרטון:
-
האובייקט
invideoPromotion.timing
הועבר אלinvideoPromotion.items[].timing
. האובייקט הזה מאפשר עכשיו להתאים אישית את נתוני התזמון של כל פריט מקודם ברשימהinvideoPromotion.items[]
. -
האובייקט
invideoPromotion.defaultTiming
החדש מציין הגדרות ברירת מחדל לתזמון של הקידום. ההגדרות האלה קובעות מתי פריט מקודם יוצג במהלך ההפעלה של אחד מהסרטונים בערוץ. אפשר לשנות את תזמון ברירת המחדל של כל פריט מקודם באמצעות האובייקטinvideoPromotion.items[].timing
. -
המאפיין
invideoPromotion.items[].timing.durationMs
החדש מציין את משך הזמן (באלפיות שנייה) שקידום המכירות יוצג. האובייקטinvideoPromotion.defaultTiming
מכיל גם שדהdurationMs
שמציין את משך הזמן שמוגדר כברירת מחדל לפריט המקודם.
-
-
המאפיינים
invideoPromotion.items[].type
ו-invideoPromotion.items[].videoId
הועברו אל האובייקטinvideoPromotion.items[].id
.
-
-
השיטה
subscriptions.list
תומכת עכשיו בפרמטריםonBehalfOfContentOwner
ו-onBehalfOfContentOwnerChannel
. שני הפרמטרים כבר נתמכים בכמה שיטות אחרות. -
בתגובת ה-API לבקשת
thumbnails.set
, הערך של המאפייןkind
השתנה מ-youtube#thumbnailListResponse
ל-youtube#thumbnailSetResponse
. -
דוגמאות קוד נוספו לשיטות הבאות:
channels.update
(Java, Python)playlists.insert
(.NET, PHP)subscriptions.insert
(PHP, Python)thumbnails.set
(PHP, Python)videos.insert
(PHP)videos.list
(PHP)videos.rate
(Python)videos.update
(Java, PHP, Python)
הערה: גם דוגמת Python לשיטה
playlistItems.insert
הוסרה כי הפונקציונליות שהודגמה מטופלת עכשיו על ידי שיטתvideos.rate
. -
ב-
error documentation
מתוארת השגיאה החדשה בהקשר של הבקשה. השגיאה הזו עלולה לקרות בכל שיטת API שתומכת בפרמטר הבקשהmine
:סוג השגיאה פרטי השגיאה תיאור badRequest
invalidMine
לא ניתן להשתמש בפרמטר mine
בבקשות שבהן המשתמש המאומת הוא שותף YouTube. עליך להסיר את הפרמטרmine
, לבצע אימות כמשתמש YouTube על ידי הסרת הפרמטרonBehalfOfContentOwner
, או לפעול כאחד מערוצי השותף ולספק את הפרמטרonBehalfOfContentOwnerChannel
אם הוא זמין לשיטה שנקראת.
8 באוגוסט 2013
העדכון הזה כולל את השינויים הבאים:
-
הקטע Quota Usage במדריך תחילת העבודה עם YouTube Data API עודכן כדי לשקף את השינוי בעלויות המכסה של העלאת סרטון, מכ-16,000 יחידות לכ-1,600 יחידות.
30 ביולי 2013
העדכון הזה כולל את השינויים הבאים:
-
במשאב
channelBanner
, ערך הערך של המאפייןkind
השתנה מ-youtube#channelBannerInsertResponse
ל-youtube#channelBannerResource
. המשאב הזה מוחזר בתגובה לבקשתchannelBanners.insert
. -
המאפיין
brandingSettings.channel.profileColor
החדש של המשאבchannel
מציין צבע בולט שמשלים את תוכן הערוץ. ערך המאפיין הוא סימן פאונד (#
) ואחריו מחרוזת הקסדצימלית בת שישה תווים, כגון#2793e6
. -
ממשק ה-API תומך עכשיו באפשרות לציין אם המינוי מיועד לכל הפעילויות של הערוץ, או רק להעלאות חדשות. המאפיין החדש
contentDetails.activityType
של המשאבsubscription
מזהה את סוגי הפעילויות שהמנוי יקבל עליהן התראות. ערכי הנכס החוקיים הםall
ו-uploads
. -
השיטה
videos.list
תומכת בפרמטרים חדשים לאחזור תרשים של הסרטונים הפופולריים ביותר ב-YouTube:- הפרמטר
chart
מזהה את התרשים שרוצים לאחזר. בשלב הזה, הערך הנתמך היחיד הואmostPopular
. חשוב לשים לב שהפרמטרchart
הוא פרמטר של מסנן, לכן אי אפשר להשתמש בו באותה בקשה כמו פרמטרים אחרים של סינון (id
ו-myRating
). - הפרמטר
videoCategoryId
מזהה את קטגוריית הסרטון שעבורה יש לאחזר את התרשים. אפשר להשתמש בפרמטר הזה רק בשילוב עם הפרמטרchart
. כברירת מחדל, התרשימים אינם מוגבלים לקטגוריה מסוימת.
- הפרמטר
-
מאפיין
topicDetails.relevantTopicIds[]
החדש של המשאבvideo
מספק רשימה של מזהי נושאים של Freebase שרלוונטיים לסרטון או לתוכן שלו. ייתכן שהנושאים של הנושאים האלה מוזכרים בסרטון או יופיעו בו. -
שם המאפיין
recordingDetails.location.elevation
של המשאבvideo
השתנה ל-recordingDetails.location.altitude
, והמאפייןfileDetails.recordingLocation.location.elevation
שלו השתנה ל-fileDetails.recordingLocation.location.altitude
. -
האובייקט
contentDetails.contentRating
של המשאבvideo
מציין את הסיווגים שסרטון קיבל במסגרת סכימות סיווג שונות, כולל דירוגי MPAA, דירוגי TVPG וכן הלאה. לכל מערכת סיווג, ה-API תומך עכשיו בערך סיווג שמציין שלא בוצע דירוג לסרטון. שימו לב: לגבי סיווגי תוכן של MPAA, סיווג 'ללא דירוג' משמש לעיתים קרובות לזיהוי גרסאות לא חתוכות של סרטים שהגרסה החתוכה של הסרט כן קיבלה דירוג רשמי. -
המאפיין החדש
contentDetails.contentRating.ytRating
של המשאבvideo
מזהה תוכן שחלה עליו הגבלת גיל. ערך המאפיין יהיהytAgeRestricted
אם המערכת של YouTube תזהה שהסרטון מכיל תוכן שלא מתאים למשתמשים מתחת לגיל 18. אם הנכס חסר או אם ערך הנכס ריק, המשמעות היא שהתוכן לא זוהה כהגבלת גיל. -
הפרמטר
mySubscribers
של שיטת הבידינגchannels.list
הוצא משימוש. שימוש בשיטהsubscriptions.list
ובפרמטרmySubscribers
שלה כדי לאחזר רשימת מנויים לערוץ של המשתמש המאומת. -
השיטות
channelBanners.insert
,channels.update
,videos.getRating
וגםvideos.rate
תומכות עכשיו בפרמטרonBehalfOfContentOwner
. הפרמטר הזה מציין שהמשתמש המאומת פועל מטעם בעלי התוכן שצוינו בערך הפרמטר. -
המסמכים של השיטה
channels.update
עודכנו כדי לשקף את העובדה שאפשר להשתמש בשיטה הזו כדי לעדכן את אובייקטbrandingSettings
של המשאבchannel
ואת מאפייני הצאצא שלו. במסמכי התיעוד מופיעה גם רשימת המאפיינים המעודכנת שאפשר להגדיר לאובייקטinvideoPromotion
של המשאבchannel
. -
השגיאות החדשות הבאות מתוארות ב
error documentation
:סוג השגיאה פרטי השגיאה תיאור forbidden
accountDelegationForbidden
השגיאה הזו לא ספציפית לשיטת API מסוימת. המשמעות היא שהמשתמש המאומת אינו מורשה לפעול בשם חשבון Google שצוין. forbidden
authenticatedUserAccountClosed
השגיאה הזו לא ספציפית לשיטת API מסוימת. היא מציינת שחשבון YouTube של המשתמש המאומת נסגר. אם המשתמש פועל מטעם חשבון Google אחר, השגיאה הזו תציין שהחשבון האחר סגור. forbidden
authenticatedUserAccountSuspended
השגיאה הזו לא ספציפית לשיטת API מסוימת. היא מציינת שחשבון YouTube של המשתמש המאומת מושעה. אם המשתמש פועל מטעם חשבון Google אחר, השגיאה הזו תציין שהחשבון האחר מושעה. forbidden
authenticatedUserNotChannel
השגיאה הזו לא ספציפית לשיטת API מסוימת. היא מציינת ששרת ה-API לא יכול לזהות את הערוץ שמשויך לבקשת ה-API. אם הבקשה מורשית ומשתמשת בפרמטר onBehalfOfContentOwner
, עליך להגדיר גם את הפרמטרonBehalfOfContentOwnerChannel
.forbidden
cmsUserAccountNotFound
השגיאה הזו לא ספציפית לשיטת API מסוימת. משתמש ה-CMS אינו מורשה לפעול בשם בעלי התוכן שצוינו. notFound
contentOwnerAccountNotFound
השגיאה הזו לא ספציפית לשיטת API מסוימת. החשבון של בעלי התוכן שצוין לא נמצא. badRequest
invalidPart
השגיאה הזו לא ספציפית לשיטת API מסוימת. הפרמטר part
של הבקשה מציין חלקים שאי אפשר לכתוב יחד.badRequest
videoChartNotFound
השיטה videos.list
מחזירה את השגיאה הזו כאשר הבקשה מציינת תרשים וידאו לא נתמך או לא זמין.notFound
videoNotFound
השיטה videos.update
מחזירה את השגיאה הזו כדי לציין שלא ניתן למצוא את הסרטון שאתם מנסים לעדכן. יש לבדוק את הערך של המאפייןid
בגוף הבקשה כדי לוודא שהוא נכון.
10 ביוני 2013
העדכון הזה כולל את השינויים הבאים:
-
הפרמטר
forUsername
החדש של השיטהchannels.list
מאפשר לאחזר מידע על ערוץ על ידי ציון שם המשתמש שלו ב-YouTube. -
השיטה
activities.list
תומכת עכשיו בפרמטרregionCode
, שמורה ל-API להחזיר תוצאות שרלוונטיות למדינה שצוינה. המערכת של YouTube משתמשת בערך הזה כשהפעילות הקודמת של המשתמש המורשה ב-YouTube לא מספקת מספיק מידע כדי ליצור את פיד הפעילות. -
משאבי הפלייליסט מכילים עכשיו את הנכס
snippet.tags
. הנכס יוחזר רק למשתמשים מורשים שמאחזרים נתונים על הפלייליסטים שלהם. משתמשים מורשים יכולים גם להגדיר תגי פלייליסט כשמפעילים את השיטהplaylists.insert
אוplaylists.update
. -
הפרמטר
onBehalfOfContentOwner
, שנתמך בעבר בשיטותchannels.list
ו-search.list
, נתמך עכשיו גם בשיטותvideos.insert
,videos.update
ו-videos.delete
. הערה: כשמשתמשים בפרמטר הזה בקריאה ל-methodvideos.insert
, הבקשה צריכה גם לציין ערך לפרמטר החדשonBehalfOfContentOwnerChannel
, שמזהה את הערוץ שאליו יתווסף הסרטון. הערוץ חייב להיות מקושר לבעלי התוכן שצוין בפרמטרonBehalfOfContentOwner
.הפרמטר מציין שפרטי הכניסה של ההרשאה של הבקשה מזהים משתמש YouTube CMS שפועל בשם בעלי התוכן שצוינו בערך הפרמטר. חשבון ה-CMS שאיתו המשתמש מבצע אימות חייב להיות מקושר לבעלי התוכן שצוינו ב-YouTube.
הפרמטר הזה מיועד לשותפי תוכן שהם הבעלים והמנהלים של ערוצי YouTube רבים ושונים. הפרמטר מאפשר לשותפים האלה לבצע אימות פעם אחת ולקבל גישה לכל נתוני הסרטונים והערוץ, בלי שיצטרכו לספק פרטי כניסה לאימות עבור כל ערוץ בנפרד.
באופן ספציפי בגרסה הזו, הפרמטר מאפשר לשותף תוכן להוסיף, לעדכן או למחוק סרטונים בכל אחד מערוצי YouTube שבבעלות השותף.
-
השגיאות החדשות הבאות מתוארות ב
error documentation
:סוג השגיאה פרטי השגיאה תיאור forbidden
insufficientCapabilities
השגיאה הזו לא ספציפית לשיטת API מסוימת. הסטטוס מציין שלמשתמש מערכת ניהול התוכן שקורא ל-API אין הרשאות מספיקות לביצוע הפעולה המבוקשת. השגיאה הזו משויכת לשימוש בפרמטר onBehalfOfContentOwner
, שנתמך בכמה שיטות API.unauthorized
authorizationRequired
השיטה activities.list
מחזירה את השגיאה הזו כשהבקשה משתמשת בפרמטרhome
אבל לא אושרה כראוי. -
במשאב
channels
, המאפייןinvideoPromotion.channelId
הוסר כי מזהה הערוץ כבר צוין באמצעות המאפייןid
של המשאב. -
במדריך החדש עבודה עם מזהי ערוצים מוסבר איך ה-API משתמש במזהי ערוצים. המדריך עשוי להיות שימושי במיוחד למפתחים שעוברים מהגרסה הקודמת של ה-API, ושיש להם אפליקציות שמבקשות תוכן עבור המשתמש ב-
default
או שמסתמכות על הרעיון שלכל ערוץ YouTube יש שם משתמש ייחודי, שכבר אינו המצב.
22 במאי 2013
העדכון הזה כולל את השינויים הבאים:
-
השיטה החדשה
channelBanners.insert
מאפשרת להעלות תמונת באנר שאפשר להגדיר בהמשך כתמונת הבאנר של ערוץ באמצעות המאפייןbrandingSettings.image.bannerExternalUrl
החדש של המשאבchannel
. -
התיעוד של השיטה
channels.update
עודכן כדי להציג את המאפיינים שניתן לשנות בזמן הקריאה לשיטה. -
תיעוד המשאבים של
video
לא מציין יותר אתunspecified
כערך מאפיין חוקי בנכסיםsuggestions.processingErrors[]
,suggestions.processingHints[]
,suggestions.processingWarnings[]
ו-suggestions.editorSuggestions[]
. -
ערך ברירת המחדל של הפרמטר
maxResults
של השיטהvideos.list
הוא5
. -
ב-
error documentation
מפורטות עכשיו שגיאות בשיטותchannelBanners.insert
ו-subscriptions.list
. כמו כן, מפורטות מספר שגיאות חדשות עבור השיטהchannels.update
.
14 במאי 2013
העדכון הזה כולל את השינויים הבאים:
-
בדפים עצמאיים יש עכשיו דוגמאות קוד ל-Java , .NET , PHP ו-Ruby.
-
הדף שמציג את דוגמאות הקוד של Python כולל עכשיו דוגמאות להוספת מינוי, ליצירת פלייליסט ולעדכון סרטון.
10 במאי 2013
העדכון הזה כולל את השינויים הבאים:
-
YouTube כבר לא מזהה תכונות ושירותים ניסיוניים של ממשקי API. במקום זאת, אנחנו מספקים עכשיו רשימה של ממשקי API של YouTube שכפופים למדיניות ההוצאה משימוש.
8 במאי 2013
העדכון הזה כולל את השינויים הבאים:
-
משאבי הערוץ תומכים עכשיו באובייקט
inVideoPromotion
, שכולל מידע על קמפיין לקידום מכירות שמשויך לערוץ. ערוץ יכול להשתמש בקמפיין קידום מכירות בתוך הסרטון כדי להציג תמונות ממוזערות של סרטון מקודם בנגן הווידאו בזמן הפעלת הסרטונים בערוץ.כדי לאחזר את הנתונים האלה, אפשר לכלול את הערך
invideoPromotion
בערך הפרמטרpart
בבקשתchannels.list
. -
אפשר להשתמש בשיטה החדשה
channels.update
כדי לעדכן בערוץ את נתוני הקמפיינים לקידום מכירות של סרטונים. חשוב לשים לב שהשיטה תומכת רק בעדכונים לחלקinvideoPromotion
של המשאבchannel
, ועדיין לא תומכת בעדכונים לחלקים אחרים של המשאב הזה.
2 במאי 2013
העדכון הזה כולל את השינויים הבאים:
-
משאבי הערוץ תומכים עכשיו במאפיין
status.isLinked
, שמציין אם נתוני הערוץ מזהים משתמש שכבר מקושר לשם משתמש של YouTube או לחשבון Google+. למשתמש שקיבל אחד מהקישורים האלה כבר יש זהות ציבורית ב-YouTube, שהיא דרישה מוקדמת לביצוע כמה פעולות, כמו העלאת סרטונים. -
משאבי מינויים תומכים עכשיו בחלק
subscriberSnippet
. האובייקט הזה כולל נתוני קטעי קוד של הערוץ של המנוי. -
ה-API תומך עכשיו בשיטה
videos.getRating
, שמאחזרת את הדירוגים שהמשתמש המאומת העניק לרשימה של סרטון אחד או יותר. -
הפרמטר
myRating
החדש של השיטהvideos.list
מאפשר לאחזר רשימה של סרטונים שהמשתמש המאומת דירג בדירוגlike
אוdislike
.הפרמטר
myRating
והפרמטרid
נחשבים עכשיו לפרמטרים של סינון. פירוש הדבר הוא שבקשת API חייבת לציין בדיוק אחד מהפרמטרים. (בעבר, הפרמטרid
היה פרמטר נדרש לשיטה הזו.)השיטה מחזירה שגיאת
forbidden
עבור בקשות שמנסות לאחזר מידע על דירוג הסרטון, אבל לא מורשים לעשות זאת כראוי. -
עם השקת הפרמטר
myRating
, גם השיטהvideos.list
עודכנה כדי לתמוך בעימוד. עם זאת, חשוב לשים לב שפרמטרים של החלפה נתמכים רק לבקשות שמשתמשות בפרמטרmyRating
. (פרמטרים ומידע של החלפה לא נתמכים בבקשות שמשתמשות בפרמטרid
).-
הפרמטר
maxResults
מציין את המספר המקסימלי של סרטונים שה-API יכול להחזיר בקבוצת התוצאות, והפרמטרpageToken
מזהה דף ספציפי בקבוצת התוצאות שברצונך לאחזר. -
המשאב
youtube#videoListResponse
שמוחזר בתגובה לבקשתvideos.list
, מכיל עכשיו את האובייקטpageInfo
, שמכיל פרטים כמו המספר הכולל של התוצאות ומספר התוצאות שכלולות בקבוצת התוצאות הנוכחית. המשאבyoutube#videoListResponse
יכול לכלול גם את המאפייניםnextPageToken
ו-prevPageToken
, שכל אחד מהם מספק אסימון שיכול לשמש לאחזור דף ספציפי בקבוצת התוצאות.
-
-
השיטה
videos.insert
תומכת בפרמטרים החדשים הבאים:autoLevels
– מגדירים את ערך הפרמטר הזה ל-true
כדי שהמערכת של YouTube תשפר אוטומטית את התאורה והצבע של הסרטון.stabilize
– מגדירים את ערך הפרמטר הזה ל-true
כדי להנחות את YouTube להתאים את הסרטון על ידי הסרת הרעידות שנובעות מתנועות המצלמה.
-
הנכס
channelTitle
נוסף ל-snippet
עבור המשאבים הבאים:playlistItem
– המאפיין מציין את שם הערוץ שהוסיף את הפריט לפלייליסט.playlist
– המאפיין מציין את שם הערוץ שיצר את הפלייליסט.subscription
– הנכס מציין את שם הערוץ שנרשמת אליו.
-
דוגמאות קוד נוספו לשיטות הבאות:
activities.insert
(רובי)playlistItems.list
(.NET)search.list
(.NET)subscriptions.insert
(Java, Ruby)videos.insert
(.NET, Ruby)
-
הפרמטר
mySubscribers
החדש של השיטהsubscriptions.list
מאפשר לאחזר רשימה של המנויים של המשתמש המאומת הנוכחי. אפשר להשתמש בפרמטר הזה רק בבקשת הרשאה תקינה.הערה: הפונקציונליות הזו מיועדת להחליף את הפרמטר
mySubscribers
שנתמך כרגע בשיטהchannels.list
. הפרמטר הזה יצא משימוש. -
במשאב
video
, ערך המאפייןunspecified
כבר לא יהיה ערך אפשרי לאף אחד מהנכסים הבאים: -
בקשות API שמכילות פרמטר לא צפוי מחזירות עכשיו שגיאת
badRequest
, והסיבה המדווחת לשגיאה היאunexpectedParameter
. -
הודעת השגיאה שחוזרת על ידי השיטה
playlistItems.insert
כשהפלייליסט כבר מכיל את המספר המקסימלי של פריטים מותרים עודכן. השגיאה מדווחת עכשיו כשגיאהforbidden
וסיבת השגיאה היאplaylistContainsMaximumNumberOfVideos
.
19 באפריל 2013
העדכון הזה כולל את השינויים הבאים:
-
השיטה החדשה
videos.rate
מאפשרת למשתמש להגדיר סיווג שלlike
אוdislike
בסרטון, או להסיר ממנו סיווג.תיעוד השגיאות עודכן גם הוא ומפרט את השגיאות שה-API עשוי להחזיר בתגובה לקריאה ל-method
videos.rate
. -
תמונות ממוזערות מזוהות עכשיו במסמכי התיעוד של ה-API כמשאב נפרד, והשיטה החדשה
thumbnails.set
מאפשרת להעלות ל-YouTube תמונה ממוזערת מותאמת אישית של סרטון ולהגדיר אותה לסרטון.תיעוד השגיאות עודכן גם הוא ומפרט את השגיאות שה-API עשוי להחזיר בתגובה לקריאה ל-method
thumbnails.set
.שימו לב שהשינוי הזה לא משפיע בפועל על משאבים קיימים שמחזירים תמונות ממוזערות. תמונות ממוזערות מוחזרות למשאבים האלה באותו אופן שבו הן היו בעבר, אם כי בתיעוד עכשיו מופיעים השמות של הגדלים השונים של תמונות ממוזערות שה-API עשוי להחזיר.
-
החלק החדש של
brandingSettings
במשאבchannel
מזהה את ההגדרות, הטקסט והתמונות של דף הערוץ ודפי הצפייה של הסרטונים. -
המשאב
playlistItem
מכיל את המאפיינים החדשים הבאים:-
האובייקט
status
החדש כולל את פרטי הסטטוס של פריט הפלייליסט, והמאפייןstatus.privacyStatus
מזהה את סטטוס הפרטיות של הפריט.
-
-
המשאב
video
מכיל את המאפיינים החדשים הבאים:-
המאפיין
status.publicStatsViewable
מציין אם הנתונים הסטטיסטיים המורחבים של הסרטון בדף הצפייה גלויים לכולם. כברירת מחדל, ניתן להציג את הנתונים הסטטיסטיים האלה, ונתונים סטטיסטיים כמו ספירת הצפיות והדירוגים של סרטון ימשיכו להיות גלויים לכולם, גם אם ערך הנכס הזה מוגדר ל-false
. אפשר להגדיר את הערך של המאפיין הזה כשמבצעים קריאה לשיטהvideos.insert
אוvideos.update
. -
האובייקט
contentDetails.contentRating
כולל את הדירוגים שהסרטון קיבל במסגרת סכימות סיווג שונות. ברשימה שבהמשך מפורטות מערכות הסיווג הנתמכות, וקישור לנכס שמשויך לכל מערכת סיווג. בהגדרות הנכס מזוהים ערכי הסיווג הנתמכים בכל מערכת.מדינה מערכת הסיווג מאפיין (property) ארצות הברית Motion Picture Association of America (MPAA) contentDetails.contentRating.mpaaRating
ארצות הברית הנחיות להורים לגבי טלוויזיה contentDetails.contentRating.tvpgRating
אוסטרליה אוסטרליה לסיווג (ACB) contentDetails.contentRating.acbRating
ברזיל Ministryamento de Justiça, Classificação, Qualificação e Títulos contentDetails.contentRating.djctqRating
קנדה המערכת הקנדית לדירוג סרטונים ביתיים (CHVRS) contentDetails.contentRating.chvrsRating
צרפת Center National du cinéma et de l'image animée (משרד התרבות הצרפתי) contentDetails.contentRating.fmocRating
גרמניה Freiwillige Selbstkontrolle der Movieswirtschaft (FSK) contentDetails.contentRating.fskRating
בריטניה המועצה הבריטית לסיווג סרטים (BBFC) contentDetails.contentRating.bbfcRating
הודו Central Board of Movie Certification (CBFC) contentDetails.contentRating.cbfcRating
יפן 映倫管理委員及 (EIRIN) contentDetails.contentRating.eirinRating
קוריאה ☁⬼ אמורה הסתרת ודפים contentDetails.contentRating.kmrbRating
מקסיקו הממשלה הכללית של רדיו, טלוויזיה וסינמטוגרפיה (RTC) contentDetails.contentRating.rtcRating
ניו זילנד סיווג הסרטים והספרות contentDetails.contentRating.oflcRating
רוסיה מרשם הסרטים הלאומי של הפדרציה הרוסית contentDetails.contentRating.russiaRating
ספרד Instituto de la Syntografía y de las Artes Audiovisuales (ICAA) contentDetails.contentRating.icaaRating
-
-
המסמכים של השיטה
playlistItems.update
עודכנו כדי לשקף את העובדה שיש לציין את המאפייןsnippet.resourceId
במשאב שנשלח כגוף הבקשה. -
השיטה
search.list
תומכת עכשיו בפונקציות הבאות:-
הפרמטר
forMine
החדש מגביל את החיפוש לאחזור רק את הסרטונים של המשתמש המאומת. -
הפרמטר
order
תומך עכשיו באפשרות למיין תוצאות בסדר אלפביתי לפי שם (order=title
) או לפי מספר סרטונים בסדר יורד (order=videoCount
). -
הפרמטר
safeSearch
החדש מציין אם תוצאות החיפוש צריכות לכלול תוכן מוגבל.
-
-
השיטה
videos.insert
תומכת בכמה שגיאות חדשות, המפורטות בטבלה הבאה:סוג השגיאה פרטי השגיאה תיאור badRequest
invalidCategoryId
המאפיין snippet.categoryId
מציין מזהה קטגוריה לא חוקי. אפשר להשתמש בשיטהvideoCategories.list
כדי לאחזר קטגוריות נתמכות.badRequest
invalidRecordingDetails
metadata specifies invalid recording details.
badRequest
invalidVideoGameRating
המטא-נתונים של הבקשה מציינים סיווג לא חוקי של משחק וידאו. badRequest
invalidVideoMetadata
המטא-נתונים של הבקשה לא חוקיים. -
הפרמטר
onBehalfOfContentOwner
הוסר מרשימת הפרמטרים הנתמכים בשיטותvideos.update
ו-videos.delete
.
12 במרץ 2013
העדכון הזה כולל את השינויים הבאים:
-
הנכס
channelTitle
נוסף ל-snippet
עבור המשאבים הבאים: -
השיטה
search.list
תומכת בפרמטרים החדשים הבאים:-
הפרמטר
channelType
מאפשר להגביל חיפוש של ערוצים כדי לאחזר את כל הערוצים או לאחזר תוכניות בלבד. -
הפרמטר
videoType
מאפשר להגביל חיפוש של סרטונים כדי לאחזר את כל הסרטונים או לאחזר רק סרטים או פרקים של תוכניות.
-
-
ההגדרה של החלק
recordingDetails
של המשאבvideo
עודכנה כדי לציין שהאובייקט יוחזר עבור סרטון רק אם הוגדרו נתוני מיקום גיאוגרפי או זמן צילום של הסרטון. -
השיטה
playlistItems.update
מחזירה עכשיו שגיאתinvalidSnippet
, שמוחזרת אם בקשת ה-API לא מציינת קטע קוד חוקי. -
כמה שיטות API תומכות בפרמטרים חדשים שמיועדים באופן בלעדי לשותפי התוכן של YouTube. שותפי התוכן של YouTube כוללים אולפני קולנוע וטלוויזיה, לייבלים ויוצרי תוכן אחרים שהופכים את התוכן שלהם לזמין ב-YouTube.
-
הפרמטר
onBehalfOfContentOwner
מציין שפרטי הכניסה של ההרשאה של הבקשה מזהים משתמש YouTube CMS שפועל בשם בעלי התוכן שצוינו בערך הפרמטר. חשבון ה-CMS שאיתו המשתמש מבצע אימות חייב להיות מקושר לבעלי התוכן שצוינו ב-YouTube.הפרמטר הזה מיועד לשותפי תוכן שהם הבעלים והמנהלים של ערוצי YouTube רבים ושונים. הפרמטר מאפשר לשותפים האלה לבצע אימות פעם אחת ולקבל גישה לכל נתוני הסרטונים והערוץ, בלי שיצטרכו לספק פרטי כניסה לאימות עבור כל ערוץ בנפרד.
כל השיטות
channels.list
,search.list
,videos.delete
,videos.list
, ו-videos.update
תומכות בפרמטר הזה. -
הפרמטר
managedByMe
, שנתמך על ידי השיטהchannels.list
, מורה ל-API להחזיר את כל הערוצים שבבעלות בעלי התוכן שצוין בפרמטרonBehalfOfContentOwner
. -
הפרמטר
forContentOwner
, שנתמך על ידי השיטהsearch.list
, מורה ל-API להגביל את תוצאות החיפוש כך שיכללו רק משאבים הנמצאים בבעלות בעלי התוכן, שהפרמטרonBehalfOfContentOwner
מציין.
-
25 בפברואר 2013
העדכון הזה כולל את השינויים הבאים:
-
ה-API תומך בכמה חלקים ומאפיינים חדשים למשאבים של
video
:-
החלקים החדשים
fileDetails
,processingDetails
ו-suggestions
מספקים מידע לבעלי הסרטונים על הסרטונים שהם העלו. הנתונים האלה שימושיים מאוד באפליקציות שמאפשרות העלאות של סרטונים, וכוללים את הדברים הבאים:- סטטוס העיבוד וההתקדמות
- או שגיאות אחרות שאירעו במהלך עיבוד הסרטון
- הזמינות של תמונות ממוזערות
- הצעות לשיפור האיכות של הסרטונים או המטא-נתונים
- פרטים על הקובץ המקורי שהועלה ל-YouTube
רק הבעלים של הסרטון יכול לאחזר את כל החלקים האלה. הרשימה הבאה מתארת בקצרה את החלקים החדשים, ותיעוד המשאבים של
video
מגדיר את כל המאפיינים שכל חלק מכיל.-
האובייקט
fileDetails
מכיל מידע על קובץ הווידאו שהועלה ל-YouTube, כולל הרזולוציה, משך הזמן, קידוד האודיו והווידאו של הקובץ, קצבי העברת הנתונים של הסטרימינג ועוד. -
האובייקט
processingProgress
מכיל מידע על ההתקדמות של YouTube בעיבוד קובץ הסרטון שהועלה. מאפייני האובייקט מזהים את סטטוס העיבוד הנוכחי ומעריכים את הזמן שנותר עד לסיום עיבוד הסרטון על ידי YouTube. החלק הזה גם מציין אם סוגים שונים של נתונים או תוכן, כמו פרטי קובץ או תמונות ממוזערות, זמינים לסרטון.האובייקט הזה נועד לביצוע סקרים כדי שמעלה הסרטון יוכל לעקוב אחרי ההתקדמות של YouTube בעיבוד קובץ הסרטון שהועלה.
-
האובייקט
suggestions
מכיל הצעות לזיהוי הזדמנויות לשיפור איכות הסרטון או המטא-נתונים של הסרטון שהועלה.
-
החלק
contentDetails
מכיל ארבעה מאפיינים חדשים. אפשר לאחזר את המאפיינים האלה באמצעות בקשות לא מאומתות.dimension
– מציין אם הסרטון זמין בדו-ממד או בתלת-ממד.definition
– מציין אם הסרטון זמין באיכות רגילה או באיכות גבוהה.caption
– מציינת אם יש כתוביות לסרטון.licensedContent
– מציין אם הסרטון מכיל תוכן ששותפי תוכן של YouTube הגישו לגביו הצהרה על זכויות יוצרים.
-
החלק
status
מכיל שני מאפיינים חדשים. בעלי סרטונים יכולים להגדיר ערכים לשני המאפיינים כשהם מוסיפים או מעדכנים סרטון. אפשר גם לאחזר את המאפיינים האלה באמצעות בקשות לא מאומתות.embeddable
– מציינת אם ניתן להטמיע את הסרטון באתר אחר.license
– מציין את הרישיון של הסרטון. הערכים החוקיים הםcreativeCommon
ו-youtube
.
-
-
ההגדרה של הפרמטר
part
עודכנה בשיטותvideos.list
,videos.insert
ו-videos.update
כדי לציין את החלקים החדשים שנוספו המתוארים למעלה, וגם את החלקrecordingDetails
, שהושמט בטעות. -
מאפיין
contentDetails.googlePlusUserId
החדש של המשאבchannel
מציין את מזהה פרופיל Google+ המשויך לערוץ. ניתן להשתמש בערך הזה כדי ליצור קישור לפרופיל Google+. -
כל אובייקט של תמונה ממוזערת מציין כעת את הרוחב והגובה של התמונה. נכון לעכשיו, תמונות ממוזערות מוחזרות במשאבים
activity
,channel
,playlist
,playlistItem
,search result
,subscription
ו-video
. -
הפרמטר
playlistItems.list
תומך עכשיו בפרמטרvideoId
, שאפשר להשתמש בו בשילוב עם הפרמטרplaylistId
כדי לאחזר רק את פריט הפלייליסט שמייצג את הסרטון שצוין.ה-API יחזיר את השגיאה
notFound
אם הסרטון שהפרמטר מזהה לא נמצא בפלייליסט. -
בתיעוד השגיאה מתוארת שגיאת
forbidden
חדשה, שלפיה הבקשה לא מורשית לבצע את הפעולה המבוקשת. -
המאפיין
snippet.channelId
של המשאבchannel
הוסר. המאפייןid
של המשאב מספק את אותו ערך.
30 בינואר 2013
העדכון הזה כולל את השינויים הבאים:
-
דף השגיאה החדש מפרט שגיאות שה-API יכול להחזיר. הדף כולל שגיאות כלליות, שעשויות להתרחש במספר שיטות API שונות, וכן שגיאות ספציפיות לשיטה.
16 בינואר 2013
העדכון הזה כולל את השינויים הבאים:
-
דוגמאות קוד זמינות עכשיו לשיטות ולשפות שמוצגות ברשימה הבאה:
activities.insert
– JavaplaylistItems.insert
– PythonplaylistItems.list
– Java, JavaScript, PHP, Python, Rubyplaylists.insert
– Java, JavaScript, Pythonsearch.list
– Java, JavaScript, Python, Rubyvideos.insert
– Java
-
משאב של
activity
יכול עכשיו לדווח על פעולהchannelItem
שמתרחשת כשמערכת YouTube מוסיפה סרטון לערוץ YouTube שנוצר באופן אוטומטי. (המערכת של YouTube מזהה באמצעות אלגוריתמים נושאים שיש להם נוכחות משמעותית באתר YouTube, ויוצרת באופן אוטומטי ערוצים לנושאים האלה). -
search.list
הפרמטרים הבאים עודכנו:- הפרמטר
q
כבר לא מוגדר כמסנן, כלומר .... - השם של הפרמטר
relatedToVideo
השתנה ל-relatedToVideoId
. - הפרמטר
published
הוחלף בשני פרמטרים חדשים,publishedAfter
ו-publishedBefore
, המתוארים בהמשך.
- הפרמטר
-
השיטה
search.list
תומכת בפרמטרים החדשים הבאים:שם הפרמטר ערך תיאור channelId
string
החזרת משאבים שנוצרו על ידי הערוץ שצוין. publishedAfter
datetime
החזרת משאבים שנוצרו אחרי הזמן שצוין. publishedBefore
datetime
החזרת משאבים שנוצרו לפני הזמן שצוין. regionCode
string
החזרת משאבים עבור המדינה שצוינה. videoCategoryId
string
סנן תוצאות חיפוש של סרטונים כך שיכללו רק סרטונים המשויכים לקטגוריית הסרטונים שצוינה. videoEmbeddable
string
אפשר לסנן את תוצאות החיפוש של סרטונים כך שיכללו רק סרטונים שאפשר להפעיל בנגן מוטמע בדף אינטרנט. יש להגדיר את ערך הפרמטר ל- true
כדי לאחזר רק סרטונים שניתן להטמיע.videoSyndicated
string
סנן את תוצאות החיפוש של סרטונים כך שיכללו רק סרטונים שניתן להפעיל מחוץ ל-YouTube.com. יש להגדיר את ערך הפרמטר ל- true
כדי לאחזר רק סרטונים בסינדיקציה. -
מספר משאבי API תומכים בנכסים חדשים. הטבלה הבאה מזהה את המשאבים ואת המאפיינים החדשים שלהם:
משאב שם הנכס ערך תיאור activity
contentDetails.playlistItem.playlistItemId
string
מזהה הפריט בפלייליסט ש-YouTube הקצה כדי לזהות באופן ייחודי את הפריט בפלייליסט. activity
contentDetails.channelItem
object
אובייקט שמכיל מידע על משאב שנוסף לערוץ. המאפיין הזה קיים רק אם snippet.type
הואchannelItem
.activity
contentDetails.channelItem.resourceId
object
אובייקט שמזהה את המשאב שנוסף לערוץ. כמו מאפיינים אחרים של resourceId
, הוא מכיל מאפייןkind
שמציין את סוג המשאב, כמו סרטון או פלייליסט. הוא גם מכיל בדיוק אחד מתוך כמה מאפיינים –videoId
,playlistId
וכו' – שמציין את המזהה הייחודי של אותו המשאב.channel
status
object
האובייקט כולל מידע על סטטוס הפרטיות של הערוץ. channel
status.privacyStatus
string
סטטוס הפרטיות של הערוץ. הערכים החוקיים הם private
ו-public
.playlist
contentDetails
object
אובייקט זה מכיל מטא-נתונים לגבי תוכן הפלייליסט. playlist
contentDetails.itemCount
unsigned integer
מספר הסרטונים בפלייליסט. playlist
player
object
האובייקט הזה מכיל מידע שישמש אותך להפעלת הפלייליסט בנגן מוטמע. playlist
player.embedHtml
string
תג <iframe>
שמטמיע נגן וידאו שמפעיל את הפלייליסט.video
recordingDetails
object
האובייקט כולל מידע שמזהה או מתאר את המקום והשעה שבהם הסרטון צולם. video
recordingDetails.location
object
האובייקט מכיל פרטי מיקום גיאוגרפי שמשויכים לסרטון. video
recordingDetails.location.latitude
double
קו רוחב במעלות. video
recordingDetails.location.longitude
double
קו אורך במעלות. video
recordingDetails.location.elevation
double
גובה מעל כדור הארץ, במטרים. video
recordingDetails.locationDescription
string
טקסט תיאורי של המיקום שבו הסרטון צולם. video
recordingDetails.recordingDate
datetime
התאריך והשעה שבהם צולם הסרטון. הערך מצוין בפורמט ISO 8601 ( YYYY-MM-DDThh:mm:ss.sZ
). -
בתיעוד של מספר שיטות API מזוהים עכשיו מאפיינים שחייבים לציין בגוף הבקשה או שמתעדכנים על סמך ערכים בגוף הבקשה. בטבלה הבאה מפורטות השיטות האלה לצד המאפיינים הנדרשים או שניתנים לשינוי.
הערה: יכול להיות שבתיעוד של שיטות אחרות כבר מפורטים הנכסים הנדרשים והניתנים לשינוי.
שיטה תכונות activities.insert
מאפיינים נדרשים: snippet.description
snippet.description
contentDetails.bulletin.resourceId
playlists.update
מאפיינים נדרשים: id
playlistItems.update
מאפיינים נדרשים: id
videos.update
מאפיינים נדרשים: id
-
ה-API לא ידווח יותר על שגיאת
playlistAlreadyExists
אם מנסים ליצור או לעדכן פלייליסט עם שם זהה לפלייליסט שכבר קיים באותו ערוץ. -
יש כמה שיטות API שתומכות בסוגי שגיאות חדשים. הטבלה הבאה מזהה את השיטה ואת השגיאות החדשות שנתמכות:
שיטה סוג השגיאה פרטי השגיאה תיאור guideCategories.list
notFound
notFound
לא ניתן למצוא את קטגוריית המדריך שזוהתה על ידי הפרמטר id
. אפשר להשתמש בשיטה guideCategories.list כדי לאחזר רשימה של ערכים חוקיים.playlistItems.delete
forbidden
playlistItemsNotAccessible
הבקשה אינה מורשית כראוי למחוק את פריט הפלייליסט שצוין. videoCategories.list
notFound
videoCategoryNotFound
קטגוריית הסרטון שזוהתה על ידי הפרמטר id
לא נמצאה. אפשר להשתמש בשיטה videoCategories.list כדי לאחזר רשימה של ערכים חוקיים.