আপনি ডিরেক্টরি API-এর groups.list
পদ্ধতির সাথে নির্দিষ্ট বৈশিষ্ট্যের সাথে মিলে যাওয়া গোষ্ঠীগুলি অনুসন্ধান করতে পারেন। এই পদ্ধতিটি query
প্যারামিটার গ্রহণ করে যা এক বা একাধিক অনুসন্ধান ধারার সমন্বয়ে একটি অনুসন্ধান ক্যোয়ারী। প্রতিটি অনুসন্ধান ধারা তিনটি অংশ নিয়ে গঠিত:
- মাঠ
- গ্রুপ অ্যাট্রিবিউট যে অনুসন্ধান করা হয়. উদাহরণস্বরূপ,
name
। - অপারেটর
- একটি ম্যাচ প্রদান করার জন্য ডেটাতে সঞ্চালিত হয় এমন পরীক্ষা। উদাহরণস্বরূপ,
=
অপারেটর পরীক্ষা করে যদি একটি পাঠ্য বৈশিষ্ট্য একটি মানের সাথে মেলে । - মান
- অ্যাট্রিবিউটের বিষয়বস্তু যা পরীক্ষা করা হয়। উদাহরণস্বরূপ,
groupName
।
একাধিক ধারা হোয়াইটস্পেস দ্বারা পৃথক করা হয় এবং একটি AND
অপারেটর দ্বারা নিহিতভাবে যোগদান করা হয়।
ক্ষেত্র
মাঠ | মান প্রকার | অপারেটর | বর্ণনা |
---|---|---|---|
email | স্ট্রিং | = , :{PREFIX}* | গ্রুপের ইমেল ঠিকানা। দ্রষ্টব্য: এটি একই ক্যোয়ারীতে memberKey প্যারামিটারের সাথে ব্যবহার করা যাবে না। |
name | স্ট্রিং | = , :{PREFIX}* | গ্রুপের প্রদর্শনের নাম। দ্রষ্টব্য: এটি একই ক্যোয়ারীতে memberKey প্যারামিটারের সাথে ব্যবহার করা যাবে না। |
memberKey | স্ট্রিং | = , | memberKey ক্যোয়ারী প্যারামিটারটি সেই সমস্ত গোষ্ঠী ফেরত দেয় যার জন্য একটি ব্যবহারকারী বা গোষ্ঠীর সদস্যপদ রয়েছে। এই মানটি ব্যবহারকারীর প্রাথমিক বা উপনাম ইমেল ঠিকানা, একটি গোষ্ঠীর প্রাথমিক বা উপনাম ইমেল ঠিকানা বা ব্যবহারকারীর অনন্য আইডি হতে পারে। দ্রষ্টব্য: এটি একই ক্যোয়ারীতে email বা name প্যারামিটারের সাথে ব্যবহার করা যাবে না। |
মান প্রকার
মান প্রকার | নোট |
---|---|
স্ট্রিং | ক্যোয়ারীতে হোয়াইটস্পেস থাকলে একক উদ্ধৃতি দিয়ে ঘিরে দিন ' \' দিয়ে প্রশ্নে একক উদ্ধৃতি এস্কেপ করুন, উদাহরণস্বরূপ 'Valentine\'s Day' । |
অপারেটর
অপারেটর | সমর্থিত মান প্রকার | নোট |
---|---|---|
= | স্ট্রিং, বুলিয়ান, সংখ্যা, তারিখ | মাঠ ও মান হুবহু মিলে যায়। উদাহরণস্বরূপ, name=contact "contact" name বৈশিষ্ট্যের সাথে সমস্ত গ্রুপের সাথে মেলে, কিন্তু "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
প্যারামিটার অবশ্যই URL এনকোডেড হতে হবে। উদাহরণস্বরূপ, query query=email:support*
হল query=email%3Asupport*
হিসাবে এনকোড করা URL। এই পৃষ্ঠার সমস্ত উদাহরণ আনকোডেড query
প্যারামিটার দেখায়৷ ক্লায়েন্ট লাইব্রেরি স্বয়ংক্রিয়ভাবে এই URL এনকোডিং পরিচালনা করে।
প্রদর্শন নাম দ্বারা একটি গ্রুপ জন্য অনুসন্ধান করুন
name='contact'
একটি ইমেল উপসর্গের সাথে মিলে যাওয়া গোষ্ঠীগুলির জন্য অনুসন্ধান করুন৷
email:admin*
একটি ব্যবহারকারীর সমস্ত গ্রুপের জন্য অনুসন্ধান করুন
memberKey=user@company.com
পরিচিতি থেকে শুরু করে নাম এবং ইমেল সহ গোষ্ঠীগুলির জন্য অনুসন্ধান করুন৷
name:contact* email:contact*