activities.list
वाला तरीका
अब भी चैनल बुलेटिन नहीं दिखाता है. साथ ही, activities.insert
वाला तरीका अब
काम नहीं करता. ज़्यादा जानकारी के लिए, कृपया
YouTube सहायता केंद्र पर जाएं.
activity
के संसाधन में, किसी चैनल या उपयोगकर्ता की YouTube पर की गई कार्रवाई की जानकारी होती है. गतिविधि फ़ीड में रिपोर्ट की गई कार्रवाइयों में, किसी वीडियो को रेटिंग देना, वीडियो शेयर करना, वीडियो को पसंदीदा के तौर पर मार्क करना, वीडियो अपलोड करना वगैरह शामिल हैं. हर activity
संसाधन, कार्रवाई के टाइप, कार्रवाई से जुड़े चैनल, और कार्रवाई से जुड़े संसाधनों की पहचान करता है. जैसे, वह वीडियो जिसे रेटिंग दी गई या अपलोड किया गया था.
तरीके
activities
संसाधनों के लिए, एपीआई नीचे दिए गए तरीकों के साथ काम करता है:
- list
- चैनल की ऐसी गतिविधियों की सूची दिखाता है जो अनुरोध की शर्तों से मेल खाती हैं. उदाहरण के लिए, किसी खास चैनल या उपयोगकर्ता के चैनल से जुड़े इवेंट की जानकारी फ़ेच की जा सकती है. इसे अभी आज़माएं.
activities.insert
वाला तरीका अब काम नहीं करता.
संसाधन दिखाना
यहां दिया गया JSON स्ट्रक्चर, activities
संसाधन का फ़ॉर्मैट दिखाता है:
{ "kind": "youtube#activity", "etag": etag, "id": string, "snippet": { "publishedAt": datetime, "channelId": string, "title": string, "description": string, "thumbnails": { (key): { "url": string, "width": unsigned integer, "height": unsigned integer } }, "channelTitle": string, "type": string, "groupId": string }, "contentDetails": { "upload": { "videoId": string }, "like": { "resourceId": { "kind": string, "videoId": string, } }, "favorite": { "resourceId": { "kind": string, "videoId": string, } }, "comment": { "resourceId": { "kind": string, "videoId": string, "channelId": string, } }, "subscription": { "resourceId": { "kind": string, "channelId": string, } }, "playlistItem": { "resourceId": { "kind": string, "videoId": string, }, "playlistId": string, "playlistItemId": string }, "recommendation": { "resourceId": { "kind": string, "videoId": string, "channelId": string, }, "reason": string, "seedResourceId": { "kind": string, "videoId": string, "channelId": string, "playlistId": string } }, "social": { "type": string, "resourceId": { "kind": string, "videoId": string, "channelId": string, "playlistId": string }, "author": string, "referenceUrl": string, "imageUrl": string }, "channelItem": { "resourceId": { } }, } }
प्रॉपर्टी
यहां दी गई टेबल में, इस संसाधन में दिखने वाली प्रॉपर्टी के बारे में बताया गया है:
प्रॉपर्टी | |
---|---|
kind |
string इससे पता चलता है कि एपीआई रिसॉर्स किस तरह का है. मान youtube#activity होगा. |
etag |
etag इस संसाधन का ईटैग. |
id |
string इस आईडी का इस्तेमाल करके, YouTube किसी गतिविधि की खास तरह से पहचान करता है. |
snippet |
object snippet ऑब्जेक्ट में, गतिविधि के बारे में बुनियादी जानकारी होती है. इसमें गतिविधि का टाइप और ग्रुप आईडी भी शामिल होता है. |
snippet.publishedAt |
datetime गतिविधि होने की तारीख और समय. यह वैल्यू ISO 8601 फ़ॉर्मैट में होती है. |
snippet.channelId |
string इस आईडी का इस्तेमाल करके, YouTube, गतिविधि से जुड़े चैनल की पहचान करता है. |
snippet.title |
string मुख्य रूप से गतिविधि से जुड़े संसाधन का टाइटल. |
snippet.description |
string मुख्य रूप से गतिविधि से जुड़े संसाधन की जानकारी. |
snippet.thumbnails |
object उस संसाधन से जुड़ी थंबनेल इमेज का मैप जो मुख्य तौर पर गतिविधि से जुड़ा है. मैप में हर ऑब्जेक्ट के लिए, कुंजी थंबनेल इमेज का नाम होती है और वैल्यू एक ऑब्जेक्ट होता है, जिसमें थंबनेल के बारे में अन्य जानकारी होती है. |
snippet.thumbnails.(key) |
object कुंजी की मान्य वैल्यू ये हैं:
|
snippet.thumbnails.(key).url |
string इमेज का यूआरएल. |
snippet.thumbnails.(key).width |
unsigned integer इमेज की चौड़ाई. |
snippet.thumbnails.(key).height |
unsigned integer इमेज की ऊंचाई. |
snippet.channelTitle |
string इस गतिविधि के लिए ज़िम्मेदार चैनल के चैनल का टाइटल |
snippet.type |
string संसाधन में किस तरह की गतिविधि के बारे में बताया गया है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
snippet.groupId |
string गतिविधि से जुड़ा ग्रुप आईडी. ग्रुप आईडी, एक ही उपयोगकर्ता और संसाधन से जुड़े उपयोगकर्ता इवेंट की पहचान करता है. उदाहरण के लिए, अगर कोई उपयोगकर्ता किसी वीडियो को रेटिंग देता है और उसे पसंदीदा के तौर पर मार्क करता है, तो उपयोगकर्ता के ऐक्टिविटी फ़ीड में उन इवेंट की एंट्री का ग्रुप आईडी एक ही होगा. अपने यूज़र इंटरफ़ेस में, एक ही groupId वैल्यू वाले इवेंट को ग्रुप करके, दोहराए जाने से बचा जा सकता है. |
contentDetails |
object contentDetails ऑब्जेक्ट में, गतिविधि से जुड़े कॉन्टेंट की जानकारी मौजूद होती है. उदाहरण के लिए, अगर snippet.type की वैल्यू videoRated है, तो contentDetails ऑब्जेक्ट का कॉन्टेंट, रेट किए गए वीडियो की पहचान करता है. |
contentDetails.upload |
object upload ऑब्जेक्ट में, अपलोड किए गए वीडियो के बारे में जानकारी होती है. यह प्रॉपर्टी सिर्फ़ तब मौजूद होती है, जब snippet.type , upload हो. |
contentDetails.upload.videoId |
string इस आईडी का इस्तेमाल करके YouTube, अपलोड किए गए वीडियो की खास तरह से पहचान करता है. |
contentDetails.like |
object like ऑब्जेक्ट में, ऐसे संसाधन के बारे में जानकारी होती है जिसे अच्छी (जैसे) रेटिंग मिली है. यह प्रॉपर्टी सिर्फ़ तब मौजूद होती है, जब snippet.type , like हो. |
contentDetails.like.resourceId |
object resourceId ऑब्जेक्ट में ऐसी जानकारी होती है जिससे रेट किए गए संसाधन की पहचान होती है. |
contentDetails.like.resourceId.kind |
string एपीआई रिसॉर्स किस तरह का है. |
contentDetails.like.resourceId.videoId |
string अगर किसी वीडियो को रेटिंग दी गई है, तो YouTube उस वीडियो की खास तरह से पहचान करने के लिए, इस आईडी का इस्तेमाल करता है. यह प्रॉपर्टी सिर्फ़ तब मौजूद होती है, जब resourceId.kind , youtube#video हो. |
contentDetails.favorite |
object favorite ऑब्जेक्ट में, उस वीडियो की जानकारी होती है जिसे पसंदीदा वीडियो के तौर पर मार्क किया गया था. यह प्रॉपर्टी सिर्फ़ तब मौजूद होती है, जब snippet.type , favorite हो. |
contentDetails.favorite.resourceId |
object resourceId ऑब्जेक्ट में ऐसी जानकारी होती है जो उस संसाधन की पहचान करती है जिसे पसंदीदा के तौर पर मार्क किया गया था. |
contentDetails.favorite.resourceId.kind |
string एपीआई रिसॉर्स किस तरह का है. |
contentDetails.favorite.resourceId.videoId |
string इस आईडी का इस्तेमाल करके, YouTube किसी पसंदीदा वीडियो की खास तरह से पहचान करता है. यह प्रॉपर्टी सिर्फ़ तब उपलब्ध होती है, जब resourceId.kind youtube#video हो.ध्यान दें: फ़िलहाल, activities.list वाला तरीका नई टिप्पणियों के लिए संसाधन नहीं दिखाता है. |
contentDetails.comment |
object comment ऑब्जेक्ट में, उस संसाधन के बारे में जानकारी होती है जिस पर कोई टिप्पणी की गई है. यह प्रॉपर्टी सिर्फ़ तब मौजूद होती है, जब snippet.type , comment हो. |
contentDetails.comment.resourceId |
object resourceId ऑब्जेक्ट में ऐसी जानकारी होती है जो टिप्पणी से जुड़े संसाधन की पहचान करती है. |
contentDetails.comment.resourceId.kind |
string एपीआई रिसॉर्स किस तरह का है. |
contentDetails.comment.resourceId.videoId |
string इस आईडी का इस्तेमाल करके, YouTube किसी टिप्पणी से जुड़े वीडियो की पहचान करता है. यह प्रॉपर्टी सिर्फ़ तब मौजूद होती है, जब resourceId.kind , youtube#video हो. |
contentDetails.comment.resourceId.channelId |
string इस आईडी का इस्तेमाल करके, YouTube किसी टिप्पणी से जुड़े चैनल की पहचान करता है. यह प्रॉपर्टी सिर्फ़ तब मौजूद होती है, जब resourceId.kind , youtube#channel हो. |
contentDetails.subscription |
object subscription ऑब्जेक्ट में, उस चैनल की जानकारी होती है जिसकी सदस्यता उपयोगकर्ता ने ली है. यह प्रॉपर्टी सिर्फ़ तब मौजूद होती है, जब snippet.type , subscription हो. |
contentDetails.subscription.resourceId |
object resourceId ऑब्जेक्ट में ऐसी जानकारी होती है जो उस संसाधन की पहचान करती है जिसकी सदस्यता उपयोगकर्ता ने ली है. |
contentDetails.subscription.resourceId.kind |
string एपीआई रिसॉर्स किस तरह का है. |
contentDetails.subscription.resourceId.channelId |
string इस आईडी का इस्तेमाल करके, YouTube उस चैनल की पहचान करता है जिसकी सदस्यता उपयोगकर्ता ने ली है. यह प्रॉपर्टी सिर्फ़ तब मौजूद होती है, जब resourceId.kind , youtube#channel हो. |
contentDetails.playlistItem |
object playlistItem ऑब्जेक्ट में, प्लेलिस्ट में मौजूद नए आइटम के बारे में जानकारी होती है. यह प्रॉपर्टी सिर्फ़ तब मौजूद होती है, जब snippet.type , playlistItem हो. |
contentDetails.playlistItem.resourceId |
object resourceId ऑब्जेक्ट में ऐसी जानकारी होती है जो प्लेलिस्ट में जोड़े गए संसाधन की पहचान करती है. |
contentDetails.playlistItem.resourceId.kind |
string एपीआई रिसॉर्स किस तरह का है. |
contentDetails.playlistItem.resourceId.videoId |
string इस आईडी का इस्तेमाल करके, YouTube उस वीडियो की पहचान करता है जिसे प्लेलिस्ट में जोड़ा गया था. यह प्रॉपर्टी सिर्फ़ तब मौजूद होती है, जब resourceId.kind , youtube#video हो. |
contentDetails.playlistItem.playlistId |
string वह वैल्यू जिसका इस्तेमाल YouTube, खास तरीके से किसी प्लेलिस्ट की पहचान करने के लिए करता है. |
contentDetails.playlistItem.playlistItemId |
string वह वैल्यू जिसका इस्तेमाल YouTube, प्लेलिस्ट में मौजूद किसी आइटम की खास तरह से पहचान करने के लिए करता है. |
contentDetails.recommendation |
object recommendation ऑब्जेक्ट में, सुझाए गए संसाधन के बारे में जानकारी होती है. यह प्रॉपर्टी सिर्फ़ तब मौजूद होती है, जब snippet.type , recommendation हो. |
contentDetails.recommendation.resourceId |
object resourceId ऑब्जेक्ट में, सुझाए गए संसाधन की पहचान करने वाली जानकारी मौजूद होती है. |
contentDetails.recommendation.resourceId.kind |
string एपीआई रिसॉर्स किस तरह का है. |
contentDetails.recommendation.resourceId.videoId |
string अगर सुझाया गया संसाधन कोई वीडियो है, तो YouTube इस आईडी का इस्तेमाल किसी वीडियो की खास तरह से पहचान करने के लिए करता है. यह प्रॉपर्टी सिर्फ़ तब मौजूद होती है, जब resourceId.kind , youtube#video हो. |
contentDetails.recommendation.resourceId.channelId |
string अगर सुझाया गया संसाधन कोई चैनल है, तो YouTube इस आईडी का इस्तेमाल किसी चैनल की खास तरह से पहचान करने के लिए करता है. यह प्रॉपर्टी सिर्फ़ तब मौजूद होती है, जब resourceId.kind , youtube#channel हो. |
contentDetails.recommendation.reason |
string उपयोगकर्ता को यह संसाधन किस वजह से सुझाया गया है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.recommendation.seedResourceId |
object seedResourceId ऑब्जेक्ट में, उस संसाधन के बारे में जानकारी होती है जिसकी वजह से सुझाव बनाया गया था. |
contentDetails.recommendation.seedResourceId.kind |
string एपीआई रिसॉर्स किस तरह का है. |
contentDetails.recommendation.seedResourceId.videoId |
string इस आईडी का इस्तेमाल करके, YouTube किसी वीडियो की खास तरह से पहचान करता है. ऐसा तब होता है, जब सुझाव किसी वीडियो की वजह से मिला हो. यह प्रॉपर्टी सिर्फ़ तब मौजूद होती है, जब seedResourceId.kind , youtube#video हो. |
contentDetails.recommendation.seedResourceId.channelId |
string अगर किसी चैनल का सुझाव किसी खास चैनल से मिला है, तो YouTube इस आईडी का इस्तेमाल, किसी चैनल की खास तरह से पहचान करने के लिए करता है. यह प्रॉपर्टी सिर्फ़ तब मौजूद होती है, जब seedResourceId.kind , youtube#channel हो. |
contentDetails.recommendation.seedResourceId.playlistId |
string इस आईडी का इस्तेमाल करके, YouTube किसी प्लेलिस्ट की खास तरह से पहचान करता है. ऐसा तब होता है, जब किसी प्लेलिस्ट से सुझाव मिला हो. यह प्रॉपर्टी सिर्फ़ तब मौजूद होती है, जब seedResourceId.kind , youtube#playlist हो. |
contentDetails.social |
object social ऑब्जेक्ट में, सोशल नेटवर्क पोस्ट के बारे में जानकारी होती है. यह प्रॉपर्टी सिर्फ़ तब मौजूद होती है, जब snippet.type , social हो. |
contentDetails.social.type |
string सोशल नेटवर्क का नाम. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails.social.resourceId |
object resourceId ऑब्जेक्ट में ऐसी जानकारी शामिल होती है जो किसी सोशल नेटवर्क पोस्ट से जुड़े संसाधन की पहचान करती है. |
contentDetails.social.resourceId.kind |
string एपीआई रिसॉर्स किस तरह का है. |
contentDetails.social.resourceId.videoId |
string YouTube इस आईडी का इस्तेमाल करके, किसी सोशल नेटवर्क पोस्ट में दिखाए गए वीडियो की पहचान करता है. ऐसा तब होता है, जब पोस्ट किसी वीडियो से जुड़ी हो. यह प्रॉपर्टी सिर्फ़ तब दिखेगी, जब social.resourceId.kind प्रॉपर्टी की वैल्यू youtube#video हो. |
contentDetails.social.resourceId.channelId |
string YouTube इस आईडी का इस्तेमाल करके, सोशल नेटवर्क पोस्ट में दिखाए गए चैनल की पहचान करता है. ऐसा तब होता है, जब पोस्ट किसी चैनल से जुड़ी हो. यह प्रॉपर्टी सिर्फ़ तब दिखेगी, जब social.resourceId.kind प्रॉपर्टी की वैल्यू youtube#channel हो. |
contentDetails.social.resourceId.playlistId |
string इस आईडी का इस्तेमाल करके, YouTube किसी सोशल नेटवर्क पोस्ट में दिखाई गई प्लेलिस्ट की पहचान करता है. ऐसा तब होता है, जब कोई पोस्ट किसी प्लेलिस्ट से जुड़ी होती है. यह प्रॉपर्टी सिर्फ़ तब दिखेगी, जब social.resourceId.kind प्रॉपर्टी की वैल्यू youtube#playlist हो. |
contentDetails.social.author |
string सोशल नेटवर्क पोस्ट को लिखने वाला. |
contentDetails.social.referenceUrl |
string सोशल नेटवर्क पोस्ट का यूआरएल. |
contentDetails.social.imageUrl |
string पोस्ट के लेखक की इमेज. |
contentDetails.channelItem |
object channelItem ऑब्जेक्ट में, किसी चैनल में जोड़े गए संसाधन की जानकारी होती है. यह प्रॉपर्टी सिर्फ़ तब मौजूद होती है, जब snippet.type , channelItem हो. |
contentDetails.channelItem.resourceId |
object resourceId ऑब्जेक्ट में ऐसी जानकारी होती है जो चैनल में जोड़े गए संसाधन की पहचान करती है. |