YouTube डेटा एपीआई के पुराने वर्शन में टिप्पणी में बदलाव

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

सुविधा के बारे में जानकारी

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

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

हमारा सुझाव है कि आप इस बात की पुष्टि करें कि आपका इंटिग्रेशन अब भी काम कर रहा है. इसलिए, हम नए टिप्पणी करने वाले सिस्टम पर स्विच कर चुके हैं. अगर आपको कोई गड़बड़ी (youtube.com/dev पर फ़ाइल की समस्याएं) मिलती है, तो हम आपको इसकी सूचना देंगे. धन्यवाद!

अक्सर पूछे जाने वाले सवाल

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

संक्रमण से पहले पोस्ट की गई टिप्पणियां Google+ द्वारा सक्षम किए गए नए सिस्टम पर माइग्रेट कर दी गई हैं.

क्या टिप्पणियों का फ़ीड अब भी उपलब्ध है?

हां, उदाहरण के लिए, अगर आप किसी वीडियो के लिए टिप्पणियों को वापस पाने के लिए एपीआई का इस्तेमाल करते हैं, तो आपको प्रासंगिकता के हिसाब से क्रम में लगाई गई उन टिप्पणियों का फ़ीड मिलता है जो एलान में किए गए हैं.* टिप्पणी करने वाले नए सिस्टम पर स्विच करने के बाद, डिफ़ॉल्ट रूप से टिप्पणियां अब समय के हिसाब से क्रम में नहीं रहेंगी. हालांकि, नीचे दिए गए उदाहरण में दिखाया गया है कि आप अपने एपीआई अनुरोध में, orderby पैरामीटर की वैल्यू को published पर सेट करके, तारीख के हिसाब से टिप्पणियों का क्रम तय कर सकते हैं:

https://gdata.youtube.com/feeds/api/videos/VIDEO_ID/comments?orderby=published

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

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