लागू करना: खोज के अनुरोध

यहां दिए गए उदाहरणों में, v3 API में अलग-अलग तरह के खोज अनुरोधों को पूरा करने का तरीका बताया गया है.

वीडियो

इस उदाहरण में, search.list तरीके का इस्तेमाल करके, "स्केटबोर्डिंग डॉग" क्वेरी से जुड़े सबसे ज़्यादा देखे गए हाई डेफ़िनिशन (एचडी) वीडियो ढूंढे गए हैं. क्वेरी, order, part, q, type, और videoDefinition पैरामीटर सेट करती है.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &order=viewCount
        &q=skateboarding+dog
        &type=video
        &videoDefinition=high

कोड सैंपल के लिए, search.list तरीके का दस्तावेज़ देखें.

प्लेलिस्ट

इस उदाहरण में, क्वेरी के तौर पर इस्तेमाल हुए शब्द "GoogleDevelopers" से मैच होने वाली प्लेलिस्ट ढूंढने का तरीका बताया गया है. यह search.list तरीके को कॉल करता है और type पैरामीटर की वैल्यू को playlist पर सेट करता है, ताकि नतीजे के सेट में सिर्फ़ प्लेलिस्ट शामिल हों.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &q=GoogleDevelopers
        &type=playlist

चैनल

इस उदाहरण में, "यात्रा" क्वेरी से मैच करने वाले चैनलों को ढूंढने का तरीका बताया गया है. यह search.list तरीके को कॉल करता है और type पैरामीटर की वैल्यू को channel पर सेट करता है, ताकि नतीजे के सेट में सिर्फ़ चैनल शामिल हों.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &q=travel
        &type=channel

किसी खास भाषा के हिसाब से नतीजे

इस उदाहरण में, किसी खास भाषा के हिसाब से सबसे काम के खोज नतीजे ढूंढने के लिए, search.list तरीका इस्तेमाल किया गया है. उदाहरण से पता चलता है कि क्वेरी शब्द marine (q=marine) है और एपीआई के जवाब में, फ़्रेंच भाषा (relevanceLanguage=fr) से जुड़े सबसे काम के नतीजे होने चाहिए.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &q=marine
        &relevanceLanguage=fr

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

डेवलपर के ऐप्लिकेशन या वेबसाइट से अपलोड किए गए वीडियो

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

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

अपलोड किए गए हर वीडियो को, Google API Console में डेवलपर के ऐप्लिकेशन से जुड़े प्रोजेक्ट नंबर से अपने-आप टैग कर दिया जाता है.

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

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &q=fun
        &forDeveloper=true