YouTube Data API के लेगसी वर्शन 2 में टिप्पणी से जुड़े बदलाव

जेरेमी वॉकर, YouTube API टीम
सितंबर 2013 (अपडेट 12/02/2013)

परिचय

YouTube पर टिप्पणी करने का नया सिस्टम, नवंबर 2013 में लॉन्च किया गया था. यह Google+ पर काम करता है. इसकी मदद से, YouTube के उपयोगकर्ता हर वीडियो पर पहले के मुकाबले ज़्यादा टिप्पणियां देख सकते हैं. इस नए सिस्टम की मदद से, काम की बातचीत भी आसानी से ढूंढी जा सकती हैं. ऐसा इसलिए, क्योंकि टिप्पणियों को उपयोगकर्ताओं के हिसाब से क्रम में लगाया जाता है.

फ़िलहाल, YouTube Data API के वर्शन 3 में नई टिप्पणियों की सुविधा काम नहीं करती. हालांकि, एपीआई के पुराने वर्शन (v2) का इस्तेमाल जारी रखा जा सकता है. इसके लिए, आपको नीचे बताई गई कुछ बातों का ध्यान रखना होगा. साथ ही, आपको ऊपर बताए गए फ़ायदे भी मिलेंगे.

हमारा सुझाव है कि आप इस बात की पुष्टि करें कि आपका इंटिग्रेशन अब भी काम करता रहे. हमने टिप्पणी करने के नए सिस्टम पर स्विच कर लिया है. साथ ही, अगर आपको कोई गड़बड़ी मिलती है, तो हमें बताएं. 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

क्या अब भी एपीआई के ज़रिए टिप्पणी की जा सकती है?

हां, लेकिन v2 एपीआई की मदद से नई टिप्पणियां लिखने के लिए कई शर्तें हैं:

  1. पुष्टि किए गए उपयोगकर्ता के पास किसी Google+ खाते से लिंक किया गया YouTube चैनल होना चाहिए (एपीआई की जानकारी)
  2. अनुरोध को एचटीटीपीएस के ज़रिए भेजा जाना चाहिए. लेगसी क्लाइंट लाइब्रेरी के मौजूदा वर्शन, डिफ़ॉल्ट रूप से इस सुविधा के साथ काम करते हैं

अगर इनमें से किसी भी शर्त को पूरा नहीं किया जाता, तो एपीआई आपको गड़बड़ी का मैसेज दिखाता है.

Google+ की मदद से की जाने वाली टिप्पणियों में थ्रेड की सुविधा मिलती है. YouTube पर टिप्पणियों के जवाब देने पर इसका क्या मतलब है?

ट्रांज़िशन से पहले की गई टिप्पणियों पर दिए गए जवाब, अब सामान्य टिप्पणियों के तौर पर दिखेंगे. इसके अलावा, YouTube API का इस्तेमाल करके सीधे टिप्पणियों का जवाब देने की सुविधा अब काम नहीं करती. फ़िलहाल, YouTube API का इस्तेमाल करके, नई स्टाइल की टिप्पणी का जवाब नहीं दिया जा सकता.

YouTube और Google+ की साइटों और ऐप्लिकेशन से, YouTube पर की गई नई टिप्पणियों के जवाब, लेगसी एपीआई के टिप्पणी फ़ीड में नहीं दिखते. हालांकि, Google+ API की मदद से आपको असली जवाब मिल सकते हैं.

अगर YouTube टिप्पणी फ़ीड की एंट्री में नई स्टाइल की टिप्पणी शामिल है, तो उस एंट्री में <yt:googlePlusUserId> टैग होता है. अगर वह टैग मौजूद है और टिप्पणी का कोई जवाब है (बस <yt:replyCount> एलिमेंट देखें), तो आप एंट्री के <id> टैग से Google+ गतिविधि आईडी को पार्स कर सकते हैं. उस आईडी का इस्तेमाल करके, Google+ API के comments:list तरीके को कॉल किया जा सकता है. इससे, उस टिप्पणी के हाल ही के जवाबों की सूची मिलती है.

यहां दिए गए उदाहरण से पता चलता है कि बोल्ड टेक्स्ट में दिखाया गया 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>

YouTube API की मदद से टिप्पणी करने पर, Google+ पर क्या होता है?

YouTube API की मदद से टिप्पणी करने पर, आपकी Google+ स्ट्रीम में कोई पोस्ट जनरेट नहीं होती. साथ ही, Google+ पर कोई सूचना भी नहीं भेजी जाती.

क्या टिप्पणी करने के नए सिस्टम पर स्विच करने के बाद भी, टिप्पणियां गतिविधि फ़ीड में दिखती हैं?

फ़िलहाल नहीं.

क्या लेगसी एपीआई में SUP, टिप्पणियों के लिए काम करता रहेगा?

नहीं, टिप्पणियों के लिए ऐसा नहीं है. SUP, उपयोगकर्ता की गतिविधि वाले फ़ीड पर निर्भर करता है. टिप्पणियां अब गतिविधि फ़ीड में नहीं दिखती हैं, इसलिए वे SUP में भी नहीं दिखती हैं.