Users

רשימה של ה-methods במשאב הזה מופיעה בסוף הדף.

ייצוגי משאבים

משאב 'משתמשים' מייצג חשבון שמשויך לארגון. החשבון יכול להיות ספציפי למכשיר או למשתמש מסוים (שאחר כך יכול להשתמש בחשבון במכשירים שונים). החשבון עשוי לספק גישה רק אל 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.

המשאב Users שמועבר בגוף הבקשה צריך לכלול את השדות accountIdentifier ו-accountType.
אם כבר קיים משתמש תואם עם אותו מזהה חשבון, המשתמש יתעדכן עם המשאב. במקרה הזה אפשר לשנות רק את השדה displayName.
list: חיפוש משתמש לפי כתובת אימייל ראשית. האפשרות הזו נתמכת רק עבור משתמשים שמנוהלים על ידי Google. משתמשים שמנוהלים על ידי EMM לא צריכים לחפש את המזהה, כי המזהה כבר מוחזר בעקבות הקריאה של Users.insert.
revokeDeviceAccess: מבטל את הגישה לכל המכשירים שהוקצו למשתמש כרגע. המשתמש לא יוכל יותר להשתמש בחנות Play לארגונים באף אחד מהמכשירים המנוהלים שלו.

השיחה הזו עובדת רק בחשבונות שמנוהלים על ידי EMM.
setAvailableProductSet: הוצא משימוש: בשילובים חדשים אי אפשר להשתמש בשיטה הזו, והם יכולים לעיין בהמלצות החדשות שלנו.
שינוי קבוצת המוצרים שהמשתמש רשאי לגשת אליהם (מוצרים האלה נקראים מוצרים whitelisted). אפשר להוסיף לרשימת ההיתרים רק מוצרים שאושרו או מוצרים שאושרו בעבר (מוצרים עם אישור שבוטלו).
עדכון: עדכון הפרטים של משתמש שמנוהל על ידי EMM.

רלוונטי רק למשתמשים שמנוהלים על ידי EMM (לא למשתמשים שמנוהלים על ידי Google). מעבירים את הפרטים החדשים במשאב Users בגוף הבקשה. אפשר לשנות רק את השדה displayName. שדות אחרים צריכים להיות לא מוגדרים או לכלול את הערך הפעיל הנוכחי.