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

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

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

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

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

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

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

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

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

    • forUsername पैरामीटर को YouTube उपयोगकर्ता नाम पर सेट करें, ताकि उस उपयोगकर्ता नाम से जुड़े चैनल की जानकारी वापस पाई जा सके. इस उदाहरण में, Google के आधिकारिक YouTube चैनल की जानकारी पाने के लिए, forUsername पैरामीटर की वैल्यू को Google पर सेट किया गया है.

      https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list?
        part=contentDetails
        &forUsername=Google

    • id पैरामीटर को उस YouTube चैनल आईडी पर सेट करें जो उस चैनल की खास तौर पर पहचान करता है जिसके लिए आपको जानकारी चाहिए. इस उदाहरण में, id पैरामीटर को UCK8sQmJBp8GCxrOtXWBpyEA पर सेट किया गया है. इससे Google के आधिकारिक YouTube चैनल की पहचान भी होती है.

      https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list?
        part=contentDetails
        &id=UCK8sQmJBp8GCxrOtXWBpyEA

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

    अपलोड किए गए वीडियो की सूची पाने के लिए, 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 पर सेट करें. mostPopular चार्ट में, ट्रेंडिंग संगीत, फ़िल्मों, और गेमिंग वीडियो की जानकारी शामिल होती है.

इसके बाद, आपके पास इन पैरामीटर को सेट करने का विकल्प होता है:

  • regionCode: इससे एपीआई को यह निर्देश मिलता है कि वह चुनी गई जगह के लिए, वीडियो की सूची दिखाए. इस पैरामीटर की वैल्यू, ISO 3166-1 alpha-2 फ़ॉर्मैट में देश का कोड होता है. YouTube पर उपलब्ध क्षेत्र के कोड की सूची पाने के लिए, i18nRegions.list तरीके का इस्तेमाल किया जा सकता है.
  • videoCategoryId: इससे वीडियो की उस कैटगरी का पता चलता है जिसके लिए सबसे लोकप्रिय वीडियो वापस पाने हैं. YouTube पर इस्तेमाल की जा सकने वाली कैटगरी आईडी की सूची पाने के लिए, videoCategories.list तरीके का इस्तेमाल किया जा सकता है.

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

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.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 ऑब्जेक्ट भी शामिल है.

    यहां दिए गए अनुरोध में, वीडियो की स्थिति की जांच की जाती है. APIs Explorer में अनुरोध पूरा करने के लिए, आपको 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"
  }
}

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

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

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

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

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

मिलते-जुलते कोड के सैंपल: 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 ऑब्जेक्ट को APIs Explorer में लोड करता है. क्वेरी की जांच करने के लिए, आपको videoId प्रॉपर्टी वैल्यू की जगह कोई मान्य वीडियो आईडी डालना होगा. कृपया ध्यान रखें कि इस अनुरोध को सबमिट करने पर, वीडियो को फ़्लैग कर दिया जाएगा.

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