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

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

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

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

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

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

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

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

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

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

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

    अगर अनुरोध पूरा हो जाता है, तो एपीआई के जवाब में video संसाधन शामिल होगा. processingDetails.processingStatus प्रॉपर्टी की वैल्यू देखकर पता लगाएं कि YouTube अब भी वीडियो को प्रोसेस कर रहा है या नहीं. जब 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 API के 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