लागू करने का तरीका: वीडियो

वीडियो से जुड़े फ़ंक्शन करने के लिए, YouTube Data API (v3) का इस्तेमाल करने का तरीका यहां बताया गया है.

चैनल के अपलोड किए गए वीडियो वापस पाना

इस उदाहरण में, किसी खास चैनल पर अपलोड किए गए वीडियो वापस मिलते हैं. इस उदाहरण में दो चरण दिए गए हैं:

  • पहला चरण: चैनल के अपलोड किए गए वीडियो की प्लेलिस्ट आईडी फिर से पाना

    चैनल के अपलोड किए गए वीडियो की प्लेलिस्ट का आईडी वापस पाने के लिए, channels.list तरीके को कॉल करें. अनुरोध के part पैरामीटर की वैल्यू में, contentDetails को शामिल किया जाना चाहिए. यह channel वाले रिसॉर्स पार्ट में से किसी एक के तौर पर मिलता है. एपीआई से मिले रिस्पॉन्स में, contentDetails.relatedPlaylists.uploads प्रॉपर्टी में प्लेलिस्ट आईडी शामिल है.

    चैनल की पहचान करने के कई तरीके हैं:

  • दूसरा चरण: अपलोड किए गए वीडियो की सूची वापस पाना

    अपलोड किए गए वीडियो की सूची पाने के लिए, playlistItems.list तरीके को कॉल करें. पहले चरण में मिली वैल्यू पर, playlistId पैरामीटर की वैल्यू सेट करें. इस उदाहरण में, पैरामीटर वैल्यू UUK8sQmJBp8GCxrOtXWBpyEA पर सेट है, जो Google के आधिकारिक YouTube चैनल पर अपलोड किए गए वीडियो की सूची है.

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.playlistItems.list?
            part=snippet,contentDetails,status
            &playlistId=UUK8sQmJBp8GCxrOtXWBpyEA

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

सबसे लोकप्रिय वीडियो की सूची वापस पाने के लिए, videos.list तरीके पर कॉल करें और chart पैरामीटर की वैल्यू mostPopular पर सेट करें. इस सूची को वापस लाते समय, आप इनमें से किसी एक या दोनों पैरामीटर को सेट कर सकते हैं:

  • regionCode यह एपीआई किसी खास इलाके के लिए, वीडियो की सूची लौटाने का निर्देश देता है.
  • videoCategoryId, उस वीडियो की कैटगरी के बारे में बताता है जिसके लिए सबसे लोकप्रिय वीडियो वापस लाए जाने हैं.

नीचे दिया गया अनुरोध स्पेन के सबसे लोकप्रिय खेल वीडियो को दिखाता है:

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &chart=mostPopular
        &regionCode=es
        &videoCategoryId=17

वीडियो अपलोड करना

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

  • एपीआई के videos.insert तरीके के दस्तावेज़ में कोड के कई नमूने शामिल हैं. इनमें वीडियो की प्रोग्रामिंग के लिए अलग-अलग भाषाओं में वीडियो अपलोड करने का तरीका बताया गया है.

  • फिर से शुरू किए जा सकने वाले अपलोड गाइड में, एचटीटीपी अनुरोधों के क्रम के बारे में बताया जाता है. इन अनुरोधों का इस्तेमाल करके ऐप्लिकेशन, फिर से अपलोड करने की प्रोसेस का इस्तेमाल करके वीडियो अपलोड करता है. यह गाइड मुख्य तौर पर उन डेवलपर के लिए है जो Google API क्लाइंट लाइब्रेरी का इस्तेमाल नहीं कर सकते. इनमें से कुछ गाइड में, ऐसे वीडियो के लिए नेटिव सहायता मिलती है जिन्हें फिर से शुरू किया जा सकता है.

  • वीडियो अपलोड करने के लिए JavaScript का उदाहरण, सीओआरएस (क्रॉस-ऑरिजिन रिसॉर्स शेयरिंग) का इस्तेमाल करके दिखाता है कि वेब पेज से वीडियो फ़ाइल कैसे अपलोड की जाती है. सीओआरएस अपलोड लाइब्रेरी, जिसमें v3 एपीआई सामान्य तौर पर दोबारा अपलोड करने की सुविधा देता है. इसके अलावा, इस उदाहरण में video संसाधन के processingDetails हिस्से को फिर से पाने के साथ-साथ, अपलोड किए गए वीडियो के लिए स्थिति में बदलावों को हैंडल करने के तरीके के बारे में भी बताया गया है.

अपलोड किए गए वीडियो की स्थिति देखना

