প্রয়োগ: সার্চ অনুরোধ

v3 API-তে বিভিন্ন ধরনের সার্চ অনুরোধ কীভাবে সম্পূর্ণ করতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে।

ভিডিও

এই উদাহরণে search.list পদ্ধতি কল করে "স্কেটবোর্ডিং ডগ" কোয়েরির সাথে সম্পর্কিত সবচেয়ে বেশি দেখা, হাই-ডেফিনেশন (HD) ভিডিও খোঁজা হয়। কোয়েরি 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 মেথড কল করে। এই উদাহরণে দেখানো হয়েছে যে কোয়েরি করার শব্দ হল সামুদ্রিক (q=marine) এবং API-এর উত্তরে ফরাসি ভাষার (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-এ ভিডিও আপলোড করা যায় না। আপনি API Explorer-এর বাইরে নিজের অ্যাপ্লিকেশনের জন্য এই কোয়েরি চালাতে পারবেন, কিন্তু API Explorer ব্যবহার করে আপনার অ্যাপ্লিকেশনের ফলাফল পাবেন না।

আপলোড করা প্রতিটি ভিডিওতে অটোমেটিক প্রোজেক্ট নম্বর ট্যাগ করা হয় যা Google Cloud কনসোলে ডেভেলপারের অ্যাপ্লিকেশনের সাথে যুক্ত থাকে।

সার্চের অনুরোধ পরবর্তীকালে forDeveloper প্যারামিটারকে সত্য হিসেবে সেট করলে, API পরিষেবা অনুরোধের অনুমোদনের ক্রেডেনশিয়াল ব্যবহার করে ডেভেলপারকে শনাক্ত করে। তাই, কোনও ডেভেলপার তার নিজের অ্যাপ বা ওয়েবসাইটের মাধ্যমে আপলোড করা ভিডিওর ফলাফল সীমাবদ্ধ করতে পারেন, তবে অন্য অ্যাপ বা সাইটের মাধ্যমে আপলোড করা ভিডিওর ফলাফল সীমাবদ্ধ করতে পারেন না।

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