গ্রুপের জন্য অনুসন্ধান করুন

আপনি ডিরেক্টরি এপিআই-এর groups.list মেথড ব্যবহার করে নির্দিষ্ট অ্যাট্রিবিউটের সাথে মেলে এমন গ্রুপ অনুসন্ধান করতে পারেন। এই মেথডটি query প্যারামিটার গ্রহণ করে, যা এক বা একাধিক সার্চ ক্লজ সমন্বিত একটি সার্চ কোয়েরি। প্রতিটি সার্চ ক্লজ তিনটি অংশ নিয়ে গঠিত:

মাঠ
যে অ্যাট্রিবিউটটি অনুসন্ধান করা হয়, সেটিকে গ্রুপ করুন। উদাহরণস্বরূপ, name
অপারেটর
ডেটার সাথে মিল খুঁজে বের করার জন্য যে পরীক্ষা করা হয়। উদাহরণস্বরূপ, ‘ = অপারেটরটি পরীক্ষা করে দেখে যে একটি টেক্সট অ্যাট্রিবিউট কোনো মানের সাথে মেলে কি না
মূল্য
যে অ্যাট্রিবিউটটি পরীক্ষা করা হয় তার বিষয়বস্তু। উদাহরণস্বরূপ, groupName

একাধিক ক্লজ স্পেস দিয়ে আলাদা করা হয় এবং একটি AND অপারেটরের মাধ্যমে পরোক্ষভাবে যুক্ত থাকে।

ক্ষেত্র

মাঠ মান প্রকার অপারেটররা বর্ণনা
email স্ট্রিং = , :{PREFIX}* গ্রুপের ইমেইল ঠিকানা। দ্রষ্টব্য: এটি একই কোয়েরিতে memberKey প্যারামিটারের সাথে ব্যবহার করা যাবে না।
name স্ট্রিং = , :{PREFIX}* গ্রুপের প্রদর্শিত নাম। দ্রষ্টব্য: এটি একই কোয়েরিতে memberKey প্যারামিটারের সাথে ব্যবহার করা যাবে না।
memberKey স্ট্রিং = , memberKey কোয়েরি প্যারামিটারটি সেই সমস্ত গ্রুপ ফেরত দেয়, যেগুলিতে কোনো ব্যবহারকারী বা গ্রুপের সদস্যপদ রয়েছে। এই ভ্যালুটি ব্যবহারকারীর প্রাইমারি বা অ্যালিয়াস ইমেল অ্যাড্রেস, কোনো গ্রুপের প্রাইমারি বা অ্যালিয়াস ইমেল অ্যাড্রেস, অথবা ব্যবহারকারীর ইউনিক আইডি-র যেকোনো একটি হতে পারে। দ্রষ্টব্য: এটি একই কোয়েরিতে email বা name প্যারামিটারের সাথে একত্রে ব্যবহার করা যাবে না।

মানের প্রকারভেদ

মান প্রকার নোট
স্ট্রিং কোয়েরিতে হোয়াইটস্পেস থাকলে সিঙ্গেল কোট ( ' দিয়ে ঘিরে দিন। কোয়েরিতে সিঙ্গেল কোটকে \' দিয়ে এস্কেপ করুন, যেমন 'Valentine\'s Day'

অপারেটররা

অপারেটর সমর্থিত মান প্রকার নোট
= স্ট্রিং, বুলিয়ান, সংখ্যা, তারিখ ফিল্ড এবং ভ্যালু হুবহু মিলতে হবে। উদাহরণস্বরূপ, name=contact সেইসব গ্রুপের সাথে মেলে যাদের name অ্যাট্রিবিউট "contact" , কিন্তু "contactgroup" সাথে মেলে না। বেশিরভাগ স্ট্রিং ফিল্ডে এটি সমর্থিত ( উপরে দেখুন )।
:{PREFIX}* স্ট্রিং ফিল্ডটি ভ্যালু দিয়ে শুরু হয়। উদাহরণস্বরূপ, email:support* সহ একটি কোয়েরি "supportgroup@" এবং "support@" email ভ্যালু সহ গ্রুপগুলিকে ম্যাচ করে, কিন্তু "contactsupport" গ্রুপগুলিকে নয়। এটি শুধুমাত্র সীমিত সংখ্যক স্ট্রিং ফিল্ডে সমর্থিত ( উপরে দেখুন )।

উদাহরণ

সমস্ত কোয়েরিতে groups.list মেথডটি ব্যবহৃত হয়, যার HTTP রিকোয়েস্টটি নিচেরটির অনুরূপ (পঠনযোগ্যতার জন্য লাইন ব্রেক অন্তর্ভুক্ত করা হয়েছে):

GET https://admin.googleapis.com/admin/directory/v1/groups
?domain=primary domain
&query=query parameters

query প্যারামিটারগুলো অবশ্যই ইউআরএল এনকোড করা থাকতে হবে। উদাহরণস্বরূপ, ` query=email:support* ` কোয়েরিটি ইউআরএল এনকোড হয়ে ` query=email%3Asupport* হয়। এই পৃষ্ঠার সমস্ত উদাহরণে এনকোড না করা query প্যারামিটার দেখানো হয়েছে। ক্লায়েন্ট লাইব্রেরিগুলো এই ইউআরএল এনকোডিং স্বয়ংক্রিয়ভাবে পরিচালনা করে।

ডিসপ্লে নাম দ্বারা একটি গ্রুপ অনুসন্ধান করুন

name='contact'

ইমেল প্রিফিক্সের সাথে মেলে এমন গ্রুপগুলি অনুসন্ধান করুন

email:admin*

একজন ব্যবহারকারীর সমস্ত গ্রুপ অনুসন্ধান করুন

memberKey=user@company.com

'contact' দিয়ে শুরু হওয়া নাম ও ইমেল ব্যবহার করে গ্রুপগুলি অনুসন্ধান করুন।

name:contact* email:contact*