مراقبة التغييرات في قائمة المستخدمين.
طلب HTTP
POST https://admin.googleapis.com/admin/directory/v1/users/watch
يستخدم عنوان URL بنية gRPC Transcode.
معامِلات طلب البحث
المعلّمات | |
---|---|
domain |
اسم النطاق املأ هذا الحقل لجذب المستخدمين من هذا النطاق فقط. لعرض جميع المستخدمين في حقل ملء عميل متعدد النطاقات بدلاً من ذلك". |
customer |
رقم التعريف غير قابل للتغيير لحساب Google Workspace. في حال تعدد النطاقات، لجلب جميع المستخدمين لأحد العملاء، املأ هذا الحقل بدلاً من النطاق. |
event |
الأحداث التي يجب الانتباه إليها |
customFieldMask |
قائمة أسماء المخططات مفصولة بفواصل. يتم جلب جميع الحقول من هذه المخططات. يجب ألّا يتم ضبط هذه السمة إلا عند العرض على النحو المخصّص. |
maxResults |
الحد الأقصى لعدد النتائج المطلوب عرضها. |
orderBy |
العمود المطلوب استخدامه لترتيب النتائج |
pageToken |
الرمز المميز لتحديد الصفحة التالية في القائمة |
projection |
مجموعة فرعية من الحقول التي يجب استرجاعها لهذا المستخدم. |
query |
البحث في سلسلة طلب البحث يجب أن يكون بالصيغة " |
showDeleted |
في حال ضبط هذه السياسة على "صحيح"، يتم استرداد قائمة المستخدمين المحذوفين. (تلقائي: خطأ) |
sortOrder |
ما إذا كان سيتم عرض النتائج بترتيب تصاعدي أو تنازلي. |
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 |
لا تتضمن النتائج سوى حقول المستخدم التي تكون مرئية بشكلٍ علني للمستخدمين الآخرين في النطاق. |