Activities

YouTube ने चैनल बुलेटिन की सुविधा बंद कर दी है. 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 कुंजी की मान्य वैल्यू ये हैं: default – डिफ़ॉल्ट थंबनेल इमेज. किसी वीडियो या प्लेलिस्ट के आइटम या खोज के नतीजे जैसे किसी वीडियो के बारे में बताने वाले संसाधन के लिए डिफ़ॉल्ट थंबनेल 120 पिक्सल चौड़ा और 90 पिक्सल लंबा होता है. किसी चैनल के लिए डिफ़ॉल्ट थंबनेल 88 पिक्सल चौड़ा और 88 पिक्सल लंबा होता है. medium – थंबनेल इमेज का ज़्यादा रिज़ॉल्यूशन वाला वर्शन. किसी वीडियो (या वीडियो के बारे में बताने वाले संसाधन) के लिए, यह इमेज 320 पिक्सल चौड़ी और 180 पिक्सल ऊंची है. चैनल के लिए यह इमेज 240 पिक्सल चौड़ी और 240 पिक्सल लंबी है. high – थंबनेल इमेज का हाई रिज़ॉल्यूशन वर्शन. किसी वीडियो (या वीडियो के बारे में बताने वाले संसाधन) के लिए, यह इमेज 480 पिक्सल चौड़ी और 360 पिक्सल लंबी है. चैनल के लिए, यह इमेज 800 पिक्सल चौड़ी और 800 पिक्सल लंबी है. standard – थंबनेल इमेज का इससे भी ज़्यादा रिज़ॉल्यूशन वाला वर्शन, जो high रिज़ॉल्यूशन वाली इमेज से बेहतर होता है. यह इमेज, वीडियो से जुड़े कुछ वीडियो और दूसरे संसाधनों के लिए उपलब्ध है. जैसे, प्लेलिस्ट में मौजूद आइटम या खोज के नतीजे. यह इमेज 640 पिक्सल चौड़ी और 480 पिक्सल लंबी है. maxres – थंबनेल इमेज का सबसे ज़्यादा रिज़ॉल्यूशन वाला वर्शन. इमेज का यह साइज़, कुछ वीडियो और वीडियो के बारे में जानकारी देने वाले दूसरे संसाधनों के लिए उपलब्ध है. जैसे, प्लेलिस्ट के आइटम या खोज के नतीजे. यह इमेज 1280 पिक्सल चौड़ी और 720 पिक्सल ऊंची है.
snippet.thumbnails.(key).url	string इमेज का यूआरएल.
snippet.thumbnails.(key).width	unsigned integer इमेज की चौड़ाई.
snippet.thumbnails.(key).height	unsigned integer इमेज की ऊंचाई.
snippet.channelTitle	string इस गतिविधि के लिए ज़िम्मेदार चैनल के चैनल का टाइटल
snippet.type	string संसाधन में किस तरह की गतिविधि के बारे में बताया गया है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं: channelItem comment – (फ़िलहाल, उपलब्ध नहीं है) favorite like playlistItem promotedItem recommendation social subscription upload bulletin (अब सेवा में नहीं है)
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 उपयोगकर्ता को यह संसाधन किस वजह से सुझाया गया है. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं: videoFavorited videoLiked videoWatched
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 सोशल नेटवर्क का नाम. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं: facebook googlePlus twitter unspecified
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 ऑब्जेक्ट में ऐसी जानकारी होती है जो चैनल में जोड़े गए संसाधन की पहचान करती है.