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 के लिए कोई वैल्यू सेट की है (इसका सुझाव नहीं दिया जाता), तो इससे अलग-अलग वैल्यू दिख सकती है. साथ ही, आपको कुछ ही टिप्पणियां दिखेंगी.

अपडेट (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

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

हां, लेकिन v2 API का इस्तेमाल करके नई टिप्पणियां लिखने के लिए, कई ज़रूरी शर्तें पूरी करनी होंगी:

  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, उपयोगकर्ता गतिविधि फ़ीड पर निर्भर करता है. टिप्पणियां अब गतिविधि फ़ीड में नहीं हैं, इसलिए वे एसयूपी में नहीं दिखेंगी.