Devices

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

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

משאב 'מכשירים' מייצג מכשיר נייד שמנוהל על ידי ה-EMM וששייך למשתמש ספציפי בארגון.

{
  "kind": "androidenterprise#device",
  "androidId": string,
  "managementType": string,
  "policy": {
    "autoUpdatePolicy": string,
    "productAvailabilityPolicy": string,
    "productPolicy": [
      {
        "productId": string,
        "tracks": [
          string
        ],
        "trackIds": [
          string
        ],
        "managedConfiguration": {
          "kind": string,
          "productId": string,
          "managedProperty": [
            {
              "key": string,
              "valueBool": boolean,
              "valueInteger": integer,
              "valueString": string,
              "valueStringArray": [
                string
              ],
              "valueBundle": {
                "managedProperty": [
                  (ManagedProperty)
                ]
              },
              "valueBundleArray": [
                {
                  "managedProperty": [
                    (ManagedProperty)
                  ]
                }
              ]
            }
          ],
          "configurationVariables": {
            "kind": "androidenterprise#configurationVariables",
            "mcmId": string,
            "variableSet": [
              {
                "kind": "androidenterprise#variableSet",
                "placeholder": string,
                "userValue": string
              }
            ]
          }
        },
        "autoInstallPolicy": {
          "autoInstallMode": string,
          "autoInstallPriority": integer,
          "autoInstallConstraint": [
            {
              "networkTypeConstraint": string,
              "chargingStateConstraint": string,
              "deviceIdleStateConstraint": string
            }
          ],
          "minimumVersionCode": integer
        },
        "autoUpdateMode": string,
        "enterpriseAuthenticationAppLinkConfigs": [
          {
            "uri": string
          }
        ]
      }
    ],
    "maintenanceWindow": {
      "startTimeAfterMidnightMs": long,
      "durationMs": long
    },
    "deviceReportPolicy": string,
    "policyId": string
  },
  "report": {
    "lastUpdatedTimestampMillis": long,
    "appState": [
      {
        "packageName": string,
        "keyedAppState": [
          {
            "key": string,
            "stateTimestampMillis": long,
            "severity": string,
            "message": string,
            "data": string
          }
        ]
      }
    ]
  },
  "latestBuildFingerprint": string,
  "sdkVersion": integer,
  "maker": string,
  "model": string,
  "device": string,
  "product": string,
  "retailBrand": string
}

