أيلول (سبتمبر) 2013 (تم التحديث في 12/02/2013)
- المقدمة
- الأسئلة الشائعة
- ماذا حدث للتعليقات المنشورة قبل النقل؟
- هل ما زالت خلاصة التعليقات متوفّرة؟
- هل هناك خلاصة توضّح تنسيق الخلاصة الجديدة؟
- هل لا يزال بإمكاني إنشاء تعليق عبر واجهة برمجة التطبيقات؟
- توفر التعليقات المدعومة من +Google سلاسل محادثات. ما تأثير هذا التغيير في الردود على التعليقات في YouTube؟
- ماذا يحدث في +Google عندما أضع تعليقًا عبر واجهة برمجة تطبيقات YouTube؟
- هل تستمر التعليقات في الظهور في خلاصة الأنشطة منذ التبديل إلى نظام التعليق الجديد؟
- هل تستمر ميزة 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 بشكل واضح على الصفحة خلال خلاصة التعليقات (إجراء غير مقترَح)، قد يتسبّب ذلك في ظهور سلوك غير متّسق ولن يظهر لك سوى عدد صغير من التعليقات.
تحديث (11/10/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؟
لا يؤدي إنشاء تعليق عبر واجهة برمجة تطبيقات YouTube إلى إنشاء مشاركة في ساحة مشاركاتك على +Google أو إنشاء إشعار على +Google.
هل تستمر التعليقات في الظهور في خلاصة الأنشطة منذ التبديل إلى نظام التعليق الجديد؟
لا، ليس في الوقت الحالي
هل تستمر ميزة SUP في واجهة برمجة التطبيقات القديمة في العمل على التعليقات؟
لا، ليس للتعليقات. تعتمد SUP على خلاصة نشاط المستخدم. لا تظهر التعليقات في خلاصة النشاط لأنّها لم تعُد متوفّرة في خلاصة الأنشطة.