इस उदाहरण में, अपलोड किए गए वीडियो की स्थिति देखने का तरीका बताया गया है. अपलोड किया गया वीडियो, पुष्टि किए गए उपयोगकर्ता के अपलोड किए गए वीडियो फ़ीड में तुरंत दिखेगा. हालांकि, वीडियो YouTube पर तब तक नहीं दिखेगा, जब तक उसे प्रोसेस नहीं किया जाता.

  • पहला चरण: वीडियो अपलोड करना

    वीडियो अपलोड करने के लिए, videos.insert तरीके को कॉल करें. अगर अनुरोध पूरा हो जाता है, तो एपीआई की जांच के नतीजे में video रिसॉर्स शामिल होगा. यह रिसॉर्स, अपलोड किए गए वीडियो के यूनीक वीडियो आईडी की पहचान करता है.

  • दूसरा चरण: वीडियो की स्थिति देखना

    वीडियो की स्थिति देखने के लिए, videos.list तरीके को कॉल करें. पहले चरण में मिले वीडियो आईडी के लिए, id पैरामीटर की वैल्यू सेट करें. part पैरामीटर की वैल्यू processingDetails पर सेट करें.

    अगर अनुरोध को सही तरीके से हैंडल किया जाता है, तो एपीआई से मिले रिस्पॉन्स में video रिसॉर्स शामिल होगा. processingDetails.processingStatus प्रॉपर्टी की वैल्यू की जांच करके पता लगाएं कि YouTube अब भी वीडियो को प्रोसेस कर रहा है या नहीं. प्रॉपर्टी के लिए, processing के बजाय कोई और वैल्यू इस्तेमाल की जा सकती है. जैसे, succeeded या failed.

    अनुरोध का मुख्य हिस्सा एक video रिसॉर्स है. जिसे id प्रॉपर्टी, उस वीडियो के वीडियो आईडी के बारे में बताती है जिसे मिटाया जा रहा है. इस उदाहरण में, संसाधन में एक recordingDetails ऑब्जेक्ट भी है.

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

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.list?
            part=snippet,processingDetails
            &id=VIDEO_ID

ध्यान दें: हाल ही में अपलोड किए गए किसी वीडियो की स्थिति देखने के लिए, आपका ऐप्लिकेशन इस एपीआई का इस्तेमाल कर सकता है. वीडियो प्रोसेस हो जाने के बाद, आपका ऐप्लिकेशन बुलेटिन बना सकता है या वीडियो की स्थिति के आधार पर दूसरी कार्रवाई कर सकता है.

वीडियो अपडेट करना

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

  • पहला चरण: वीडियो आईडी वापस पाना

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

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

  • दूसरा चरण: वीडियो अपडेट करना

    किसी खास वीडियो को अपडेट करने के लिए, videos.update तरीके को कॉल करें. part पैरामीटर की वैल्यू recordingDetails पर सेट करें. (पैरामीटर वैल्यू इस बात पर निर्भर करती है कि वीडियो के मेटाडेटा फ़ील्ड अपडेट किए जा रहे हैं या नहीं.)

    अनुरोध का मुख्य हिस्सा एक video रिसॉर्स है. id प्रॉपर्टी में उस वीडियो के वीडियो आईडी की जानकारी होती है जिसे अपडेट किया जा रहा है. इस उदाहरण में, संसाधन में एक recordingDetails ऑब्जेक्ट भी है.

    नीचे दिए गए सैंपल संसाधन से पता चलता है कि वीडियो को 30 अक्टूबर, 2013 को बॉस्टन में रिकॉर्ड किया गया था:

    {
      "id": "VIDEO_ID",
      "recordingDetails": {
        "location": {
          "latitude": "42.3464",
          "longitude": "-71.0975"
        }
        "recordingDate": "2013-10-30T23:15:00.000Z"
      }
    }

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

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

कस्टम थंबनेल इमेज अपलोड करें और उसे किसी वीडियो के लिए सेट करें

v3 एपीआई का thumbnails.set इस्तेमाल करके, कस्टम थंबनेल इमेज अपलोड की जा सकती है. साथ ही, इसे किसी वीडियो के लिए सेट किया जा सकता है. आपके अनुरोध में, videoId पैरामीटर की वैल्यू उस वीडियो की पहचान करती है जिसके लिए थंबनेल का इस्तेमाल किया जाएगा.

इस क्वेरी की जांच एपीआई एक्सप्लोरर का इस्तेमाल करके नहीं की जा सकती, क्योंकि एपीआई एक्सप्लोरर मीडिया फ़ाइलों को अपलोड करने की सुविधा नहीं देता है, जो इस तरीके के लिए ज़रूरी है.

मिलते-जुलते कोड के नमूने: PHP, Python

वीडियो मिटाना