שם הנכס	ערך	תיאור
`androidId`	`string`	מזהה Android של Google Play Services למכשיר, המקודד כמחרוזת הקסדצימלית באותיות קטנות. לדוגמה, `"123456789abcdef0"`.
`device`	`string`	הכינוי הפנימי של החומרה של המכשיר. המידע הזה מגיע מ-`android.os.Build.DEVICE`. (שדה בשם 'device' לפי logs/wireless/android/android_checkin.proto)
`kind`	`string`
`latestBuildFingerprint`	`string`	המאפיינים הייחודיים של גרסת ה-build של המכשיר, אם הם ידועים.
`maker`	`string`	היצרן של המכשיר. המידע הזה מגיע מ-`android.os.Build.MANUFACTURER`.
`managementType`	`string`	מזהה את מידת השליטה של EMM המנוהל ב-Google Play במכשיר בתצורות פריסה שונות. הערכים האפשריים כוללים: `managedDevice` – מכשיר שבו הבעלים הוא בקר מדיניות המכשיר (DPC) של ה-EMM. '`managedProfile`', מכשיר שיש בו פרופיל שמנוהל על ידי ה-DPC (ה-DPC הוא הבעלים של הפרופיל) בנוסף לפרופיל אישי נפרד שלא זמין ל-DPC. '`containerApp`', לא בשימוש יותר (הוחלף). `unmanagedProfile` – מכשיר שקיבל הרשאה (על ידי האדמין של הדומיין, באמצעות מסוף Admin כדי להפעיל את ההרשאה) להשתמש ב-Google Play לארגונים, אבל הבעלים של הפרופיל עצמו הוא לא חשבון ניהול של דומיין. הערכים הקבילים הם: "`containerApp`" "`managedDevice`" "`managedProfile`" "`unmanagedProfile`"
`model`	`string`	שם הדגם של המכשיר. המידע הזה מגיע מ-`android.os.Build.MODEL`.
`policy`	`nested object`	המדיניות שחלה על המכשיר.
`policy.autoUpdatePolicy`	`string`	קובע מתי ניתן להחיל עדכונים אוטומטיים של אפליקציות במכשיר. חלופה מומלצת: `autoUpdateMode`, שמוגדר לכל אפליקציה, מספק גמישות רבה יותר לגבי תדירות העדכונים. כשהערך של `autoUpdateMode` מוגדר כ-`AUTO_UPDATE_POSTPONED` או כ-`AUTO_UPDATE_HIGH_PRIORITY`, ל-`autoUpdatePolicy` אין השפעה. `choiceToTheUser` מאפשר למשתמש במכשיר להגדיר את מדיניות עדכון האפליקציות. `always` מפעיל עדכונים אוטומטיים. `never` משבית את העדכונים האוטומטיים. `wifiOnly` מאפשרת עדכונים אוטומטיים רק כשהמכשיר מחובר ל-Wi-Fi. חשוב: שינויים במדיניות עדכון האפליקציות לא משפיעים על עדכונים שנמצאים בתהליך. שינויים במדיניות יחולו על עדכוני האפליקציה הבאים. הערכים הקבילים הם: "`always`" "`choiceToTheUser`" "`never`" "`wifiOnly`"
`policy.deviceReportPolicy`	`string`	אם המכשיר מדווח על מצבי האפליקציות ל-EMM. ערך ברירת המחדל הוא 'deviceReportDisabled'. הערכים הקבילים הם: "`deviceReportDisabled`" "`deviceReportEnabled`"
`policy.maintenanceWindow`	`nested object`	חלון הזמן לתחזוקה שמגדיר מתי צריך לעדכן אפליקציות שפועלות בחזית.
`policy.maintenanceWindow.durationMs`	`long`	משך חלון הזמן לתחזוקה, באלפיות שנייה. משך הזמן חייב להיות בין 30 דקות ל-24 שעות (כולל).
`policy.maintenanceWindow.startTimeAfterMidnightMs`	`long`	שעת ההתחלה של חלון התחזוקה, באלפיות השנייה אחרי חצות במכשיר. חלונות יכולים לחול על חצות.
`policy.policyId`	`string`	מזהה של המדיניות שיישלח עם המשוב על התקנת האפליקציה שנשלח מחנות Play.
`policy.productAvailabilityPolicy`	`string`	הזמינות שהוקצה למכשיר עבור המוצרים שצוינו. הערך 'all' מעניק למכשיר גישה לכל המוצרים, ללא קשר לסטטוס האישור שלהם. הערך 'all' לא מאפשר חשיפה אוטומטית של טראקים מסוג 'alpha' או 'beta'. 'whitelist' מעניק למכשיר גישה למוצרים שצוינו ב-productPolicy[]. אפשר להוסיף לרשימת ההיתרים רק מוצרים שאושרו על ידי הארגון או מוצרים שאושרו בעבר (מוצרים עם אישור שהתבטל). אם לא מציינים ערך, הזמינות שמוגדרת ברמת המשתמש חלה כברירת מחדל. הערכים הקבילים הם: "`all`" "`whitelist`"
`policy.productPolicy[]`	`list`	רשימת כללי המדיניות של המוצר. כדי שמדיניות המוצרים תחול, צריך להגדיר את הערך של `productAvailabilityPolicy` כ-`WHITELIST` או כ-`ALL`.
`policy.productPolicy[].autoInstallPolicy`	`nested object`	מדיניות ההתקנה האוטומטית של המוצר.
`policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[]`	`list`	האילוצים להתקנה האוטומטית של האפליקציה. אפשר לציין עד אילוץ אחד.
`policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].chargingStateConstraint`	`string`	אילוץ של מצב הטעינה. הערכים הקבילים הם: "`chargingNotRequired`" "`chargingRequired`"
`policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].deviceIdleStateConstraint`	`string`	אילוץ על מצב המכשיר במצב חוסר פעילות. הערכים הקבילים הם: "`deviceIdleNotRequired`" "`deviceIdleRequired`"
`policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].networkTypeConstraint`	`string`	אילוץ של סוג הרשת. הערכים הקבילים הם: "`anyNetwork`" "`unmeteredNetwork`"
`policy.productPolicy[].autoInstallPolicy.autoInstallMode`	`string`	מצב ההתקנה האוטומטית. אם לא מגדירים את הערך, ברירת המחדל היא 'doNotAutoInstall'. האפליקציה מותקנת באופן אוטומטי, ללא קשר לחלון התחזוקה שהוגדר. הערכים הקבילים הם: "`autoInstallOnce`" "`doNotAutoInstall`" "`forceAutoInstall`"
`policy.productPolicy[].autoInstallPolicy.autoInstallPriority`	`integer`	העדיפות של ההתקנה, כמספר שלם ללא סימן. ככל שהמספר נמוך יותר, כך העדיפות גבוהה יותר.
`policy.productPolicy[].autoInstallPolicy.minimumVersionCode`	`integer`	הגרסה המינימלית של האפליקציה. אם מותקנת גרסה ישנה יותר של האפליקציה, היא תתעדכן באופן אוטומטי בהתאם למגבלות ההתקנה האוטומטית, במקום להמתין לעדכון האוטומטי הרגיל. אפשר להגדיר קוד גרסה מינימלי ל-20 אפליקציות לכל היותר בכל מכשיר.
`policy.productPolicy[].autoUpdateMode`	`string`	מצב העדכון האוטומטי של המוצר. כשמשתמשים ב-`autoUpdateMode`, הוא תמיד מקבל עדיפות על פני הבחירה של המשתמש. לכן, כשמשתמש מבצע שינויים בהגדרות המכשיר באופן ידני, המערכת מתעלמת מהשינויים האלה. הערכים הקבילים הם: "`autoUpdateDefault`" "`autoUpdateHighPriority`" "`autoUpdatePostponed`"
`policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[]`	`list`	הגדרת כתובת URL לאימות של אפליקציית האימות של ספק הזהויות. כך אפשר להפעיל את האפליקציה לאימות חשבונות של ספק הזהויות במהלך האימות שמתרחש באפליקציה פרטית באמצעות Android WebView. אפליקציית האימות כבר אמורה להיות ה-handler שמוגדר כברירת מחדל לכתובת ה-URL לאימות במכשיר.
`policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[].uri`	`string`	כתובת URL לאימות.
`policy.productPolicy[].managedConfiguration`	`nested object`	ההגדרה המנוהלת של המוצר.
`policy.productPolicy[].managedConfiguration.configurationVariables`	`nested object`	מכיל את המזהה של פרופיל ההגדרות המנוהל ואת קבוצת משתני ההגדרות (אם יש כאלה) שהוגדרו למשתמש.
`policy.productPolicy[].managedConfiguration.configurationVariables.kind`	`string`
`policy.productPolicy[].managedConfiguration.configurationVariables.mcmId`	`string`	המזהה של הגדרות ההגדרות האישיות המנוהלות.
`policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[]`	`list`	קבוצת המשתנים שמשויכת למשתמש.
`policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].kind`	`string`
`policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].placeholder`	`string`	מחרוזת placeholder שמוגדרת על ידי ה-EMM.
`policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].userValue`	`string`	הערך של placeholder, שספציפי למשתמש.
`policy.productPolicy[].managedConfiguration.kind`	`string`	הוצא משימוש.
`policy.productPolicy[].managedConfiguration.managedProperty[]`	`list`	קבוצת הנכסים המנוהלים של ההגדרה הזו.
`policy.productPolicy[].managedConfiguration.managedProperty[].key`	`string`	המפתח הייחודי שמזהה את הנכס.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueBool`	`boolean`	הערך הבוליאני – הוא יופיע רק אם סוג המאפיין הוא bool.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle`	`nested object`	החבילה של הנכסים המנוהלים – השדה הזה יופיע רק אם סוג הנכס הוא 'חבילה'.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle.managedProperty[]`	`list`	רשימת הנכסים המנוהלים.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[]`	`list`	רשימת החבילות של הנכסים – הרשימה הזו תופיע רק אם סוג הנכס הוא bundle_array.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[].managedProperty[]`	`list`	רשימת הנכסים המנוהלים.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueInteger`	`integer`	הערך של המספר השלם – הוא יופיע רק אם סוג המאפיין הוא מספר שלם.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueString`	`string`	ערך המחרוזת – הוא יופיע רק אם סוג המאפיין הוא מחרוזת, בחירה או מוסתר.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueStringArray[]`	`list`	רשימת ערכי המחרוזות – הרשימה הזו תופיע רק אם סוג המאפיין הוא multiselect.
`policy.productPolicy[].managedConfiguration.productId`	`string`	המזהה של המוצר שאליו מיועדת התצורה המנוהלת, למשל 'app:com.google.android.gm'.
`policy.productPolicy[].productId`	`string`	המזהה של המוצר. לדוגמה, `"app:com.google.android.gm"`.
`policy.productPolicy[].trackIds[]`	`list`	הרשאה שמעניקה למכשיר גישה למסלולי השקת המוצר שצוינו, שזוהו באמצעות `trackIds`. כדי לקבל את רשימת הטראקים של מוצר מסוים, אפשר להפעיל את Products.Get.
`policy.productPolicy[].tracks[]`	`list`	הוצא משימוש. במקום זאת, אתם צריכים להשתמש ב-`trackIds`.
`product`	`string`	שם המוצר של המכשיר. המידע הזה מגיע מ-`android.os.Build.PRODUCT`.
`report`	`nested object`	דוח המכשיר עודכן עם מצבי האפליקציות העדכניים ביותר.
`report.appState[]`	`list`	רשימת מצבי האפליקציות שהוגדרו על ידי אפליקציות מנוהלות במכשיר. מצבי האפליקציה מוגדרים על ידי מפתחי האפליקציה. השדה הזה תמיד יופיע.
`report.appState[].keyedAppState[]`	`list`	רשימה של מצבי אפליקציה עם מפתח. השדה הזה תמיד יופיע.
`report.appState[].keyedAppState[].data`	`string`	שדה נוסף המיועד לנתונים שניתנים לקריאה על ידי מכונה. לדוגמה, מספר או אובייקט JSON. כדי למנוע התקפת XSS, מומלץ להסיר את כל ה-HTML מהנתונים לפני הצגתם.
`report.appState[].keyedAppState[].key`	`string`	מפתח שמציין את המצב שהאפליקציה מספקת. תוכן המפתח מוגדר על ידי מפתח האפליקציה. כדי למנוע התקפת XSS, מומלץ להסיר כל HTML מהמפתח לפני שמוצגים אותו. השדה הזה תמיד יופיע.
`report.appState[].keyedAppState[].message`	`string`	הודעה חופשית שאנשים יכולים לקרוא, שמתארת את מצב האפליקציה. לדוגמה, הודעת שגיאה. כדי למנוע התקפת XSS, מומלץ להסיר את כל ה-HTML מההודעה לפני הצגתה.
`report.appState[].keyedAppState[].severity`	`string`	חומרת מצב האפליקציה. השדה הזה תמיד יופיע. הערכים הקבילים הם: "`severityError`" "`severityInfo`"
`report.appState[].keyedAppState[].stateTimestampMillis`	`long`	חותמת הזמן של המועד שבו האפליקציה הגדרה את המצב, במיליוניות השנייה מאז תחילת התקופה של זמן מערכת. השדה הזה תמיד יופיע.
`report.appState[].packageName`	`string`	שם החבילה של האפליקציה. השדה הזה תמיד יופיע.
`report.lastUpdatedTimestampMillis`	`long`	חותמת הזמן של עדכון הדוח האחרון, במיליוניות השנייה מאז תחילת הזמן. השדה הזה תמיד יופיע.
`retailBrand`	`string`	המותג הקמעונאי של המכשיר, אם הוא מוגדר. `android.os.Build.BRAND`
`sdkVersion`	`integer`	גרסת התאימות של ה-API.

