לקבלת רשימה של שיטות עבור המשאב הזה, אפשר לעיין בסוף הדף.
ייצוגי משאבים
משאב 'משתמשים' מייצג חשבון המשויך לארגון. החשבון עשוי להיות ספציפי למכשיר או למשתמש יחיד (ולאחר מכן להשתמש בחשבון במכשירים מרובים). החשבון יכול לספק גישה רק ל-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 .
הערכים הקבילים הם:
|
|
displayName |
string |
השם שיופיע בממשקי המשתמש. לא חובה להגדיר את הנכס הזה כשיוצרים משתמשים שמנוהלים על ידי ה-EMM. אם מגדירים את המאפיין הזה, צריך להשתמש בשם כללי של הארגון (למשל "Example, Inc") או בשם שלכם (בתור EMM). לא בשימוש בחשבונות משתמשים המנוהלים על ידי Google. | ניתן לכתיבה |
id |
string |
המזהה הייחודי של המשתמש. |
|
kind |
string |
||
managementType |
string |
הישות שמנהלת את המשתמש. עם googleManaged משתמשים, מקור המהימנות הוא Google, לכן ספקי EMM צריכים לוודא שקיים חשבון Google עבור המשתמש. עם מי שמשתמש ב-emmManaged , ה-EMM אחראי עליהם.
הערכים הקבילים הם:
|
|
primaryEmail |
string |
כתובת האימייל הראשית של המשתמש, לדוגמה, 'jsmith@example.com'. תמיד יוגדר עבור משתמשים המנוהלים על ידי Google ולא יוגדר עבור משתמשים מנוהלים ב-EMM. |
שיטות
- מחיקה
- נמחק משתמש המנוהל על ידי EMM.
- createAuthenticationToken
- יצירת אסימון אימות שהלקוח במדיניות המכשיר יכול להשתמש בו כדי להקצות למכשיר את חשבון המשתמש הנתון המנוהל על ידי ה-EMM.
האסימון שנוצר הוא לשימוש חד-פעמי ותוקפו פג לאחר מספר דקות.
אפשר להקצות עד 10 מכשירים לכל משתמש.
השיחה הזו פועלת רק בחשבונות שמנוהלים על ידי ה-EMM. - הורדה
- מאחזר את פרטי המשתמש.
- getavailableProductSet
- מאחזר את קבוצת המוצרים שלמשתמש יש גישה אליהם. הערה: הפריט הזה הוצא משימוש. שילובים חדשים לא יכולים להשתמש בשיטה הזו ויכולים להתייחס להמלצות החדשות שלנו.
- הוספה
- יצירת משתמש חדש המנוהל על ידי EMM.
המשאב Users שמועבר בגוף הבקשה צריך לכלולaccountIdentifier
ו-accountType
.אם כבר קיים משתמש תואם עם אותו מזהה חשבון, המשתמש יעודכן עם המשאב. במקרה כזה, אפשר לשנות רק את השדה
displayName
. - list
- מחפשים משתמש לפי כתובת האימייל הראשית. אפשרות זו נתמכת רק למשתמשים המנוהלים על ידי Google. אין צורך לחפש את המזהה עבור משתמשים המנוהלים על ידי EMM, כי המזהה כבר מוחזר בקריאה ל-Users.insert.
- revokeDeviceAccess
- מבטל את הגישה לכל המכשירים שהוקצו למשתמש כרגע. המשתמש לא יוכל יותר להשתמש בחנות Play המנוהלת באף אחד מהמכשירים המנוהלים שלו.
השיחה הזו פועלת רק בחשבונות שמנוהלים על ידי ה-EMM. - setavailableProductSet
- שינוי קבוצת המוצרים שלמשתמש יש גישה אליהם (שנקראים מוצרים שנמצאים ברשימת ההיתרים). רק מוצרים שאושרו או מוצרים שאושרו בעבר (מוצרים עם אישור מבוטל) יכולים להיכלל ברשימת ההיתרים. הערה: הפריט הזה הוצא משימוש. שילובים חדשים לא יכולים להשתמש בשיטה הזו ויכולים להתייחס להמלצות החדשות שלנו.
- עדכון
- עדכון הפרטים של משתמש שמנוהל על ידי EMM.
אפשר להשתמש בהגדרה הזו רק עם משתמשים שמנוהלים על ידי EMM (לא עם משתמשים שמנוהלים על ידי Google). מעבירים את הפרטים החדשים במשאב Users בגוף הבקשה. אפשר לשנות רק את השדהdisplayName
. שאר השדות לא חייבים להיות מוגדרים או לא מוגדרים כרגע לערך פעיל.