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

यहां दिए गए उदाहरणों से पता चलता है कि 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

चैनल

इस उदाहरण में, "travel" क्वेरी से मैच करने वाले चैनल ढूंढने का तरीका बताया गया है. यह 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 पैरामीटर.

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

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

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

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