تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
للحصول على قائمة من الطرق لهذا المورد، راجِع نهاية هذه الصفحة.
تمثيلات الموارد
يمثل مورد "المستخدمون" حسابًا مرتبطًا بمؤسسة. قد يكون الحساب خاصًا بجهاز أو لمستخدم فردي (يمكنه بعد ذلك استخدام الحساب على أجهزة متعددة). وقد يوفّر الحساب إمكانية الوصول إلى "Google Play للأعمال" فقط أو إلى خدمات Google الأخرى، وذلك استنادًا إلى نموذج الهوية:
يتطلب نموذج هوية النطاق المُدار من Google المزامنة مع مصادر حساب Google (عبر primaryEmail).
يوفّر نموذج هوية "حسابات Google Play للأعمال" وسيلة ديناميكية للمؤسسات لإنشاء حسابات مستخدمين أو أجهزة حسب الحاجة. توفّر هذه الحسابات إمكانية الوصول إلى "Google Play للأعمال".
معرّف فريد تنشئه لهذا المستخدم، مثل "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) على الجهاز.
الرمز المميّز الذي تم إنشاؤه للاستخدام مرة واحدة وتنتهي صلاحيته بعد بضع دقائق.
يمكنك إدارة الأجهزة لما يصل إلى 10 أجهزة لكل مستخدم.
لا تعمل هذه المكالمة إلا مع الحسابات المُدارة من خلال إدارة الخدمات الجوّالة للمؤسسات (EMM).
البحث عن مستخدم باستخدام عنوان البريد الإلكتروني الرئيسي
ولا تتوفّر هذه الميزة إلا للمستخدمين الخاضعين لإدارة Google. البحث عن رقم التعريف غير متاح
بالنسبة إلى المستخدمين الذين تديرهم إدارة الخدمات الجوّالة للمؤسسات (EMM)، نظرًا لأنه قد تم إرجاع رقم التعريف بالفعل في
نتيجة اتصال users.insert.
يلغي هذا الإجراء إمكانية الوصول إلى جميع الأجهزة المُدارة حاليًا للمستخدم. المستخدِم
لن يتمكن بعد الآن من استخدام متجر Play المُدار على أي من
الأجهزة المُدارة.
لا تعمل هذه المكالمة إلا مع الحسابات المُدارة من خلال إدارة الخدمات الجوّالة للمؤسسات (EMM).
تُعدّل مجموعة المنتجات التي يحق للمستخدم الوصول إليها (المشار إليها
كمنتجات مُضافة إلى القائمة البيضاء). فقط المنتجات التي
موافَق عليه
أو المنتجات التي تمت الموافقة عليها سابقًا (المنتجات التي تم إبطال الموافقة عليها)
يمكنك إضافته إلى القائمة البيضاء.
يعدّل تفاصيل المستخدم المُدار من خلال إدارة الخدمات الجوّالة للمؤسسات (EMM).
يمكن استخدام الحساب مع الحسابات المُدارة من خلال إدارة الخدمات الجوّالة للمؤسسات (EMM) فقط (وليس حسابات المستخدمين المُدارة من Google).
نمرر التفاصيل الجديدة في
المستخدِمون
المورد في نص الطلب. الحقل displayName فقط
يمكن تغييرها. ويجب إلغاء ضبط الحقول الأخرى أو أن تحتوي على
القيمة النشطة حاليًا.
تاريخ التعديل الأخير: 2024-08-19 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-08-19 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eA Users resource represents an enterprise account that can be device- or individual-specific, granting access to managed Google Play and potentially other Google services based on the chosen identity model.\u003c/p\u003e\n"],["\u003cp\u003eTwo identity models are available: Google-managed domain identity (requiring synchronization with Google accounts) and managed Google Play Accounts (allowing dynamic creation of user/device accounts for Play access).\u003c/p\u003e\n"],["\u003cp\u003eEMM-managed users have unique identifiers and account types, while Google-managed users rely on primary email addresses for identification.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can manage users using various methods like creating, deleting, retrieving details, and controlling device access, with options varying based on management type.\u003c/p\u003e\n"],["\u003cp\u003eSome methods, like \u003ccode\u003egetAvailableProductSet\u003c/code\u003e and \u003ccode\u003esetAvailableProductSet\u003c/code\u003e, are deprecated and will be inaccessible after September 30, 2025, with alternative recommendations available.\u003c/p\u003e\n"]]],[],null,["# Users\n\n\u003cbr /\u003e\n\nFor a list of [methods](#methods) for this resource, see the end of this page.\n\nResource representations\n------------------------\n\nA Users resource represents an account associated with an enterprise. The account may be specific to a device or to an individual user (who can then use the account across multiple devices). The account may provide access to managed Google Play only, or to other Google services, depending on the identity model:\n\n- The Google managed domain identity model requires synchronization to Google account sources (via `primaryEmail`).\n- The managed Google Play Accounts identity model provides a dynamic means for enterprises to create user or device accounts as needed. These accounts provide access to managed Google Play.\n\n\u003cbr /\u003e\n\n```text\n{\n \"kind\": \"androidenterprise#user\",\n \"id\": string,\n \"managementType\": string,\n \"accountType\": string,\n \"primaryEmail\": string,\n \"accountIdentifier\": string,\n \"displayName\": string\n}\n```\n\n| Property name | Value | Description | Notes |\n|---------------------|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------|\n| `accountIdentifier` | `string` | A unique identifier you create for this user, such as \"user342\" or \"asset#44418\". Do not use personally identifiable information (PII) for this property. Must always be set for EMM-managed users. Not set for Google-managed users. | |\n| `accountType` | `string` | The type of account that this user represents. A `userAccount` can be installed on multiple devices, but a `deviceAccount` is specific to a single device. An EMM-managed user (`emmManaged`) can be either type (`userAccount`, `deviceAccount`), but a Google-managed user (`googleManaged`) is always a `userAccount`. \u003cbr /\u003e Acceptable values are: - \"`deviceAccount`\" - \"`userAccount`\" | |\n| `displayName` | `string` | The name that will appear in user interfaces. Setting this property is optional when creating EMM-managed users. If you do set this property, use something generic about the organization (such as \"Example, Inc.\") or your name (as EMM). Not used for Google-managed user accounts. | writable |\n| `id` | `string` | The unique ID for the user. | |\n| `kind` | `string` | | |\n| `managementType` | `string` | The entity that manages the user. With `googleManaged` users, the source of truth is Google so EMMs have to make sure a Google Account exists for the user. With `emmManaged` users, the EMM is in charge. \u003cbr /\u003e Acceptable values are: - \"`emmManaged`\" - \"`googleManaged`\" | |\n| `primaryEmail` | `string` | The user's primary email address, for example, \"jsmith@example.com\". Will always be set for Google managed users and not set for EMM managed users. | |\n\nMethods\n-------\n\n[delete](/android/work/play/emm-api/v1/users/delete)\n: Deleted an EMM-managed user.\n\n[generateAuthenticationToken](/android/work/play/emm-api/v1/users/generateAuthenticationToken)\n: Generates an authentication token which the device policy client can use to\n provision the given EMM-managed user account on a device.\n The generated token is single-use and expires after a few minutes.\n\n \u003cbr /\u003e\n\n\n You can provision a maximum of 10 devices per user.\n\n \u003cbr /\u003e\n\n\n This call only works with EMM-managed accounts.\n\n[get](/android/work/play/emm-api/v1/users/get)\n: Retrieves a user's details.\n\n[getAvailableProductSet](/android/work/play/emm-api/v1/users/getAvailableProductSet)\n:\n | **Deprecated:** New integrations cannot use this method and can refer to our [new\n | recommendations](/android/work/deprecations#recommended_alternative_2). \n | **This method will no longer be accessible by\n | anyone after September 30, 2025.**\n\n Retrieves the set of products a user is entitled to access.\n\n[insert](/android/work/play/emm-api/v1/users/insert)\n: Creates a new EMM-managed user.\n\n \u003cbr /\u003e\n\n\n The [Users](/android/work/play/emm-api/v1/users) resource\n passed in the body of the request should include an\n `accountIdentifier` and an `accountType`.\n\n If a corresponding user already exists with the same account identifier,\n the user will be updated with the resource. In this case only the\n `displayName` field can be changed.\n\n[list](/android/work/play/emm-api/v1/users/list)\n: Looks up a user by primary email address.\n This is only supported for Google-managed users. Lookup of the id is not\n needed for EMM-managed users because the id is already returned in the\n result of the Users.insert call.\n\n[revokeDeviceAccess](/android/work/play/emm-api/v1/users/revokeDeviceAccess)\n: Revokes access to all devices currently provisioned to the user. The user\n will no longer be able to use the managed Play store on any of their\n managed devices.\n\n \u003cbr /\u003e\n\n\n This call only works with EMM-managed accounts.\n\n[setAvailableProductSet](/android/work/play/emm-api/v1/users/setAvailableProductSet)\n:\n | **Deprecated:** New integrations cannot use this method and can refer to our [new\n | recommendations](/android/work/deprecations#recommended_alternative_2). \n | **This method will no longer be accessible by\n | anyone after September 30, 2025.**\n\n Modifies the set of products that a user is entitled to access (referred to\n as *whitelisted* products). Only products that are\n [approved](/android/work/play/emm-api/v1/products/approve)\n or products that were previously approved (products with revoked approval)\n can be whitelisted.\n\n[update](/android/work/play/emm-api/v1/users/update)\n: Updates the details of an EMM-managed user.\n\n \u003cbr /\u003e\n\n\n Can be used with EMM-managed users only (not Google managed users).\n Pass the new details in the\n [Users](/android/work/play/emm-api/v1/users)\n resource in the request body. Only the `displayName` field\n can be changed. Other fields must either be unset or have the\n currently active value."]]