Methods

forceReportUpload: העלאת דוח שמכיל את כל השינויים במצבי האפליקציות במכשיר מאז יצירת הדוח האחרון. אפשר להפעיל את השיטה הזו עד 3 פעמים בכל 24 שעות במכשיר נתון.
get: אחזור הפרטים של מכשיר.
getState: החזרת מידע על כך שהגישה של מכשיר לשירותי Google מופעלת או מושבתת. מצב המכשיר נכנס לתוקף רק אם אכיפת כללי מדיניות EMM במכשירי Android מופעלת במסוף Google Admin. אחרת, מצב המכשיר לא יילקח בחשבון וכל המכשירים יקבלו גישה לשירותי Google. התכונה הזו נתמכת רק למשתמשים בניהול Google.
list: אחזור המזהים של כל המכשירים של המשתמש.
setState: הגדרה שמציינת אם הגישה של מכשיר לשירותי Google מופעלת או מושבתת. מצב המכשיר נכנס לתוקף רק אם אכיפת כללי מדיניות EMM במכשירי Android מופעלת במסוף Google Admin. אחרת, מצב המכשיר לא יילקח בחשבון וכל המכשירים יקבלו גישה לשירותי Google. התכונה הזו נתמכת רק למשתמשים בניהול Google.
עדכון: עדכון מדיניות המכשיר.

כדי לוודא שהמדיניות נאכפת כראוי, צריך למנוע מחשבונות לא מנוהלים לגשת ל-Google Play. לשם כך, מגדירים את הערך allowed_accounts בהגדרה המנוהלת של חבילת Google Play. איך מגבילים חשבונות ב-Google Play