Subscriptions

subscription संसाधन में, YouTube का इस्तेमाल करने वाले किसी व्यक्ति की सदस्यता के बारे में जानकारी होती है. किसी चैनल की सदस्यता लेने पर, उपयोगकर्ता को सूचना मिलती है. यह सूचना तब मिलती है, जब चैनल पर नए वीडियो जोड़े जाते हैं या जब कोई दूसरा उपयोगकर्ता YouTube पर कई कार्रवाइयों में से कोई एक कार्रवाई करता है. जैसे, वीडियो अपलोड करना, वीडियो को रेटिंग देना या वीडियो पर टिप्पणी करना.

तरीके

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

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

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

यहां दिए गए JSON स्ट्रक्चर में, subscriptions संसाधन का फ़ॉर्मैट दिखाया गया है:

{
  "kind": "youtube#subscription",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelTitle": string,
    "title": string,
    "description": string,
    "resourceId": {
      "kind": string,
      "channelId": string,
    },
    "channelId": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    }
  },
  "contentDetails": {
    "totalItemCount": unsigned integer,
    "newItemCount": unsigned integer,
    "activityType": string
  },
  "subscriberSnippet": {
    "title": string,
    "description": string,
    "channelId": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    }
  }
}

प्रॉपर्टी

यहां दी गई टेबल में, इस संसाधन में दिखने वाली प्रॉपर्टी के बारे में बताया गया है:

प्रॉपर्टी
kind string
इससे एपीआई संसाधन के टाइप की पहचान होती है. वैल्यू youtube#subscription होगी.
etag etag
इस संसाधन का ETag.
id string
यह वह आईडी है जिसका इस्तेमाल YouTube, सदस्यता की खास तौर पर पहचान करने के लिए करता है.
snippet object
snippet ऑब्जेक्ट में, सदस्यता के बारे में बुनियादी जानकारी होती है. इसमें सदस्यता का टाइटल और वह चैनल शामिल होता है जिसकी सदस्यता उपयोगकर्ता ने ली है.
snippet.publishedAt datetime
सदस्यता बनाने की तारीख और समय. इसकी वैल्यू ISO 8601 फ़ॉर्मैट में दी जाती है.
snippet.title string
सदस्यता का नाम.
snippet.description string
सदस्यता की जानकारी.
snippet.resourceId object
id ऑब्जेक्ट में, उस चैनल के बारे में जानकारी होती है जिसकी सदस्यता उपयोगकर्ता ने ली है.
snippet.resourceId.kind string
एपीआई संसाधन का टाइप.
snippet.resourceId.channelId string
यह वह वैल्यू है जिसका इस्तेमाल YouTube, उस चैनल की खास तौर पर पहचान करने के लिए करता है जिसे उपयोगकर्ता ने सदस्यता ली है.
snippet.channelId string
यह वह आईडी है जिसका इस्तेमाल YouTube, सदस्य के चैनल की पहचान करने के लिए करता है. resource_id ऑब्जेक्ट, उस चैनल की पहचान करता है जिसकी सदस्यता उपयोगकर्ता ने ली है.
snippet.thumbnails object
सदस्यता से जुड़ी थंबनेल इमेज का मैप. मैप में मौजूद हर ऑब्जेक्ट के लिए, कुंजी थंबनेल इमेज का नाम होती है. साथ ही, वैल्यू एक ऐसा ऑब्जेक्ट होता है जिसमें थंबनेल के बारे में अन्य जानकारी होती है.
snippet.thumbnails.(key) object
कुंजी की मान्य वैल्यू ये हैं:
  • default – इस संसाधन के लिए डिफ़ॉल्ट थंबनेल इमेज. किसी वीडियो या वीडियो से जुड़े संसाधन (जैसे, प्लेलिस्ट आइटम या खोज नतीजा) के लिए डिफ़ॉल्ट थंबनेल, 120 पिक्सल चौड़ा और 90 पिक्सल लंबा होता है. किसी चैनल के लिए डिफ़ॉल्ट थंबनेल 88 पिक्सल चौड़ा और 88 पिक्सल लंबा होता है.
  • medium – थंबनेल इमेज का हाई रिज़ॉल्यूशन वाला वर्शन. किसी वीडियो या वीडियो का रेफ़रंस देने वाले संसाधन के लिए, इस इमेज की चौड़ाई 320 पिक्सल और लंबाई 180 पिक्सल होती है. किसी चैनल के लिए, यह इमेज 240 पिक्सल चौड़ी और 240 पिक्सल लंबी होती है.
  • high – थंबनेल इमेज का हाई रिज़ॉल्यूशन वर्शन. किसी वीडियो (या वीडियो का रेफ़रंस देने वाले संसाधन) के लिए, इस इमेज की चौड़ाई 480 पिक्सल और लंबाई 360 पिक्सल होती है. किसी चैनल के लिए, यह इमेज 800 पिक्सल चौड़ी और 800 पिक्सल लंबी होती है.
