ספטמבר 2013 (עודכן ב-12 בפברואר 2013)
- מבוא
- שאלות נפוצות
- מה קרה לתגובות שפורסמו לפני המעבר?
- האם פיד התגובות עדיין זמין?
- האם יש פיד שמדגים את הפורמט של הפיד החדש?
- האם עדיין אפשר ליצור תגובה דרך ה-API?
- תגובות שמבוססות על Google+ מאפשרות שרשור. מה המשמעות של השינוי הזה לגבי תשובות לתגובות ב-YouTube?
- מה קורה ב-Google+ כשיוצרים תגובה דרך ממשק ה-API של YouTube?
- האם תגובות ממשיכות להופיע בפיד הפעילות מאז המעבר למערכת התגובות החדשה?
- האם SUP ב-API מהדור הקודם ממשיך לפעול עבור תגובות?
מבוא
מערכת התגובות החדשה של YouTube, שהושקה בנובמבר 2013 ומופעלת על ידי Google+, מאפשרת למשתמשי YouTube לאחזר הרבה יותר תגובות לכל סרטון ממה שהם יכלו בעבר. בנוסף, המערכת החדשה מאפשרת לכם למצוא בקלות שיחות משמעותיות, כי התגובות ממוינות לפי רלוונטיות למשתמשים ספציפיים.
אמנם התגובות החדשות לא נתמכות כרגע ב-YouTube Data API v3, אבל אפשר להמשיך להשתמש בגרסה הישנה יותר של ה-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?
כן, אבל כדי לכתוב הערות חדשות עם v2 API, יש כמה דרישות:
- למשתמש המאומת חייב להיות ערוץ YouTube המקושר לחשבון Google+ (פרטי ה-API)
- צריך לשלוח את הבקשה באמצעות HTTPS (הגרסאות הנוכחיות של ספריות הלקוח הקודמות תומכות בכך כברירת מחדל)
אם אחת מהדרישות האלה לא מתקיימת, ה-API מחזיר הודעת שגיאה.
תגובות שמופעלות על ידי Google+ מאפשרות שרשור. מה המשמעות של השינוי הזה לגבי תשובות לתגובות ב-YouTube?
תשובות לתגובות שנשלחו לפני המעבר מופיעות עכשיו כתגובות רגילות. בנוסף, אין יותר תמיכה במענה ישירות לתגובות דרך YouTube API. בשלב זה, אין אפשרות להשיב לתגובה בסגנון החדש דרך YouTube API.
תשובות לתגובות בסגנון החדש ב-YouTube דרך האתרים והאפליקציות של YouTube ו-Google+ לא מופיעות בפיד התגובות של ה-API הקודם. עם זאת, אפשר לקבל את התשובות בפועל דרך ממשקי Google+ API.
אם רשומה בפיד התגובות של YouTube מייצגת תגובה בסגנון חדש, היא מכילה את התג <yt:googlePlusUserId>. אם התג הזה נמצא בתגובה ויש לה תגובות (פשוט בודקים את הרכיב <yt:replyCount>), אפשר לנתח את מזהה הפעילות ב-Google+ מהתג <id> של הרשומה. אפשר להשתמש במזהה הזה כדי לקרוא ל-method 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?
הוספת תגובה באמצעות ממשק ה-API של YouTube לא יוצרת פוסט בזרם Google+ וגם לא יוצרת התראה ב-Google+.
האם התגובות ממשיכות להופיע בפיד הפעילות מאז המעבר למערכת התגובות החדשה?
לא, לא כרגע.
האם SUP ב-API הקודם ממשיך לפעול עבור תגובות?
לא, לא לתגובות. SUP מסתמך על הפיד של פעילות המשתמשים. מאחר שהתגובות כבר לא מופיעות בפיד הפעילות, הן לא מופיעות ב-SUP.