הרשמה להתראות

‫YouTube Data API (גרסה 3) תומך בהתראות בדחיפה באמצעות PubSubHubbub, פרוטוקול פרסום/הרשמה משרת לשרת למשאבים שזמינים באינטרנט. ההתראות נשלחות למנויים באמצעות וווב-הוקים של HTTP, שהם יעילים הרבה יותר מפתרונות שמבוססים על סקרים. בעזרת PubSubHubbub, השרת שלכם מקבל מידע על אירועים כמעט בזמן אמת, בלי שתצטרכו לקבוע את מרווח הזמן האופטימלי בין סקרים או לאחזר שוב ושוב נתונים שלא השתנו.

שרת ה-callback של PubSubHubbub מקבל התראות בפיד Atom כשבערוץ מתבצעת אחת מהפעולות הבאות:

  • העלאת סרטון
  • עדכון השם של סרטון
  • מעדכן את תיאור הסרטון

כדי להירשם לקבלת התראות:

  1. מגדירים שרת לקריאה חוזרת (callback) שיכול לטפל בהתראות של פיד Atom נכנס.

  2. כדי להירשם לקבלת התראות, משתמשים במרכז Google:

    • מגדירים את mode (מצב) לערך subscribe. (או מגדירים את המצב ל-unsubscribe כדי לבטל מינוי).

    • מגדירים את כתובת ה-URL להתקשרות חזרה לכתובת ה-URL שהגדרתם בשלב 1.

    • מגדירים את כתובת ה-URL של הנושא ל-https://www.youtube.com/xml/feeds/videos.xml?channel_id=CHANNEL_ID, כאשר CHANNEL_ID הוא מזהה הערוץ ב-YouTube שעבורו רוצים לאחזר התראות פוש.

  3. עיבוד ההתראות שנשלחות לשרת הקריאה החוזרת. בהמשך מוצג פורמט ההתראה. שימו לב: אפשר להשתמש בערך של רכיב <yt:videoId> כדי לזהות את הסרטון שנוסף או עודכן. אפשר גם להשתמש בערך של רכיב <yt:channelId> כדי לזהות את הערוץ שהוא הבעלים של הסרטון.

    <feed xmlns:yt="http://www.youtube.com/xml/schemas/2015"
         xmlns="http://www.w3.org/2005/Atom">
  <link rel="hub" href="https://pubsubhubbub.appspot.com"/>
  <link rel="self" href="https://www.youtube.com/xml/feeds/videos.xml?channel_id=CHANNEL_ID"/>
  <title>YouTube video feed</title>
  <updated>2015-04-01T19:05:24.552394234+00:00</updated>
  <entry>
    <id>yt:video:VIDEO_ID</id>
    <yt:videoId>VIDEO_ID</yt:videoId>
    <yt:channelId>CHANNEL_ID</yt:channelId>
    <title>Video title</title>
    <link rel="alternate" href="http://www.youtube.com/watch?v=VIDEO_ID"/>
    <author>
     <name>Channel title</name>
     <uri>http://www.youtube.com/channel/CHANNEL_ID</uri>
    </author>
    <published>2015-03-06T21:40:57+00:00</published>
    <updated>2015-03-09T19:05:24.552394234+00:00</updated>
  </entry>
</feed>