ספטמבר 2013 (עודכן ב-02/12/2013)
- מבוא
- שאלות נפוצות
- מה קרה לתגובות שפורסמו לפני המעבר?
- האם פיד התגובות עדיין זמין?
- האם יש פיד שמדגים את הפורמט של הפיד החדש?
- האם עדיין אפשר ליצור תגובה דרך ה-API?
- תגובות שמופעלות ב-Google+ מציעות שרשור. מה המשמעות מבחינת התשובות שלכם לתגובות ב-YouTube?
- מה קורה ב-Google+ כששולחים תגובות דרך ממשק ה-API של YouTube?
- האם התגובות ממשיכות להופיע בפיד הפעילות מאז המעבר למערכת התגובות החדשה?
- האם SUP ב-API מהדור הקודם ימשיך לפעול בתגובות?
מבוא
מערכת התגובות החדשה של YouTube הושקה בנובמבר 2013, והיא מופעלת על ידי +Google. כך משתמשי YouTube יכולים לאחזר תגובות רבות נוספות לכל סרטון, מבעבר. המערכת החדשה מאפשרת למצוא בקלות שיחות משמעותיות גם מפני שהתגובות מסודרות לפי רלוונטיות למשתמשים מסוימים.
בשלב זה, התגובות החדשות לא נתמכות בגרסה 3 של YouTube Data API, אבל תוכלו להמשיך להשתמש בגרסה הישנה יותר של ה-API (v2) עם כמה נקודות שחשוב לשים לב אליהן בהמשך (והיתרונות המפורטים למעלה).
אנחנו ממליצים לוודא שהשילוב ממשיך לפעול לאחר שעברנו למערכת התגובות החדשה ולהודיע לנו אם תיתקלו בבאגים (בעיות בקובץ בכתובת youtube.com/dev). תודה!
שאלות נפוצות
מה קרה לתגובות שפורסמו לפני המעבר?
תגובות שפורסמו לפני המעבר הועברו למערכת החדשה המופעלת על ידי Google+.
האם פיד התגובות עדיין זמין?
כן, למשל, אם משתמשים ב-API כדי לאחזר את התגובות לסרטון, מקבלים פיד של תגובות המסודר לפי רלוונטיות, כפי שמתואר בהודעה.* בגלל המעבר למערכת התגובות החדשה, התגובות כבר לא מוצגות בסדר כרונולוגי כברירת מחדל. עם זאת, עדיין אפשר לסדר תגובות בסדר כרונולוגי באמצעות הגדרת הערך של הפרמטר orderby לערך published בבקשת ה-API, כמו בדוגמה הבאה:
https://gdata.youtube.com/feeds/api/videos/VIDEO_ID/comments?orderby=published
מומלץ לפעול לפי השיטות המומלצות הרגילות של הוספת תגובות באמצעות הקישורים next ו-previous בפיד התגובות. כך תוכלו גם ליהנות מהיתרון הנוסף של היכולת לדפדף בין תגובות רבות מבעבר.
אם תגדירו באופן מפורש ערך של start-index להצגה בדף דרך פיד התגובות (לא מומלץ), זה יכול לגרום להתנהגות לא עקבית ותוכלו לקבל רק מספר קטן של תגובות.
עדכון (10/11/2013):
* כברירת מחדל, פידים של תגובות ממוינים לפי רלוונטיות כללית, ולא לפי רלוונטיות אישית. במילים אחרות, בקשה מאומתת ותגובה לא מאומתת של פיד תגובות תחזיר את אותן התוצאות.
ה-API תומך בפיד תגובות בהתאמה אישית הכולל פוסטים שאינם גלויים לכולם. כדי לקבל את הפיד הזה, צריך רק להגיש בקשה מאומתת ולהגדיר ל-true את הערך בפרמטר של relevant-to-me בבקשת ה-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. בשלב זה, אין דרך להגיב לתגובה בסגנון חדש באמצעות ה-API של YouTube.
תשובות לתגובות בסגנון חדש של 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?
הוספת תגובה באמצעות ה-API של YouTube לא יוצרת פוסט בעדכוני התוכן שלך ב-Google+ וגם לא יוצרת התראה ב-Google+.
האם התגובות ממשיכות להופיע בפיד הפעילות מאז המעבר למערכת התגובות החדשה?
לא, לא כרגע.
האם SUP ב-API מהדור הקודם ממשיך לפעול עבור תגובות?
לא, ולא עבור תגובות. SUP מסתמך על פיד פעילות המשתמשים. מאחר שהתגובות כבר לא נמצאות בפיד הפעילות, הן לא מופיעות ב-SUP.