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

यहां दिए गए उदाहरणों में, सदस्यताओं से जुड़े फ़ंक्शन करने के लिए, 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

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

  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