ملاحظة مهمة: لم نعد نقبل عمليات التسجيل الجديدة لواجهة برمجة تطبيقات Play لخدمة إدارة الأجهزة الجوّالة للمؤسسات (EMM). مزيد من المعلومات

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

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" أو "asset#44418" لا تستخدم معلومات تحديد الهوية الشخصية (PII) لهذا الموقع. يجب الضبط دائمًا للمستخدمين الخاضعين لإدارة الخدمات الجوّالة للمؤسسات (EMM). لم يتم الضبط للمستخدمين الخاضعين لإدارة Google.
`accountType`	`string`	نوع الحساب الذي يمثله هذا المستخدم. يمكن تثبيت `userAccount` على عدة أجهزة، ولكن يمكن استخدام `deviceAccount` على جهاز واحد. يمكن أن يكون المستخدم الذي يدير خدمة إدارة الأجهزة الجوّالة للمؤسسات (EMM) (`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) لأن المعرّف يظهر من قبل في نتيجة استدعاء المستخدمين.insert.insert.
revokeDeviceAccess: يبطل حق الوصول إلى جميع الأجهزة المُدارة حاليًا للمستخدم. ولن يتمكن المستخدم بعد ذلك من استخدام متجر Play المُدار على أي من أجهزته المُدارة.

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

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