snippet.thumbnails.(key).url string
इमेज का यूआरएल.
snippet.thumbnails.(key).width unsigned integer
इमेज की चौड़ाई.
snippet.thumbnails.(key).height unsigned integer
इमेज की ऊंचाई.
contentDetails object
contentDetails ऑब्जेक्ट में सदस्यता के बारे में बुनियादी आंकड़े शामिल होते हैं.
contentDetails.totalItemCount unsigned integer
उन आइटम की अनुमानित संख्या जिन पर सदस्यता लागू होती है.
contentDetails.newItemCount unsigned integer
पिछली बार कॉन्टेंट पढ़े जाने के बाद से, सदस्यता में शामिल किए गए नए आइटम की संख्या.
contentDetails.activityType string
यह सदस्यता किस तरह की गतिविधि के लिए है (सिर्फ़ अपलोड, सभी).

इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
  • all
  • uploads
subscriberSnippet object
subscriberSnippet ऑब्जेक्ट में, सदस्य के बारे में बुनियादी जानकारी होती है.
subscriberSnippet.title string
सदस्य के चैनल का टाइटल.
subscriberSnippet.description string
सदस्य के चैनल का ब्यौरा.
subscriberSnippet.channelId string
यह वह आईडी है जो YouTube, सदस्य के चैनल की पहचान करने के लिए असाइन करता है.
subscriberSnippet.thumbnails object
सदस्यता लेने वाले व्यक्ति के चैनल के लिए थंबनेल इमेज.
subscriberSnippet.thumbnails.(key) object
कुंजी की मान्य वैल्यू ये हैं:
  • default – इस संसाधन के लिए डिफ़ॉल्ट थंबनेल इमेज. किसी वीडियो या वीडियो से जुड़े संसाधन (जैसे, प्लेलिस्ट आइटम या खोज नतीजा) के लिए डिफ़ॉल्ट थंबनेल, 120 पिक्सल चौड़ा और 90 पिक्सल लंबा होता है. किसी चैनल के लिए डिफ़ॉल्ट थंबनेल 88 पिक्सल चौड़ा और 88 पिक्सल लंबा होता है.
  • medium – थंबनेल इमेज का हाई रिज़ॉल्यूशन वाला वर्शन. किसी वीडियो या वीडियो का रेफ़रंस देने वाले संसाधन के लिए, इस इमेज की चौड़ाई 320 पिक्सल और लंबाई 180 पिक्सल होती है. किसी चैनल के लिए, यह इमेज 240 पिक्सल चौड़ी और 240 पिक्सल लंबी होती है.
  • high – थंबनेल इमेज का हाई रिज़ॉल्यूशन वर्शन. किसी वीडियो (या वीडियो का रेफ़रंस देने वाले संसाधन) के लिए, इस इमेज की चौड़ाई 480 पिक्सल और लंबाई 360 पिक्सल होती है. किसी चैनल के लिए, यह इमेज 800 पिक्सल चौड़ी और 800 पिक्सल लंबी होती है.
subscriberSnippet.thumbnails.(key).url string
इमेज का यूआरएल.
subscriberSnippet.thumbnails.(key).width unsigned integer
इमेज की चौड़ाई.
subscriberSnippet.thumbnails.(key).height unsigned integer
इमेज की ऊंचाई.