Subscriptions

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

तरीके

subscriptions संसाधनों के लिए, एपीआई नीचे दिए गए तरीकों के साथ काम करता है:

list

यह एपीआई अनुरोध की शर्तों से मेल खाने वाले सदस्यता संसाधन दिखाता है. इसे अभी आज़माएं.

डालें

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

मिटाएं

सदस्यता को मिटाता है. इसे अभी आज़माएं.

संसाधन दिखाना

यहां दिया गया 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 इस संसाधन का ईटैग.
id	string इस आईडी का इस्तेमाल करके, YouTube किसी सदस्यता की खास तरह से पहचान करता है.
snippet	object snippet ऑब्जेक्ट में, सदस्यता के बारे में बुनियादी जानकारी होती है. जैसे, सदस्यता का टाइटल और वह चैनल जिसकी सदस्यता उपयोगकर्ता ने ली है.
snippet.publishedAt	datetime सदस्यता बनाने की तारीख और समय. यह वैल्यू ISO 8601 फ़ॉर्मैट में होती है.
snippet.channelTitle	string उस चैनल का टाइटल जिसकी सदस्यता है.
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 इमेज की ऊंचाई.