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
}
اسم الموقع القيمة الوصف Notes
accountIdentifier string معرّف فريد تنشئه لهذا المستخدم، مثل "user342" أو "asset#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).

يجب أن يشتمل مورد Users الذي تم تمريره في نص الطلب على accountIdentifier وaccountType.

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

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

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

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