Users

للحصول على قائمة من الطرق لهذا المورد، راجِع نهاية هذه الصفحة.

تمثيلات الموارد

يمثل مورد "المستخدمون" حسابًا مرتبطًا بمؤسسة. قد يكون الحساب خاصًا بجهاز أو لمستخدم فردي (يمكنه بعد ذلك استخدام الحساب على أجهزة متعددة). وقد يوفّر الحساب إمكانية الوصول إلى "Google Play للأعمال" فقط أو إلى خدمات Google الأخرى، وذلك استنادًا إلى نموذج الهوية:

  • يتطلب نموذج هوية النطاق المُدار من Google المزامنة مع مصادر حساب Google (عبر primaryEmail).
  • يوفّر نموذج هوية "حسابات Google Play للأعمال" وسيلة ديناميكية للمؤسسات لإنشاء حسابات مستخدمين أو أجهزة حسب الحاجة. توفّر هذه الحسابات إمكانية الوصول إلى "Google Play للأعمال".

{
  "kind": "androidenterprise#user",
  "id": string,
  "managementType": string,
  "accountType": string,
  "primaryEmail": string,
  "accountIdentifier": string,
  "displayName": string
}
اسم الموقع القيمة الوصف ملاحظات
accountIdentifier string معرّف فريد تنشئه لهذا المستخدم، مثل "user342" أو "مادة العرض رقم 44418" لا تستخدِم معلومات تحديد الهوية الشخصية لهذا الموقع. يجب ضبطها دائمًا للمستخدمين المُدارين من خلال إدارة الخدمات الجوّالة للمؤسسات (EMM). لم يتم ضبطه للمستخدمين الخاضعين لإدارة Google.
accountType string نوع الحساب الذي يمثله هذا المستخدم. يمكن تثبيت userAccount على أجهزة متعددة، ولكن deviceAccount خاص بجهاز واحد. يمكن أن يكون المستخدم المُدار من خلال إدارة الخدمات الجوّالة للمؤسسات (emmManaged) أيًا من النوعين (userAccount، deviceAccount)، ولكن المستخدم الذي تديره Google (googleManaged) دائمًا ما يكون userAccount.

في ما يلي القيم المقبولة:
  • "deviceAccount"
  • "userAccount"
displayName string الاسم الذي سيظهر في واجهات المستخدم يكون إعداد هذا الموقع اختياريًا عند إنشاء حسابات مستخدمين مُدارة من خلال إدارة الخدمات الجوّالة للمؤسسات (EMM). في حال إعداد هذه السمة، استخدِم اسمًا عامًا عن المؤسسة (مثل "Example, Inc. ") أو اسمك (مثل EMM). ولا تُستخدم لحسابات المستخدمين التي تديرها Google. قابل للكتابة
id string المعرّف الفريد للمستخدِم.

kind string
managementType string الكيان الذي يدير المستخدم. بالنسبة إلى مستخدمي "googleManaged"، يكون مصدر الحقيقة هو Google، لذا على إدارة الخدمات الجوّالة للمؤسسات (EMM) التأكّد من توفّر حساب Google للمستخدم. مع مستخدم واحد (emmManaged)، تكون إدارة الخدمات الجوّالة للمؤسسات (EMM) هي المسؤولة.

في ما يلي القيم المقبولة:
  • "emmManaged"
  • "googleManaged"
primaryEmail string عنوان البريد الإلكتروني الرئيسي للمستخدم، على سبيل المثال، "jsmith@example.com". سيتم ضبطها دائمًا للمستخدمين الخاضعين لإدارة Google، ولن يتم ضبطها للمستخدمين المُدارين في إدارة الخدمات الجوّالة للمؤسسات (EMM).

الطُرق

حذف
تم حذف مستخدم تديره إدارة الخدمات الجوّالة للمؤسسات (EMM).
generateAuthenticationToken
إنشاء رمز مصادقة مميز يمكن لبرنامج سياسة الجهاز استخدامه من أجل إدارة الحساب المحدّد للمستخدم المُدار من خلال إدارة الخدمات الجوّالة للمؤسسات (EMM) على الجهاز. الرمز المميّز الذي تم إنشاؤه للاستخدام مرة واحدة وتنتهي صلاحيته بعد بضع دقائق.

يمكنك إدارة الأجهزة لما يصل إلى 10 أجهزة لكل مستخدم.

لا تعمل هذه المكالمة إلا مع الحسابات المُدارة من خلال إدارة الخدمات الجوّالة للمؤسسات (EMM).
الحصول على
استرداد تفاصيل المستخدم
getAvailableProductSet
استرداد مجموعة المنتجات التي يحق للمستخدم الوصول إليها.
إدراج
إنشاء حساب مستخدم جديد مُدار لإدارة الخدمات الجوّالة للمؤسسات (EMM).

مورد المستخدمون التي يتم تمريرها في نص الطلب accountIdentifier وaccountType.

في حال وجود مستخدم مطابق بمعرّف الحساب نفسه، فسيتم تحديث المستخدم بالمورد. في هذه الحالة، تكون يمكن تغيير الحقل "displayName".

list
البحث عن مستخدم باستخدام عنوان البريد الإلكتروني الرئيسي ولا تتوفّر هذه الميزة إلا للمستخدمين الخاضعين لإدارة Google. البحث عن رقم التعريف غير متاح بالنسبة إلى المستخدمين الذين تديرهم إدارة الخدمات الجوّالة للمؤسسات (EMM)، نظرًا لأنه قد تم إرجاع رقم التعريف بالفعل في نتيجة اتصال users.insert.
revokeDeviceAccess
يلغي هذا الإجراء إمكانية الوصول إلى جميع الأجهزة المُدارة حاليًا للمستخدم. المستخدِم لن يتمكن بعد الآن من استخدام متجر Play المُدار على أي من الأجهزة المُدارة.

لا تعمل هذه المكالمة إلا مع الحسابات المُدارة من خلال إدارة الخدمات الجوّالة للمؤسسات (EMM).
setAvailableProductSet
تُعدّل مجموعة المنتجات التي يحق للمستخدم الوصول إليها (المشار إليها كمنتجات مُضافة إلى القائمة البيضاء). فقط المنتجات التي موافَق عليه أو المنتجات التي تمت الموافقة عليها سابقًا (المنتجات التي تم إبطال الموافقة عليها) يمكنك إضافته إلى القائمة البيضاء.
تعديل
يعدّل تفاصيل المستخدم المُدار من خلال إدارة الخدمات الجوّالة للمؤسسات (EMM).

يمكن استخدام الحساب مع الحسابات المُدارة من خلال إدارة الخدمات الجوّالة للمؤسسات (EMM) فقط (وليس حسابات المستخدمين المُدارة من Google). نمرر التفاصيل الجديدة في المستخدِمون المورد في نص الطلب. الحقل displayName فقط يمكن تغييرها. ويجب إلغاء ضبط الحقول الأخرى أو أن تحتوي على القيمة النشطة حاليًا.