Activities

activity रिसॉर्स में, किसी चैनल या उपयोगकर्ता की YouTube पर की गई कार्रवाई के बारे में जानकारी होती है. गतिविधि फ़ीड में, वीडियो को रेटिंग देना, वीडियो शेयर करना, वीडियो को पसंदीदा के तौर पर मार्क करना, वीडियो अपलोड करना वगैरह जैसी कार्रवाइयों की जानकारी दी जाती है. हर activity संसाधन से, कार्रवाई के टाइप, कार्रवाई से जुड़े चैनल, और कार्रवाई से जुड़े संसाधनों की पहचान होती है. जैसे, जिस वीडियो को रेटिंग दी गई है या अपलोड किया गया है.

तरीके

एपीआई, activities संसाधनों के लिए इन तरीकों का इस्तेमाल करता है:

list

यह अनुरोध की शर्तों से मेल खाने वाले, चैनल की गतिविधि से जुड़े इवेंट की सूची दिखाता है. उदाहरण के लिए, किसी चैनल या उपयोगकर्ता के चैनल से जुड़े इवेंट वापस लाए जा सकते हैं. इसे अभी आज़माएं.

संसाधन का रेप्रज़ेंटेशन

यहां दिए गए 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 इस संसाधन का 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 The type of activity that the resource describes. Valid values for this property are: channelItem comment – (फ़िलहाल, वापस नहीं किया गया) favorite like playlistItem promotedItem recommendation social subscription upload
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 ऑब्जेक्ट में, चैनल में जोड़े गए संसाधन की पहचान करने वाली जानकारी होती है.