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 कुंजी की मान्य वैल्यू ये हैं:
|
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 यह सदस्यता किस तरह की गतिविधि के लिए है (सिर्फ़ अपलोड, सभी). इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
subscriberSnippet |
object subscriberSnippet ऑब्जेक्ट में, सदस्य के बारे में बुनियादी जानकारी होती है. |
subscriberSnippet.title |
string सदस्य के चैनल का टाइटल. |
subscriberSnippet.description |
string सदस्य के चैनल का ब्यौरा. |
subscriberSnippet.channelId |
string यह वह आईडी है जो YouTube, सदस्य के चैनल की पहचान करने के लिए असाइन करता है. |
subscriberSnippet.thumbnails |
object सदस्यता लेने वाले व्यक्ति के चैनल के लिए थंबनेल इमेज. |
subscriberSnippet.thumbnails.(key) |
object कुंजी की मान्य वैल्यू ये हैं:
|
subscriberSnippet.thumbnails.(key).url |
string इमेज का यूआरएल. |
subscriberSnippet.thumbnails.(key).width |
unsigned integer इमेज की चौड़ाई. |
subscriberSnippet.thumbnails.(key).height |
unsigned integer इमेज की ऊंचाई. |