ספטמבר 2013 (עודכן ב-2/12/2013)
- מבוא
- שאלות נפוצות
- מה קרה לתגובות שפורסמו לפני המעבר?
- האם פיד התגובות עדיין זמין?
- האם יש פיד שמדגים את הפורמט של הפיד החדש?
- האם עדיין אפשר ליצור תגובה דרך ה-API?
- תגובות שמופעלות על ידי Google+ מאפשרות שרשור. מה המשמעות של השינוי הזה לגבי תשובות לתגובות ב-YouTube?
- מה קורה ב-Google+ כשיוצרים תגובה דרך ממשק ה-API של YouTube?
- האם תגובות ממשיכות להופיע בפיד הפעילות מאז המעבר למערכת התגובות החדשה?
- האם SUP ב-API מהדור הקודם ממשיך לפעול עבור תגובות?
מבוא
מערכת התגובות החדשה של YouTube, שהושקה בנובמבר 2013 ומופעלת על ידי Google+, מאפשרת למשתמשי YouTube לאחזר הרבה יותר תגובות לכל סרטון ממה שהם יכלו בעבר. בעזרת המערכת החדשה, גם קל יותר למצוא שיחות משמעותיות, כי התגובות מסודרות לפי הרלוונטיות של המשתמשים.
התגובות החדשות לא נתמכות כרגע ב-YouTube Data API גרסה 3, אבל אפשר להמשיך להשתמש בגרסה הישנה יותר של ה-API (גרסה 2) עם כמה אזהרות שמפורטות בהמשך (וגם עם היתרונות שמפורטים למעלה).
מומלץ לוודא שהשילוב שלכם ממשיך לפעול עכשיו אחרי המעבר למערכת התגובות החדשה, ולהודיע לנו אם נתקלתם באגים (בעיות בקובץ בכתובת youtube.com/dev). תודה!
שאלות נפוצות
מה קרה לתגובות שפורסמו לפני המעבר?
תגובות שפורסמו לפני המעבר הועברו למערכת החדשה שמופעלת על ידי Google+.
האם פיד התגובות עדיין זמין?
כן. לדוגמה, אם משתמשים ב-API כדי לאחזר את התגובות לסרטון, תקבלו פיד של תגובות, מסודרות לפי מידת הרלוונטיות, כפי שמפורט בהודעה.* בגלל המעבר למערכת התגובות החדשה, התגובות כבר לא יוצגו בסדר כרונולוגי כברירת מחדל. עם זאת, עדיין אפשר למיין את התגובות לפי כרונולוגיה על ידי הגדרת הערך published לפרמטר orderby בבקשת ה-API, כפי שמתואר בדוגמה הבאה:
https://gdata.youtube.com/feeds/api/videos/VIDEO_ID/comments?orderby=publishedאנחנו ממליצים לפעול לפי השיטה המומלצת הרגילה של שימוש בקישורים next ו-previous בפיד התגובות כדי לעבור לדף תגובות. כך תוכלו גם ליהנות מהיתרונות הנוספים של מעבר על הרבה יותר תגובות ממה שהצלחתם קודם לכן.
אם תגדירו באופן מפורש ערך ל-start-index כדי לדפדף בפיד התגובות (לא מומלץ), יכול להיות שההתנהגות תהיה לא עקבית ותקבלו רק מספר קטן של תגובות.
עדכון (11 באוקטובר 2013):
* כברירת מחדל, פידים של תגובות ממוינים לפי רלוונטיות כללית, ולא לפי רלוונטיות אישית. כלומר, בקשה מאומתת ובקשה לפיד תגובות לא מאומתת יחזירו את אותן התוצאות.
ה-API תומך בפיד תגובות בהתאמה אישית שכולל פוסטים שאינם ציבוריים. כדי לקבל את הפיד הזה, פשוט שולחים בקשה מאומתת ומגדירים את הערך של הפרמטר relevant-to-me כ-true בבקשת ה-API, כפי שמתואר בדוגמה הבאה:
https://gdata.youtube.com/feeds/api/videos/VIDEO_ID/comments?relevant-to-me=true
האם יש פיד שמדגים את הפורמט של הפיד החדש?
מעכשיו יש תמיכה בפורמט החדש בכל פידים של תגובות. בהמשך מופיעות כמה דוגמאות.
- פיד שמבוסס על רלוונטיות:
http://gdata.youtube.com/feeds/api/videos/9bZkp7q19f0/comments?prettyprint=true
- פיד שמבוסס על סדר כרונולוגי:
http://gdata.youtube.com/feeds/api/videos/9bZkp7q19f0/comments?prettyprint=true&orderby=published
האם עדיין אפשר ליצור תגובה דרך ה-API?
כן, אבל כדי לכתוב תגובות חדשות באמצעות ה-API בגרסה 2, יש כמה דרישות:
- למשתמש המאומת צריך להיות ערוץ YouTube שמקושר לחשבון Google+ (פרטי ה-API)
- יש לשלוח את הבקשה באמצעות HTTPS (גרסאות נוכחיות של ספריות הלקוח הקודמות תומכות בכך כברירת מחדל)
אם אחת מהדרישות האלה לא מתקיימת, ה-API מחזיר הודעת שגיאה.
התגובות שמבוססות על Google+ מאפשרות לכם להגיב בשרשור. מה המשמעות של השינוי הזה לגבי תשובות לתגובות ב-YouTube?
תשובות לתגובות שנשלחו לפני המעבר מופיעות עכשיו כתגובות רגילות. בנוסף, אי אפשר יותר לענות ישירות לתגובות דרך YouTube API. בשלב זה, אין אפשרות להשיב לתגובה בסגנון החדש דרך YouTube API.
תשובות לתגובות בסגנון החדש ב-YouTube דרך האתרים והאפליקציות של YouTube ו-Google+ לא מופיעות בפיד התגובות של ה-API הקודם. עם זאת, ניתן לקבל את התשובות בפועל דרך ממשקי ה-API של Google+.
אם רשומה בפיד התגובות של YouTube מייצגת תגובה בסגנון חדש, היא מכילה את התג <yt:googlePlusUserId>. אם התג הזה נמצא בתגובה ויש לה תגובות (פשוט בודקים את הרכיב <yt:replyCount>), אפשר לנתח את מזהה הפעילות ב-Google+ מהתג <id> של הרשומה. ניתן להשתמש במזהה הזה כדי להפעיל את השיטה comments:list ב-Google+ API כדי לאחזר רשימה של תשובות אחרונות לתגובה הזו.
הקטע הבא מדגים איך מזהה פעילות ב-Google+, שמוצג בכתב מודגש, מופיע ברשומה בפיד התגובות:
<entry> <id>tag:youtube,2008:video:xpI6VNvRTII:comment:z13rtnibotmidjggs04cdvzgvurngv3pwnw0k</id> <yt:googlePlusUserId>123456789</yt:googlePlusUserId> <yt:replyCount>4</yt:replyCount> <yt:channelId>UCxxxx_xxxxx</yt:channelId> ... </entry>
מה קורה ב-Google+ כשמוסיפים תגובה דרך ה-API של YouTube?
פרסום תגובה דרך YouTube API לא יוצר פוסט בזרם שלכם ב-Google+ ולא יוצר התראה ב-Google+.
האם התגובות ממשיכות להופיע בפיד הפעילות מאז המעבר למערכת החדשה של תגובות?
לא, לא כרגע.
האם SUP ב-API הקודם ממשיך לפעול עבור תגובות?
לא, לא לתגובות. SUP מסתמך על הפיד של פעילות המשתמשים. מאחר שהתגובות כבר לא מופיעות בפיד הפעילות, הן לא מופיעות ב-SUP.