ব্যবহারকারীদের জন্য অনুসন্ধান করুন

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

মাঠ

ব্যবহারকারীর যে অ্যাট্রিবিউটটি অনুসন্ধান করা হয়। উদাহরণস্বরূপ, givenName ।

অপারেটর

ডেটার সাথে মিল খুঁজে বের করার জন্য যে পরীক্ষা করা হয়। উদাহরণস্বরূপ, : অপারেটরটি পরীক্ষা করে দেখে যে একটি টেক্সট অ্যাট্রিবিউটে কোনো ভ্যালু আছে কি না।

মূল্য

যে অ্যাট্রিবিউটটি পরীক্ষা করা হয় তার বিষয়বস্তু। উদাহরণস্বরূপ, Jane ।

একটি কোয়েরিতে একাধিক ফিল্ড অনুসন্ধান করতে, প্রতিটি সার্চ ক্লজকে একটি স্পেস দিয়ে আলাদা করে যোগ করুন। এই অপারেশনটি একটি অন্তর্নিহিত AND ।

দ্রষ্টব্য: বেশিরভাগ ব্যবহারকারীর ডেটা ১ ঘন্টার মধ্যে আপডেট হয়; তবে, সমস্ত অনুসন্ধানের ফলাফলে নতুন ডেটা প্রতিফলিত হতে ৩৬ ঘন্টা পর্যন্ত সময় লাগতে পারে।

ক্ষেত্র

