Devices

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

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

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

שיטות

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