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 पिक्सल लंबी है.
  • standardhigh रिज़ॉल्यूशन वाली इमेज के मुकाबले थंबनेल इमेज का ज़्यादा रिज़ॉल्यूशन वाला वर्शन. यह इमेज, प्लेलिस्ट में मौजूद आइटम या खोज के नतीजों जैसे कुछ वीडियो और उनसे जुड़े अन्य संसाधनों के लिए उपलब्ध है. इस इमेज की चौड़ाई 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 ऑब्जेक्ट में ऐसी जानकारी है जो चैनल में जोड़े गए संसाधन की पहचान करती है.