इस उदाहरण में, वीडियो को मिटाने का तरीका बताया गया है. उदाहरण में नीचे दिए गए चरण शामिल हैं:

  • पहला चरण: वीडियो आईडी वापस पाना

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

    ध्यान दें: वीडियो आईडी पाने के कई और तरीके हैं, जैसे कि खोज नतीजों को फिर से पाना या किसी प्लेलिस्ट में आइटम की सूची बनाना. हालांकि, वीडियो को सिर्फ़ उसका मालिक ही मिटा सकता है, लेकिन वीडियो हटाने के लिए अनुरोध करने वाले व्यक्ति के मालिकाना हक वाले वीडियो की सूची हासिल करना, इस प्रोसेस का पहला कदम हो सकता है.

  • दूसरा चरण: वीडियो मिटाना

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

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

गलत इस्तेमाल वाले वीडियो की शिकायत करना

इस उदाहरण में, बुरे बर्ताव वाले वीडियो की शिकायत करने का तरीका बताया गया है. उदाहरण में नीचे दिए गए चरण शामिल हैं:

  • पहला चरण: वीडियो की शिकायत करने की वजह बताना.

    वीडियो को फ़्लैग करने की मान्य वजहों की सूची पाने के लिए, videoAbuseReportReasons.list तरीके का अनुरोध किया गया हो. नीचे दिए गए सैंपल videoAbuseReportReason संसाधन में, ऐसे वीडियो को फ़्लैग करने से जुड़ी जानकारी दी गई है जिसमें स्पैम या गुमराह करने वाला कॉन्टेंट है.

    {
      "kind": "youtube#videoAbuseReportReason",
      "etag": "\"tbWC5XrSXxe1WOAx6MK9z4hHSU8/Or2VqBIilpHU7j__oPzUFCvGVBw\"",
      "id": "S",
      "snippet": {
        "label": "Spam or misleading",
        "secondaryReasons": [
          {
            "id": "27",
            "label": "Spam or mass advertising"
          },
          {
            "id": "28",
            "label": "Misleading thumbnail"
          },
          {
            "id": "29",
            "label": "Malware or phishing"
          },
          {
            "id": "30",
            "label": "Pharmaceutical drugs for sale"
          },
          {
            "id": "31",
            "label": "Other misleading info"
          }
        ]
      }
    }

    जैसा कि संसाधन में दिखाया गया है, यह वजह, दूसरी वजहों की सूची से जुड़ी है. स्पैम वाले किसी वीडियो को फ़्लैग करते समय, आपको वजह के साथ आईडी देना होगा. साथ ही, हम आपको इसकी दूसरी वजह भी बताना चाहते हैं.

  • दूसरा चरण: यौन शोषण वाले कॉन्टेंट के लिए वीडियो को फ़्लैग करना

    वीडियो की शिकायत करने के लिए, videos.reportAbuse तरीके का इस्तेमाल करके अनुमति वाला अनुरोध भेजें. अनुरोध का मुख्य हिस्सा एक JSON ऑब्जेक्ट है. यह वीडियो फ़्लैग किए जाने और उसकी वजह, दोनों की पहचान करता है. जैसा कि पहले चरण में बताया गया है, कुछ वजहों से दूसरी वजहों को भी शामिल किया जा सकता है और उन्हें बढ़ावा दिया जाएगा.

    JSON ऑब्जेक्ट की videoId प्रॉपर्टी, फ़्लैग किए गए वीडियो की पहचान करती है.

    नीचे दिए गए JSON ऑब्जेक्ट, स्पैम या गुमराह करने वाले कॉन्टेंट के बारे में बताने वाले वीडियो को फ़्लैग करते हैं. इसमें खास तौर पर, गुमराह करने वाले थंबनेल की इमेज का इस्तेमाल करने के बारे में बताया गया है. जैसा कि ऊपर JSON ऑब्जेक्ट में दिखाया गया है, स्पैम या गुमराह करने वाले कॉन्टेंट का आईडी S है. गुमराह करने वाले थंबनेल का आईडी 28 है.

    {
      "videoId": "VIDEO_ID",
      "reasonId": "S",
      "secondaryReasonId": "28",
      "comments": "Testing the video flagging feature.",
      "language": "en"
    }

    videos.reportAbuse अनुरोध को OAuth 2.0 का इस्तेमाल करके अनुमति देनी होगी. नीचे दिया गया लिंक, एपीआई एक्सप्लोरर में ऊपर दिए गए JSON ऑब्जेक्ट को लोड करता है. क्वेरी की जांच करने के लिए, आपको videoId प्रॉपर्टी की वैल्यू का एक मान्य वीडियो आईडी डालना होगा. कृपया याद रखें कि इस अनुरोध को सबमिट करने से वीडियो फ़्लैग कर दिया जाएगा.

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.reportAbuse