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`. (שדה בשם 'מכשיר' לכל יומנים/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" מאפשרת למשתמש במכשיר להגדיר את מדיניות העדכון של האפליקציה. "תמיד" מפעילה עדכונים אוטומטיים. האפשרות 'אף פעם' משביתה את העדכונים האוטומטיים. האפשרות '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`	שעת ההתחלה של חלון התחזוקה, באלפיות השנייה אחרי חצות במכשיר. Windows יכול להתפרס על פני חצות.
`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`	רשימת ערכי המחרוזת – יוצג רק אם סוג המאפיין הוא בחירה מרובה.
`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 שעות במכשיר נתון.
הורדה: אחזור פרטים של מכשיר.
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.