تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Method: users.watch

مراقبة التغييرات في قائمة المستخدمين.

طلب HTTP

POST https://admin.googleapis.com/admin/directory/v1/users/watch

يستخدم عنوان URL بنية gRPC Transcode.

معامِلات طلب البحث

المعلّمات
`domain`	`string` اسم النطاق املأ هذا الحقل لجذب المستخدمين من هذا النطاق فقط. لعرض جميع المستخدمين في حقل ملء عميل متعدد النطاقات بدلاً من ذلك".
`customer`	`string` رقم التعريف غير قابل للتغيير لحساب Google Workspace. في حال تعدد النطاقات، لجلب جميع المستخدمين لأحد العملاء، املأ هذا الحقل بدلاً من النطاق.
`event`	`enum (EventType)` الأحداث التي يجب الانتباه إليها
`customFieldMask`	`string` قائمة أسماء المخططات مفصولة بفواصل. يتم جلب جميع الحقول من هذه المخططات. يجب ألّا يتم ضبط هذه السمة إلا عند العرض على النحو المخصّص.
`maxResults`	`integer` الحد الأقصى لعدد النتائج المطلوب عرضها.
`orderBy`	`enum (OrderBy)` العمود المطلوب استخدامه لترتيب النتائج
`pageToken`	`string` الرمز المميز لتحديد الصفحة التالية في القائمة
`projection`	`enum (Projection)` مجموعة فرعية من الحقول التي يجب استرجاعها لهذا المستخدم.
`query`	`string` البحث في سلسلة طلب البحث يجب أن يكون بالصيغة "". ويمكنك الاطّلاع على المستندات الكاملة على الرابط https: //developers.google.com/admin-sdk/directory/v1/guides/search-users.
`showDeleted`	`string` في حال ضبط هذه السياسة على "صحيح"، يتم استرداد قائمة المستخدمين المحذوفين. (تلقائي: خطأ)
`sortOrder`	`enum (SortOrder)` ما إذا كان سيتم عرض النتائج بترتيب تصاعدي أو تنازلي.
`viewType`	`enum (ViewType)` ما إذا كان سيتم جلب العرض العلني للمستخدم فقط أو للمشرف على مستوى النطاق. ولمزيد من المعلومات، يُرجى الاطّلاع على استرداد مستخدم بصفتك مشرفًا.

نص الطلب

يحتوي نص الطلب على مثال SubscriptionChannel.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال SubscriptionChannel.

نطاقات الأذونات

يتطلب ذلك أحد نطاقات OAuth التالية:

https://www.googleapis.com/auth/admin.directory.user
https://www.googleapis.com/auth/admin.directory.user.readonly
https://www.googleapis.com/auth/cloud-platform

لمزيد من المعلومات، اطّلِع على دليل التفويض.

نوع الحدث

نوع حدث الاشتراك

عمليات التعداد
`ADD`	حدث من إنشاء المستخدم
`DELETE`	حدث حذف المستخدم
`MAKE_ADMIN`	حدث تغيير حالة مشرف المستخدم
`UNDELETE`	حدث إلغاء حذف المستخدم
`UPDATE`	حدث تم تعديله من قِبل المستخدم

ترتيب حسب

عمليات التعداد
`EMAIL`	البريد الإلكتروني الأساسي للمستخدم.
`FAMILY_NAME`	اسم عائلة المستخدم
`GIVEN_NAME`	الاسم المُقدَّم للمستخدم

توقّعات الميزانية

عمليات التعداد
`BASIC`	يجب عدم تضمين أي حقول مخصّصة للمستخدم.
`CUSTOM`	أدرِج الحقول المخصّصة من المخططات المذكورة في customFieldMask.
`FULL`	تضمين جميع الحقول المرتبطة بهذا المستخدم.

SortOrder

عمليات التعداد
`ASCENDING`	ترتيب تصاعدي.
`DESCENDING`	ترتيب تنازلي.

نوع العرض

عمليات التعداد
`admin_view`	تشمل النتائج كلاً من الحقول الخاصة بالمشرف فقط والمجال العام.
`domain_public`	لا تتضمن النتائج سوى حقول المستخدم التي تكون مرئية بشكلٍ علني للمستخدمين الآخرين في النطاق.