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
  },
  "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 לארגונים, אבל הפרופיל עצמו לא נמצא בבעלות של בקר DPC. הערכים הקבילים הם: "`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" מאפשרת למשתמש במכשיר להגדיר את מדיניות העדכון של האפליקציה. "תמיד" מפעילה עדכונים אוטומטיים. 'אף פעם' משבית עדכונים אוטומטיים. 'Wi-Fi בלבד' מאפשרת עדכונים אוטומטיים רק כשהמכשיר מחובר ל-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.productAvailabilityPolicy`	`string`	הזמינות שהוענקה למכשיר בנוגע למוצרים שצוינו. "הכול" מעניקה למכשיר גישה לכל המוצרים, ללא קשר לסטטוס האישור. "הכול" לא מאפשרת חשיפה אוטומטית של alpha או 'בטא' טראקים. רשימת היתרים מעניקה למכשיר גישה למוצרים שצוינו ב-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`	חותמת הזמן של המועד שבו האפליקציה הגדירה את המצב, באלפיות השנייה מאז epoch. השדה הזה תמיד יוצג.
`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 הפעלת החבילה. לעיון בקטע הגבלה חשבונות ב-Google Play.