Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

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

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

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

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

चैनल पर अपलोड किए गए वीडियो की प्लेलिस्ट का आईडी फिर से पाने के लिए, channels.list तरीके को कॉल करें. अनुरोध के part पैरामीटर वैल्यू में, channel संसाधन के उन हिस्सों में से एक के तौर पर contentDetails शामिल होना चाहिए जिन्हें फिर से पाया जा रहा है. एपीआई के जवाब में, 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
```
- किसी YouTube उपयोगकर्ता नाम से जुड़े चैनल की जानकारी फिर से पाने के लिए, forUsername पैरामीटर को उस उपयोगकर्ता नाम पर सेट करें. इस उदाहरण में, Google के आधिकारिक YouTube चैनल की जानकारी फिर से पाने के लिए, forUsername पैरामीटर की वैल्यू को Google पर सेट किया गया है.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list?
        part=contentDetails
        &forUsername=Google
```
- उस YouTube चैनल के लिए, id पैरामीटर को चैनल आईडी पर सेट करें जिसकी जानकारी आपको फिर से पानी है. यह आईडी, चैनल की यूनीक पहचान करता है. इस उदाहरण में, 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

वीडियो के बैच के आंकड़े फिर से पाना

इस उदाहरण में, videos.batchGetStats तरीके का इस्तेमाल करके, वीडियो की सूची के आंकड़े फिर से पाने का तरीका बताया गया है.

इस तरीके का इस्तेमाल करने के लिए, अनुरोध के id पैरामीटर को, कॉमा से अलग की गई उन YouTube वीडियो आईडी की सूची पर सेट करें जिनके आंकड़े आपको फिर से पाने हैं. part पैरामीटर की वैल्यू को, कॉमा से अलग की गई videoStat संसाधन के उन हिस्सों की सूची पर सेट करें जिन्हें आपको जवाब में शामिल करना है. ये हिस्से काम करते हैं: snippet, statistics, contentDetails, और id.

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

यहां दिए गए अनुरोध से, वीडियो आईडी VIDEO_ID_1 और VIDEO_ID_2 के आंकड़े फिर से पाए जाते हैं:

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.batchGetStats?
        part=snippet,statistics
        &id=VIDEO_ID_1,VIDEO_ID_2

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

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

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

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

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

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

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

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

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

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

कोड के संबंधित सैंपल: PHP, Python

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

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

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

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

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

किसी वीडियो को मिटाने के लिए, videos.delete तरीके को कॉल करें. अनुरोध में, id पैरामीटर में उस वीडियो का आईडी शामिल होता है जिसे मिटाया जा रहा है. OAuth 2.0 का इस्तेमाल करके, अनुरोध को अनुमति मिलनी चाहिए. अगर APIs explorer में इस क्वेरी को टेस्ट किया जा रहा है, तो आपको 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
```