أيلول (سبتمبر) 2013 (تاريخ التعديل: 02/12/2013)
- مقدمة
- الأسئلة الشائعة
- ماذا حدث للتعليقات التي تم نشرها قبل عملية النقل؟
- هل ما زالت خلاصة التعليقات متاحة؟
- هل تتوفّر خلاصة توضح تنسيق الخلاصة الجديدة؟
- هل لا يزال بإمكاني إنشاء تعليق من خلال واجهة برمجة التطبيقات؟
- ميزة التعليقات المستندة إلى +Google توفر سلاسل محادثات. تأثير ذلك في الردود على التعليقات على YouTube
- ماذا يحدث على Google+ عندما أنشر تعليقًا من خلال YouTube API؟
- هل يستمر ظهور التعليقات في خلاصة الأنشطة منذ التبديل إلى نظام التعليقات الجديد؟
- هل ما زالت ميزة SUP في واجهة برمجة التطبيقات القديمة تعمل مع التعليقات؟
مقدمة
وقد تم إطلاق نظام التعليقات الجديد في YouTube في تشرين الثاني (نوفمبر) 2013 والمدعوم من Google+ ، وهو يتيح لمستخدمي YouTube استرداد عدد أكبر من التعليقات لكل فيديو بشكل أكبر من السابق. يسهّل النظام الجديد أيضًا العثور على محادثات مفيدة، لأنّ التعليقات يتم ترتيبها حسب مدى صلتها بالمستخدمِين الفرديين.
على الرغم من أنّ التعليقات الجديدة غير متاحة حاليًا في الإصدار 3 من YouTube Data API، يمكنك مواصلة استخدام الإصدار الأقدم من واجهة برمجة التطبيقات (الإصدار 2) مع مراعاة بعض التحذيرات الموضّحة أدناه (والمزايا المذكورة أعلاه).
ننصحك بالتأكّد من أنّ عملية الدمج ستستمر في العمل الآن بعد الانتقال إلى نظام التعليق الجديد، وإعلامنا في حال حدوث أيّ أخطاء (المشاكل في الملفات على youtube.com/dev). شكرًا!
الأسئلة الشائعة
ماذا حدث للتعليقات المنشورة قبل عملية النقل؟
تم ترحيل التعليقات التي تم نشرها قبل النقل إلى النظام الجديد المدعوم من Google+.
هل لا تزال خلاصة التعليقات متاحة؟
نعم، على سبيل المثال، إذا كنت تستخدم واجهة برمجة التطبيقات لاسترداد التعليقات على فيديو، ستحصل على خلاصة من التعليقات مرتبة حسب مدى صلة التعليق بالموضوع كما هو موضّح في الإشعار.* منذ التبديل إلى نظام التعليقات الجديد، لم تعُد التعليقات تظهر بترتيب زمني تلقائيًا. مع ذلك، بإمكانك ترتيب التعليقات حسب التسلسل الزمني من خلال ضبط قيمة المعلَمة orderby على published في طلب البيانات من واجهة برمجة التطبيقات، كما هو موضّح في المثال التالي:
https://gdata.youtube.com/feeds/api/videos/VIDEO_ID/comments?orderby=publishedننصحك باتّباع أفضل الممارسات العادية، وهي استخدام الرابطَين next وprevious في خلاصة التعليقات للتنقّل بين التعليقات. بهذه الطريقة، ستستفيد أيضًا من إمكانية الاطّلاع على عدد أكبر من التعليقات التي استطعت الوصول إليها سابقًا.
إذا ضبطت قيمة start-index بشكل صريح للانتقال إلى خلاصة التعليقات (لا يُنصح بهذا الخيار)، قد يؤدي ذلك إلى سلوك غير متّسق ولن يتم عرض سوى عدد صغير من التعليقات.
تعديل (10/11/2013):
* يتم ترتيب خلاصات التعليقات تلقائيًا حسب مدى الصلة العامة بها وليس حسب مدى الصلة الشخصية. بعبارة أخرى، سيعرض طلب خلاصة التعليقات الذي تم إثبات هويته وتلك الذي لم يتم إثبات هويته النتائج نفسها.
تتيح واجهة برمجة التطبيقات خلاصة تعليقات مخصّصة تتضمّن مشاركات غير علنية. للحصول على هذه الخلاصة، ما عليك سوى إرسال طلب تمّت مصادقته وضبط قيمة المَعلمة relevant-to-me على true في طلب واجهة برمجة التطبيقات كما هو موضّح في المثال التالي:
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
هل لا يزال بإمكاني إنشاء تعليق من خلال واجهة برمجة التطبيقات؟
نعم، ولكن لكتابة تعليقات جديدة باستخدام الإصدار 2 من واجهة برمجة التطبيقات، تتوفّر عدّة متطلبات:
- يجب أن يمتلك المستخدم الذي تمت مصادقته قناة YouTube مرتبطة بحساب +Google (تفاصيل واجهة برمجة التطبيقات)
- يجب إرسال الطلب عبر بروتوكول HTTPS (تتيح الإصدارات الحالية من مكتبات العملاء القديمة ذلك تلقائيًا).
في حال عدم استيفاء أيّ من هذه المتطلبات، تعرض واجهة برمجة التطبيقات رسالة خطأ.
توفر ميزة التعليقات المستندة إلى Google+ سلاسل محادثات. تأثير هذا التغيير في الردود على التعليقات على YouTube
تظهر الآن الردود على التعليقات التي تم إجراؤها قبل عملية النقل كتعليقات عادية. بالإضافة إلى ذلك، لم تعُد ميزة الردّ مباشرةً على التعليقات متاحة عبر YouTube API. في الوقت الحالي، لا تتوفّر طريقة للردّ على تعليق بالأسلوب الجديد من خلال YouTube API.
لا يتم عرض الردود على التعليقات الجديدة على YouTube من خلال مواقع YouTube وGoogle+ وتطبيقاتهما باستخدام خلاصة التعليقات في واجهة برمجة التطبيقات القديمة. ومع ذلك، يمكنك الحصول على الردود الفعلية عبر واجهات برمجة تطبيقات Google+.
إذا كان إدخال خلاصة التعليقات في YouTube يمثّل تعليقًا بالأسلوب الجديد، سيحتوي على علامة <yt:googlePlusUserId>. في حال ظهور تلك العلامة وتم العثور على أي ردود على التعليق (ما عليك سوى التحقّق من العنصر <yt:replyCount>)، يمكنك تحليل معرّف نشاط Google+ من علامة <id> الخاصة بالإدخال. يمكنك استخدام رقم التعريف هذا لطلب طريقة comments:list في واجهة برمجة تطبيقات Google+ لاسترداد قائمة بالردود الحديثة على هذا التعليق.
يوضّح المقتطف أدناه كيفية ظهور رقم تعريف النشاط على 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 عندما أُضيف تعليقًا عبر YouTube API؟
لا يؤدي إضافة تعليق عبر واجهة برمجة تطبيقات YouTube إلى إنشاء مشاركة في ساحة مشاركات +Google، كما لا يؤدي إلى إنشاء إشعار في +Google.
هل يستمر ظهور التعليقات في خلاصة الأنشطة منذ التبديل إلى نظام التعليقات الجديد؟
لا، ليس في الوقت الحالي
هل ما زال SUP في واجهة برمجة التطبيقات القديمة يعمل مع التعليقات؟
لا، لا يمكن ذلك في التعليقات. يعتمد SUP على خلاصة نشاط المستخدِم. بما أن التعليقات لم تعد موجودة في خلاصة الأنشطة، فلن تظهر في SUP.