नीचे दिए गए उदाहरण, 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
तरीके का दस्तावेज़ देखें.
प्लेलिस्ट
इस उदाहरण में, क्वेरी शब्द "Googleडेवलपर" से मिलती-जुलती प्लेलिस्ट को ढूंढने का तरीका बताया गया है. यह 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
के तरीके का इस्तेमाल करके, खोज के ऐसे नतीजे खोजे जाते हैं जो किसी खास भाषा के लिए सबसे ज़्यादा काम के हैं. इस उदाहरण में दिखाया गया है कि क्वेरी में इस्तेमाल किया गया शब्द marin (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
पैरामीटर जैसे वैकल्पिक खोज पैरामीटर के साथ किया जा सकता है.
ध्यान दें: यह क्वेरी, असल में एपीआई एक्सप्लोरर में नतीजे नहीं दिखाती. ऐसा इसलिए, क्योंकि एपीआई एक्सप्लोरर में वीडियो अपलोड करने की सुविधा नहीं है. आप अपने स्वयं के ऐप्लिकेशन के लिए API एक्सप्लोरर के बाहर यह क्वेरी चला सकते हैं, लेकिन आप API एक्सप्लोरर का उपयोग करके अपने ऐप्लिकेशन के लिए परिणाम नहीं पा सकते.
अपलोड किए गए हर वीडियो को उस प्रोजेक्ट नंबर से अपने-आप टैग कर दिया जाता है जो Google API (एपीआई) कंसोल में डेवलपर के ऐप्लिकेशन से जुड़ा होता है.
जब खोज का अनुरोध बाद में forDeveloper
पैरामीटर को 'सही' पर सेट करता है, तब डेवलपर सेवा की पहचान करने के लिए एपीआई सेवा, अनुरोध के लिए अनुमति देने वाले क्रेडेंशियल का इस्तेमाल करती है. इसलिए, डेवलपर सिर्फ़ अपने ऐप्लिकेशन या वेबसाइट से अपलोड किए गए वीडियो के नतीजे दिखा सकता है. हालांकि, किसी दूसरे ऐप्लिकेशन या साइट पर अपलोड किए गए वीडियो के नतीजे नहीं दिखाए जा सकते.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=fun &forDeveloper=true