با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
برای لیست روش های این منبع، انتهای این صفحه را ببینید.
بازنمایی منابع
یک منبع Users یک حساب مرتبط با یک شرکت را نشان می دهد. این حساب ممکن است مختص یک دستگاه یا یک کاربر خاص باشد (که می تواند از حساب در چندین دستگاه استفاده کند). حساب ممکن است بسته به مدل هویت، فقط به Google Play مدیریت شده یا سایر خدمات Google دسترسی داشته باشد:
مدل هویت دامنه مدیریت‌شده Google به همگام‌سازی با منابع حساب Google (از طریق primaryEmail ) نیاز دارد.
مدل هویت حساب‌های مدیریت‌شده Google Play ابزاری پویا برای شرکت‌ها فراهم می‌کند تا در صورت نیاز حساب‌های کاربر یا دستگاه ایجاد کنند. این حساب‌ها دسترسی به Google Play مدیریت شده را فراهم می‌کنند.
یک شناسه منحصربه‌فرد که برای این کاربر ایجاد می‌کنید، مانند "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 ، منبع حقیقت گوگل است، بنابراین EMMs باید مطمئن شوند که یک حساب Google برای کاربر وجود دارد. با کاربران emmManaged ، EMM مسئول است.
مقادیر قابل قبول عبارتند از:
" emmManaged "
" googleManaged "
primaryEmail
string
آدرس ایمیل اصلی کاربر، به عنوان مثال، "jsmith@example.com". همیشه برای کاربران مدیریت شده Google تنظیم می شود و برای کاربران مدیریت شده EMM تنظیم نمی شود.
یک رمز احراز هویت ایجاد می کند که سرویس گیرنده خط مشی دستگاه می تواند از آن برای ارائه حساب کاربری داده شده تحت مدیریت EMM در دستگاه استفاده کند. توکن تولید شده یکبار مصرف است و پس از چند دقیقه منقضی می شود.
شما می توانید حداکثر 10 دستگاه برای هر کاربر تهیه کنید.
این تماس فقط با حساب های مدیریت شده توسط EMM کار می کند.
کاربر را با آدرس ایمیل اصلی جستجو می کند. این فقط برای کاربران تحت مدیریت گوگل پشتیبانی می شود. جستجوی شناسه برای کاربران تحت مدیریت EMM لازم نیست زیرا شناسه قبلاً در نتیجه تماس Users.insert برگردانده شده است.
دسترسی به تمام دستگاه‌هایی که در حال حاضر در اختیار کاربر قرار داده شده را لغو می‌کند. کاربر دیگر نمی تواند از فروشگاه Play مدیریت شده در هیچ یک از دستگاه های مدیریت شده خود استفاده کند.
این تماس فقط با حساب‌های مدیریت‌شده توسط EMM کار می‌کند.
مجموعه محصولاتی را که کاربر حق دسترسی به آنها را دارد (که به آنها محصولات در لیست سفید گفته می شود) تغییر می دهد. فقط محصولاتی که تایید شده اند یا محصولاتی که قبلا تایید شده اند (محصولاتی با تاییدیه لغو شده) می توانند در لیست سفید قرار بگیرند.
فقط با کاربران تحت مدیریت EMM (نه کاربران مدیریت شده توسط Google) قابل استفاده است. جزئیات جدید را در منبع کاربران در بدنه درخواست ارسال کنید. فقط قسمت displayName را می توان تغییر داد. سایر فیلدها یا باید تنظیم نشده باشند یا دارای مقدار فعال فعلی باشند.
تاریخ آخرین به‌روزرسانی 2024-11-13 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2024-11-13 بهوقت ساعت هماهنگ جهانی."],[[["\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."]]
