लागू करने का तरीका: सदस्यताएं

सदस्यताओं से जुड़े फ़ंक्शन करने के लिए, YouTube Data API (v3) का इस्तेमाल कैसे किया जाता है, यहां दिए गए उदाहरण देखें.

चैनल की सदस्यताएं वापस पाना

किसी खास चैनल की सदस्यताएं पाने के लिए subscriptions.list तरीके पर कॉल करें. चैनल की पहचान करने के दो तरीके हैं:

• मौजूदा समय में पुष्टि किए गए उपयोगकर्ता की सदस्यताएं वापस पाने के लिए, mine पैरामीटर की वैल्यू true पर सेट करें. ध्यान दें कि mine पैरामीटर का इस्तेमाल करने वाले अनुरोध को OAuth 2.0 का इस्तेमाल करके अनुमति देनी होगी.

  https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.list?
          part=snippet,contentDetails
          &mine=true

• किसी और चैनल की सदस्यताएं वापस पाने के लिए, चैनल के खास YouTube चैनल आईडी की channelId पैरामीटर वैल्यू सेट करें. नीचे दिए गए उदाहरण में, उन चैनलों की सूची दी गई है जिनकी सदस्यता, TED YouTube चैनल पर ली गई है.

  https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.list?
          part=snippet,contentDetails
          &channelId=UCAuUUnT6oDeKwE6v1NGQxug

  ध्यान दें: अगर किसी चैनल की सदस्यताएं 'सार्वजनिक' के तौर पर सेट नहीं होती हैं और मालिक को अनुरोध नहीं भेजा जाता है, तो एपीआई 403 (Forbidden) एचटीटीपी रिस्पॉन्स कोड दिखाता है.

कोड सैंपल के लिए, subscriptions.list तरीके का दस्तावेज़ देखें.

कोई सदस्यता जोड़ें

चैनल की सदस्यता जोड़ने के लिए, subscriptions.insert तरीके को कॉल करें. यह अनुरोध OAuth 2.0 का उपयोग करके अधिकृत होना चाहिए. अनुरोध का मुख्य हिस्सा एक subscription रिसॉर्स है, जो ये वैल्यू सेट करता है:

• snippet.resourceId.kind में youtube#channel मान शामिल है.
• snippet.resourceId.channelId प्रॉपर्टी उस चैनल की पहचान करती है जिसकी आपने सदस्यता ली है. प्रॉपर्टी की वैल्यू एक यूनीक YouTube चैनल आईडी है. चैनल आईडी एक से ज़्यादा तरीकों से पाया जा सकता है. इसमें channels.list के तरीके को कॉल करना या चैनल के लिए खोज के नतीजे पाना शामिल है.

नीचे दिया गया एपीआई अनुरोध आपको YouTube पर TED चैनल की सदस्यता देता है:

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.insert?
        part=snippet

अनुरोध का मुख्य हिस्सा यह है:

{
  "snippet": {
    "resourceId": {
      "kind": "youtube#channel",
      "videoId": "UCAuUUnT6oDeKwE6v1NGQxug"
    }
  }
}

कोड सैंपल के लिए, subscriptions.insert तरीके का दस्तावेज़ देखें.

सदस्यता मिटाना

इस उदाहरण से सदस्यता मिट जाती है. यह अनुरोध OAuth 2.0 का उपयोग करके अधिकृत होना चाहिए. इस उदाहरण में दो चरण दिए गए हैं:

• पहला चरण: पुष्टि किए गए उपयोगकर्ता के चैनल की सदस्यताएं फिर से पाना

  सदस्यताओं की सूची फिर से पाने के लिए, subscriptions.list तरीके को कॉल करें. चैनल की सदस्यताएं वापस पाने के लिए ऊपर दिया गया उदाहरण, अनुरोध करने का तरीका बताता है.

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

• दूसरा चरण: सदस्यता मिटाना

  सदस्यता मिटाने के लिए, subscriptions.delete का तरीका अपनाएं. आपको जिस सदस्यता को हटाना है उसके लिए, सदस्यता के आईडी में अनुरोध के id पैरामीटर को सेट करें. यह अनुरोध OAuth 2.0 का उपयोग करके अधिकृत होना चाहिए.

  एपीआई एक्सप्लोरर में अनुरोध पूरा करने के लिए, आपको id प्रॉपर्टी की वैल्यू सेट करनी होगी.

  https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.delete?
          id=SUBSCRIPTION_ID

कोड सैंपल के लिए, subscriptions.delete तरीके का दस्तावेज़ देखें.

अनुमति वाले उपयोगकर्ता के चैनल पर सदस्यों की सूची लाना

ऐसे चैनलों की सूची फिर से पाने के लिए जिन्होंने मौजूदा समय में उपयोगकर्ता के चैनल की सदस्यता ली है, subscriptions.list वाले तरीके पर कॉल करें और mySubscribers पैरामीटर की वैल्यू को true पर सेट करें. अनुरोध को OAuth 2.0 का इस्तेमाल करके अनुमति दी जानी चाहिए.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.list?
        part=snippet,contentDetails
        &mySubscribers=true