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