الاشتراك في دفع الإشعارات

تتيح واجهة YouTube Data API (الإصدار 3) تلقّي الإشعارات الفورية من خلال PubSubHubbub، وهو بروتوكول نشر/اشتراك من خادم إلى خادم للموارد المتاحة على الويب. يتم إرسال الإشعارات إلى المشتركين من خلال خطافات الويب HTTP، ما يجعلها أكثر فعالية من الحلول المستندة إلى الاستقصاء. باستخدام PubSubHubbub، يمكن لخادمك التعرّف على الأحداث في الوقت الفعلي تقريبًا، بدون الحاجة إلى تحديد الفاصل الزمني الأمثل للاستطلاع أو جلب البيانات بشكل متكرّر إذا لم تتغيّر.

يتلقّى خادم معاودة الاتصال في PubSubHubbub إشعارات خلاصة Atom عندما تنفّذ قناة أيًا من الأنشطة التالية:

• تحميل فيديو
• تعديل عنوان فيديو
• تعديل وصف فيديو

توضّح الخطوات التالية كيفية الاشتراك في تلقّي الإشعارات:

1. إعداد خادم ردّ الاتصال الذي يمكنه التعامل مع إشعارات خلاصة Atom الواردة

2. استخدِم مركز Google للاشتراك في ميزة تلقّي الإشعارات الفورية:

   • اضبط الوضع على subscribe. (أو اضبط الوضع على unsubscribe لإلغاء اشتراك).

   • اضبط عنوان URL لرد الاتصال على عنوان URL الذي أعددته في الخطوة 1.

   • اضبط عنوان URL الخاص بالموضوع على https://www.youtube.com/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/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>