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