Users

برای لیست روش های این منبع، انتهای این صفحه را ببینید.

بازنمایی منابع

یک منبع 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 ، منبع حقیقت گوگل است، بنابراین EMMs باید مطمئن شوند که یک حساب Google برای کاربر وجود دارد. با کاربران emmManaged ، EMM مسئول است.

مقادیر قابل قبول عبارتند از:
  • " emmManaged "
  • " googleManaged "
primaryEmail string آدرس ایمیل اصلی کاربر، به عنوان مثال، "jsmith@example.com". همیشه برای کاربران مدیریت شده Google تنظیم می شود و برای کاربران مدیریت شده EMM تنظیم نمی شود.

روش ها

حذف کنید
یک کاربر تحت مدیریت EMM را حذف کرد.
generateAuthenticationToken
یک رمز احراز هویت ایجاد می کند که سرویس گیرنده خط مشی دستگاه می تواند از آن برای ارائه حساب کاربری داده شده تحت مدیریت EMM در دستگاه استفاده کند. توکن تولید شده یکبار مصرف است و پس از چند دقیقه منقضی می شود.

شما می توانید حداکثر 10 دستگاه برای هر کاربر تهیه کنید.

این تماس فقط با حساب های مدیریت شده توسط EMM کار می کند.
دریافت کنید
جزئیات یک کاربر را بازیابی می کند.
getAvailableProductSet
مجموعه محصولاتی را که کاربر حق دسترسی به آنها را دارد بازیابی می کند.
درج کنید
یک کاربر جدید تحت مدیریت EMM ایجاد می کند.

منبع کاربران ارسال شده در متن درخواست باید شامل accountIdentifier و accountType باشد.

اگر کاربر مربوطه از قبل با همان شناسه حساب وجود داشته باشد، کاربر با منبع به‌روزرسانی می‌شود. در این حالت فقط قسمت displayName را می توان تغییر داد.

فهرست
کاربر را با آدرس ایمیل اصلی جستجو می کند. این فقط برای کاربران تحت مدیریت گوگل پشتیبانی می شود. جستجوی شناسه برای کاربران تحت مدیریت EMM لازم نیست زیرا شناسه قبلاً در نتیجه تماس Users.insert برگردانده شده است.
revokeDeviceAccess
دسترسی به تمام دستگاه‌هایی که در حال حاضر در اختیار کاربر قرار داده شده را لغو می‌کند. کاربر دیگر نمی تواند از فروشگاه Play مدیریت شده در هیچ یک از دستگاه های مدیریت شده خود استفاده کند.

این تماس فقط با حساب‌های مدیریت‌شده توسط EMM کار می‌کند.
setAvailableProductSet
مجموعه محصولاتی را که کاربر حق دسترسی به آنها را دارد (که به آنها محصولات در لیست سفید گفته می شود) تغییر می دهد. فقط محصولاتی که تایید شده اند یا محصولاتی که قبلا تایید شده اند (محصولاتی با تاییدیه لغو شده) می توانند در لیست سفید قرار بگیرند.
به روز رسانی کنید
جزئیات یک کاربر تحت مدیریت EMM را به روز می کند.

فقط با کاربران تحت مدیریت EMM (نه کاربران مدیریت شده توسط Google) قابل استفاده است. جزئیات جدید را در منبع کاربران در بدنه درخواست ارسال کنید. فقط قسمت displayName را می توان تغییر داد. سایر فیلدها یا باید تنظیم نشده باشند یا دارای مقدار فعال فعلی باشند.