Method: people.searchDirectoryPeople
با مجموعهها، منظم بمانید
ذخیره و دستهبندی محتوا براساس اولویتهای شما.
فهرستی از نمایه های دامنه و مخاطبین دامنه را در فهرست دامنه کاربر تأیید شده ارائه می دهد که با عبارت جستجو مطابقت دارند.
درخواست HTTP
GET https://people.googleapis.com/v1/people:searchDirectoryPeople
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای پرس و جو
مولفه های |
---|
query | string ضروری. پرس و جوی پیشوندی که با فیلدهای شخص مطابقت دارد. از readMask برای تعیین فیلدهای مطابقت استفاده نمی کند. |
readMask | string ( FieldMask format) ضروری. یک فیلد ماسک برای محدود کردن اینکه کدام فیلد برای هر فرد بازگردانده می شود. چندین فیلد را می توان با جدا کردن آنها با کاما مشخص کرد. مقادیر معتبر عبارتند از: - آدرس ها
- محدوده سنی
- بیوگرافی ها
- تولدها
- calendarUrls
- کلاینت دیتا
- عکسهای روی جلد
- آدرس ایمیل
- مناسبت ها
- شناسه های خارجی
- جنسیت ها
- imClients
- منافع
- مناطق
- مکان ها
- عضویت ها
- فراداده
- کلمات کلیدی اشتباه
- نام ها
- نام مستعار
- مشاغل
- سازمان های
- شماره تلفن ها
- عکس ها
- روابط
- آدرس های sip
- مهارت ها
- آدرس های اینترنتی
- تعریف شده توسط کاربر
|
sources[] | enum ( DirectorySourceType ) ضروری. منابع دایرکتوری برای بازگشت. |
mergeSources[] | enum ( DirectoryMergeSourceType ) اختیاری. دادههای اضافی برای ادغام در منابع دایرکتوری اگر از طریق کلیدهای اتصال تأیید شده مانند آدرسهای ایمیل یا شماره تلفن وصل شده باشند. |
pageSize | integer اختیاری. تعداد افرادی که در پاسخ باید لحاظ شود. مقادیر معتبر شامل 1 تا 500 است. در صورت تنظیم نشدن، 100 پیشفرض میشود یا روی 0 تنظیم میشود. |
pageToken | string اختیاری. یک نشانه صفحه، دریافت شده از پاسخ قبلی nextPageToken . این را برای بازیابی صفحه بعدی ارائه کنید. هنگام صفحهبندی، همه پارامترهای دیگر ارائه شده به [ people.searchDirectoryPeople ][google.people.v1.SearchDirectoryPeople] باید با اولین تماسی که کد صفحه را ارائه کرده است مطابقت داشته باشد. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
پاسخ به درخواستی برای افرادی که در فهرست دامنه کاربر احراز هویت شده هستند که با عبارت جستجوی مشخص شده مطابقت دارند.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"people": [
{
object (Person )
}
],
"nextPageToken": string,
"totalSize": integer
} |
زمینه های |
---|
people[] | object ( Person ) لیست افراد موجود در فهرست دامنه که با پرس و جو مطابقت دارند. |
nextPageToken | string یک نشانه، که می تواند به عنوان pageToken برای بازیابی صفحه بعدی ارسال شود. اگر این قسمت حذف شود، هیچ صفحه بعدی وجود ندارد. |
totalSize | integer تعداد کل موارد موجود در لیست بدون صفحه بندی. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/directory.readonly
برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2024-08-06 بهوقت ساعت هماهنگ جهانی.
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"اطلاعاتی که نیاز دارم وجود ندارد"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"بیشازحد پیچیده/ مراحل بسیار زیاد"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"قدیمی"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"مشکل ترجمه"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"مشکل کد / نمونهها"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"غیره"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"درک آسان"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"مشکلم را برطرف کرد"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"غیره"
}]
{"lastModified": "\u062a\u0627\u0631\u06cc\u062e \u0622\u062e\u0631\u06cc\u0646 \u0628\u0647\u200c\u0631\u0648\u0632\u0631\u0633\u0627\u0646\u06cc 2024-08-06 \u0628\u0647\u200c\u0648\u0642\u062a \u0633\u0627\u0639\u062a \u0647\u0645\u0627\u0647\u0646\u06af \u062c\u0647\u0627\u0646\u06cc."}
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2024-08-06 بهوقت ساعت هماهنگ جهانی."]]