মাঠ	মান প্রকার	অপারেটররা	বর্ণনা
কোনোটি নির্দিষ্ট করা হয়নি	স্ট্রিং		givenName , familyName বা email এর মানের সাথে তুলনা করুন।
name	স্ট্রিং	=, :	givenName এবং familyName এর সংযুক্ত মান।
email	স্ট্রিং	= , : , :{PREFIX}*	ব্যবহারকারীর ইমেল ঠিকানাগুলো, ছদ্মনাম সহ।
givenName	স্ট্রিং	= , : , :{PREFIX}*	একজন ব্যবহারকারীর প্রদত্ত বা প্রথম নাম।
familyName	স্ট্রিং	= , : , :{PREFIX}*	একজন ব্যবহারকারীর পারিবারিক বা শেষ নাম।
isAdmin	বুলিয়ান	=	কোনো ব্যবহারকারীর সুপার অ্যাডমিনিস্ট্রেটর অধিকার আছে কিনা।
isDelegatedAdmin	বুলিয়ান	=	কোনো ব্যবহারকারীর অর্পিত প্রশাসক বিশেষাধিকার আছে কিনা।
isSuspended	বুলিয়ান	=	ব্যবহারকারীর অ্যাকাউন্ট স্থগিত করা হয়েছে কিনা।
isArchived	বুলিয়ান	=	ব্যবহারকারীর অ্যাকাউন্ট আর্কাইভ করা হয়েছে কিনা।
im	স্ট্রিং	=, :	আইএম নেটওয়ার্ক আইডি।
externalId	স্ট্রিং	=, :	বাহ্যিক আইডি মান।
manager	স্ট্রিং	=	কোনো ব্যবহারকারীর ম্যানেজারের ইমেল ঠিকানা, যা সরাসরি অথবা ঊর্ধ্বতন কর্তৃপক্ষের কাছে থাকতে পারে।
managerId	স্ট্রিং	=	কোনো ব্যবহারকারীর ম্যানেজারের আইডি, যা সরাসরি অথবা ম্যানেজমেন্ট চেইনের ঊর্ধ্বতন পর্যায়ে থাকতে পারে।
directManager	স্ট্রিং	=	একজন ব্যবহারকারীর সরাসরি ব্যবস্থাপকের ইমেইল ঠিকানা।
directManagerId	স্ট্রিং	=	একজন ব্যবহারকারীর সরাসরি ব্যবস্থাপকের আইডি।
address	স্ট্রিং	:	ঠিকানার সমস্ত ক্ষেত্রের সাথে মেলে।
addressPoBox	স্ট্রিং	=, :	একটি পোস্ট অফিস বক্স।
addressExtended	স্ট্রিং	=, :	একটি বর্ধিত ঠিকানা, যেমন একটি উপ-অঞ্চল অন্তর্ভুক্ত ঠিকানা।
addressStreet	স্ট্রিং	=, :	রাস্তার ঠিকানা।
addressLocality	স্ট্রিং	=, :	ঠিকানার কোনো শহর বা নগর।
addressRegion	স্ট্রিং	=, :	একটি সংক্ষিপ্ত প্রদেশ বা রাজ্য।
addressPostalCode	স্ট্রিং	=, :	একটি জিপ বা পোস্টাল কোড।
addressCountry	স্ট্রিং	=, :	একটি দেশ।
orgName	স্ট্রিং	=, :	একটি প্রতিষ্ঠানের নাম।
orgTitle	স্ট্রিং	=, :	প্রতিষ্ঠানে একজন ব্যবহারকারীর পদবি।
orgDepartment	স্ট্রিং	=, :	সংস্থার অভ্যন্তরীণ একটি বিভাগ।
orgDescription	স্ট্রিং	=, :	একটি প্রতিষ্ঠানের বিবরণ।
orgCostCenter	স্ট্রিং	=, :	একটি প্রতিষ্ঠানের ব্যয় কেন্দ্র।
phone	স্ট্রিং	=	একজন ব্যবহারকারীর ফোন নম্বর।
orgUnitPath	স্ট্রিং	=	একটি অর্গ ইউনিটের সম্পূর্ণ পাথ। এটি টার্গেটের অধীনে থাকা সমস্ত অর্গ ইউনিট চেইনকে ম্যাচ করে। উদাহরণস্বরূপ, 'orgUnitPath=/' অর্গানাইজেশনের সমস্ত ইউজারকে রিটার্ন করে। এই ফিল্ডটি শুধুমাত্র তখনই ব্যবহার করা যাবে যখন viewType=admin_view ।
isEnrolledIn2Sv	বুলিয়ান	=	ব্যবহারকারী দ্বি-পদক্ষেপ যাচাইকরণে নথিভুক্ত আছেন কিনা।
isEnforcedIn2Sv	বুলিয়ান	=	ব্যবহারকারীর জন্য দ্বি-পদক্ষেপ যাচাইকরণ কার্যকর করা হয়েছে কিনা।
isGuest	বুলিয়ান	=	ব্যবহারকারী একজন অতিথি ব্যবহারকারী কিনা। যদি তা নির্দিষ্ট করা না থাকে, তাহলে প্রতিক্রিয়ায় অতিথি এবং অ-অতিথি উভয় ব্যবহারকারীই অন্তর্ভুক্ত থাকবে।
schemaName.fieldName	?	?	একটি কাস্টম ইউজার অ্যাট্রিবিউট , যা তার স্কিমা এবং ফিল্ডের নাম দ্বারা নির্দেশিত হয়। ফিল্ডটির indexed ' প্রপার্টির মান অবশ্যই ' true সেট করা থাকতে হবে।

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

