এই ডকুমেন্টটি ব্যাখ্যা করে যে কীভাবে Gmail API ব্যবহার করে বার্তাগুলি অনুসন্ধান এবং খুঁজে বের করতে হয়।
আপনি messages.list এবং threads.list পদ্ধতি ব্যবহার করে ফাইল অনুসন্ধান বা ফিল্টার করতে পারেন। এই পদ্ধতিগুলি q কোয়েরি প্যারামিটার গ্রহণ করে, যা Gmail ওয়েব ইন্টারফেসের মতো একই উন্নত অনুসন্ধান সিনট্যাক্সের বেশিরভাগই সমর্থন করে। Gmail UI এবং Gmail API এর মধ্যে অনুসন্ধান এবং ফিল্টার পার্থক্যের তালিকার জন্য, Gmail UI থেকে পার্থক্য দেখুন।
এই উন্নত অনুসন্ধান বাক্য গঠন আপনাকে প্রেরক, তারিখ বা লেবেলের মতো বৈশিষ্ট্য অনুসারে বার্তা ফিল্টার করার জন্য কোয়েরি ব্যবহার করতে দেয়। উদাহরণস্বরূপ, নিম্নলিখিত messages.list পদ্ধতি কোয়েরিটি জানুয়ারী ২০১৪ সালে ব্যবহারকারীর দ্বারা প্রেরিত সমস্ত বার্তা পুনরুদ্ধার করে:
GET https://www.googleapis.com/gmail/v1/users/me/messages?q=in:sent after:2014/01/01 before:2014/02/01
অনুসন্ধান কোয়েরি ছাড়াও, আপনি labelIds[] প্যারামিটার ব্যবহার করে লেবেল অনুসারে বার্তা এবং থ্রেড ফিল্টার করতে পারেন। এটি আপনাকে নির্দিষ্ট সিস্টেম বা ব্যবহারকারী লেবেল প্রয়োগ করে বার্তা এবং থ্রেড অনুসন্ধান করতে দেয়। আরও তথ্যের জন্য, messages.list এবং threads.list পদ্ধতিগুলি দেখুন। লেবেল সম্পর্কে আরও তথ্যের জন্য, লেবেল পরিচালনা করুন দেখুন।
জিমেইল ইউআই থেকে পার্থক্য
যদিও জিমেইল এপিআই জিমেইল ইউআইতে ব্যবহৃত বেশিরভাগ অ্যাডভান্সড সার্চ সিনট্যাক্স সমর্থন করে, তবে কিছু পার্থক্য রয়েছে:
Gmail UI alias expansion সঞ্চালন করে, যা এটিকে একটি Google Workspace অ্যাকাউন্ট থেকে একটি অ্যাকাউন্ট উপনাম অনুমান করতে দেয়। উদাহরণস্বরূপ, ধরুন আপনার
myprimary@cymbalgroup.comঅ্যাকাউন্ট আছে এবং আপনার প্রশাসকmyalias@cymbalgroup.comঅ্যাকাউন্টের জন্য একটি উপনাম সেট আপ করেন। যদিmyalias@cymbalgroup.comএকটি ইমেল পাঠায়, কিন্তু আপনি "from: myprimary@cymbalgroup.com" অনুসন্ধান করেন, তাহলেmyalias@cymbalgroup.comদ্বারা প্রেরিত ইমেলটি Gmail UI-তে অনুসন্ধান ফলাফলে প্রদর্শিত হবে, কিন্তু API প্রতিক্রিয়ায় নয়।জিমেইল ইউআই ব্যবহারকারীদের থ্রেড-ওয়াইড অনুসন্ধান করার অনুমতি দেয়, কিন্তু এপিআই তা করে না।