মান প্রকার	সমতুল্য স্কিমা ফিল্ডটাইপ	নোট
স্ট্রিং	STRING , EMAIL , PHONE	কোয়েরিতে হোয়াইটস্পেস থাকলে সিঙ্গেল কোট ( ' দিয়ে ঘিরে দিন। কোয়েরিতে সিঙ্গেল কোটকে \' দিয়ে এস্কেপ করুন, যেমন 'Valentine\'s Day' ।
বুলিয়ান	BOOL	এর মান অবশ্যই true বা false হতে হবে। শুধুমাত্র = অপারেটরটি সমর্থন করে।
সংখ্যা	INT64 , DOUBLE	দশমিক বিভাজক হিসেবে অবশ্যই একটি ডট (.) ব্যবহার করতে হবে এবং হাজার বিভাজক ব্যবহার করা যাবে না, যেমন 150430.25 ।
তারিখ	DATE	YYYY-MM-DD ফরম্যাটে নির্দিষ্ট করা, যেমন 2001-02-15 ।

অপারেটররা

অপারেটর	সমর্থিত মান প্রকার	নোট
=	স্ট্রিং, বুলিয়ান, সংখ্যা, তারিখ	ফিল্ড এবং ভ্যালু হুবহু মিলতে হবে। উদাহরণস্বরূপ, givenName=Jane সেইসব ব্যবহারকারীকে ম্যাচ করে যাদের givenName অ্যাট্রিবিউট "Jane" , কিন্তু "Jane Ann" কে নয়। বেশিরভাগ স্ট্রিং ফিল্ডে এটি সমর্থিত ( উপরে দেখুন )।
:	স্ট্রিং	ফিল্ডটিতে ভ্যালুর মধ্যে থাকা সম্পূর্ণ শব্দগুলো ক্রমানুসারে থাকে। উদাহরণস্বরূপ, givenName:Jane ' দিয়ে করা একটি কোয়েরি "Jane" এবং "Jane Ann" givenName ইউজারদের ম্যাচ করবে, কিন্তু "Janet" ভ্যালুযুক্ত ইউজারদের নয়। 'givenName:Mary Ann' দিয়ে করা একটি একাধিক শব্দের কোয়েরি "Mary Ann Evans" এবং "Sarah Mary Ann" ভ্যালুগুলোকে ম্যাচ করবে, কিন্তু "Ann Mary" ভ্যালুটিকে নয়। বেশিরভাগ স্ট্রিং ফিল্ডে এটি সমর্থিত ( উপরে দেখুন )।
:{PREFIX}*	স্ট্রিং	ফিল্ডটি ভ্যালু দিয়ে শুরু হয়। উদাহরণস্বরূপ, givenName:Jane* সহ একটি কোয়েরি সেইসব ইউজারদের ম্যাচ করে যাদের givenName ভ্যালু "Jane" , "Jane Ann" , এবং "Janet" কিন্তু "Sarah Jane" নয়। শুধুমাত্র সীমিত সংখ্যক স্ট্রিং ফিল্ডে সমর্থিত ( উপরে দেখুন )। কাস্টম অ্যাট্রিবিউটে সমর্থিত নয়।
:[{MIN},{MAX}]	নম্বর, তারিখ	ফিল্ডটি একটি সীমার মধ্যে রয়েছে। মিলানোর জন্য, ফিল্ডটির মান অবশ্যই {MIN} এর সমান বা তার চেয়ে বড় এবং {MAX} এর চেয়ে ছোট হতে হবে। এই অপারেটরটি সমর্থন করার জন্য কাস্টম নম্বর অ্যাট্রিবিউটগুলিতে অবশ্যই একটি numericIndexingSpec উল্লেখ করতে হবে।
>	নম্বর, তারিখ	ফিল্ডটি ভ্যালু অপেক্ষা বৃহত্তর। এই অপারেটরটি সমর্থন করার জন্য কাস্টম নাম্বার অ্যাট্রিবিউটে অবশ্যই একটি numericIndexingSpec নির্দিষ্ট করতে হবে।
>=	নম্বর, তারিখ	ফিল্ডটি মানের চেয়ে বড় বা সমান। এই অপারেটরটি সমর্থন করার জন্য কাস্টম নম্বর অ্যাট্রিবিউটে অবশ্যই একটি numericIndexingSpec উল্লেখ করতে হবে।
<	নম্বর, তারিখ	ফিল্ডটি মানের চেয়ে কম। এই অপারেটরটি সমর্থন করার জন্য কাস্টম নম্বর অ্যাট্রিবিউটে অবশ্যই একটি numericIndexingSpec নির্দিষ্ট করতে হবে।
<=	নম্বর, তারিখ	ফিল্ডটি মানের চেয়ে কম বা সমান। এই অপারেটরটি সমর্থন করার জন্য কাস্টম নম্বর অ্যাট্রিবিউটে অবশ্যই একটি numericIndexingSpec উল্লেখ করতে হবে।

দ্রষ্টব্য: মাল্টি-ভ্যালুড ফিল্ডের ক্ষেত্রে রেঞ্জ অপারেটর :[min,max] ব্যবহার করা এবং >=min AND <max কে জয়েন করা এক জিনিস নয়। উদাহরণস্বরূপ, যদি একটি মাল্টি-ভ্যালুড ফিল্ডে 10 এবং 20 এই দুটি মান থাকে, তবে এটি ` field>12 field<15 কোয়েরিটির সাথে মেলে, কারণ প্রতিটি ক্লজের সাথে অন্তত একটি করে মান মেলে। কিন্তু এটি ` field:[12,15] ` কোয়েরিটির সাথে মেলে না, কারণ এই রেঞ্জে কোনো একক মান নেই।

উদাহরণ

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

GET https://admin.googleapis.com/admin/directory/v1/users?domain=DOMAIN_NAME&query=QUERY_PARAMETERS

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

নাম দ্বারা একজন ব্যবহারকারীকে অনুসন্ধান করুন

name কোয়েরি ফিল্ডটি givenName এবং familyName এর সংযুক্ত মানের উপর পরীক্ষা করে। givenName='Jane' এবং familyName='Smith' থাকা কোনো ব্যবহারকারীর জন্য name='Jane' দিয়ে কোয়েরি করলে কোনো ফলাফল আসে না।

name='Jane Smith'

এমন ব্যবহারকারীদের অনুসন্ধান করুন যাদের givenName অথবা familyName কোনো মান রয়েছে।

name:'Jane'

ইমেল প্রিফিক্সের সাথে মেলে এমন ব্যবহারকারীদের অনুসন্ধান করুন

email:admin*

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

isAdmin=true

যেসব ব্যবহারকারীর orgTitles 'Manager' শব্দটি রয়েছে, তাদের অনুসন্ধান করুন।

orgTitle:Manager

এমন ব্যবহারকারীদের সন্ধান করুন যাদের রিপোর্টিং চেইনে একজন সাধারণ ব্যবস্থাপক রয়েছেন।

manager='[e-mail]'

একই সরাসরি ব্যবস্থাপকের অধীনে থাকা ব্যবহারকারীদের অনুসন্ধান করুন

directManager='[e-mail]'

একটি নির্দিষ্ট দেশের ব্যবহারকারীদের অনুসন্ধান করুন

addressCountry='Sweden'

একটি নির্দিষ্ট সংস্থায় ব্যবহারকারীদের অনুসন্ধান করুন

orgName='Human Resources'

একটি নির্দিষ্ট প্রতিষ্ঠানে ব্যবস্থাপকদের সন্ধান করুন

orgName=Engineering orgTitle:Manager

কাস্টম ব্যবহারকারী বৈশিষ্ট্য অনুসন্ধান করুন

দ্রষ্টব্য: নিম্নলিখিত উদাহরণগুলিতে EmploymentData নামের একটি ইউজার স্কিমা ধরে নেওয়া হয়েছে, যেখানে projects , location , এবং jobLevel ফিল্ডগুলো রয়েছে।

একটি নির্দিষ্ট প্রকল্পে কর্মরত সকল কর্মচারীকে খুঁজুন

EmploymentData.projects:'GeneGnomes'

একটি নির্দিষ্ট স্থানের সকল কর্মচারীকে খুঁজুন

EmploymentData.location='Atlanta'

জব লেভেল ৭-এর উপরের সকল কর্মচারীকে খুঁজুন।

EmploymentData.jobLevel>=7

যেসব কর্মচারীর চাকরির স্তর ৫ বা তার বেশি এবং ৮-এর কম, তাদের সবাইকে খুঁজুন।

EmploymentData.jobLevel:[5,8]

যেসব কর্মচারী ২-ধাপ যাচাইকরণে নথিভুক্ত আছেন, তাদের সবাইকে খুঁজুন।

isEnrolledIn2Sv=true

যেসব কর্মচারীর জন্য টু-স্টেপ ভেরিফিকেশন চালু করা হয়েছে, তাদের সবাইকে খুঁজুন।

isEnforcedIn2Sv=true