כלי: list_devices
רשימת המכשירים בארגון מסוים. נדרש מזהה הארגון בשדה parent (לדוגמה, enterprises/{enterpriseId}).
בדוגמה הבאה אפשר לראות איך משתמשים ב-curl כדי להפעיל את כלי ה-MCP list_devices.
| בקשת סריקה |
|---|
curl --location 'https://androidmanagement.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/call", "params": { "name": "list_devices", "arguments": { // provide these details according to the tool's MCP specification } }, "jsonrpc": "2.0", "id": 1 }' |
סכימת קלט
בקשה לרשום מכשירים לארגון מסוים.
ListDevicesRequest
| ייצוג ב-JSON |
|---|
{ "parent": string, "pageSize": integer, "pageToken": string } |
| שדות | |
|---|---|
parent |
שם הארגון בפורמט |
pageSize |
גודל הדף המבוקש. אם לא מציינים ערך, יוחזרו לכל היותר 10 מכשירים. הערך המקסימלי הוא 100. ערכים גבוהים יותר יומרו ל-100. המגבלות יכולות להשתנות עם הזמן. |
pageToken |
אסימון שמזהה דף תוצאות שהוחזר על ידי השרת. |
סכימת הפלט
תשובה לבקשה לרשום מכשירים לארגון נתון.
ListDevicesResponse
| ייצוג ב-JSON |
|---|
{
"devices": [
{
object ( |
| שדות | |
|---|---|
devices[] |
רשימת המכשירים. |
nextPageToken |
אם יש עוד תוצאות, יוחזר אסימון לאחזור הדף הבא של התוצאות. |
מכשיר
| ייצוג ב-JSON |
|---|
{ "name": string, "userName": string, "managementMode": enum ( |
| שדות | |
|---|---|
name |
השם של המכשיר בפורמט |
userName |
שם המשאב של המשתמש שהוא הבעלים של המכשיר הזה, בפורמט |
managementMode |
סוג מצב הניהול שאפליקציית Device Policy ל-Android מפעילה במכשיר. ההגדרה הזו משפיעה על הגדרות המדיניות שנתמכות. |
state |
המצב שיוחל על המכשיר. אפשר לשנות את השדה הזה באמצעות בקשת תיקון. שימו לב: כשמבצעים קריאה ל- |
appliedState |
המצב שמוחל כרגע על המכשיר. |
policyCompliant |
אם המכשיר תואם למדיניות שלו. |
nonComplianceDetails[] |
פרטים על הגדרות המדיניות שהמכשיר לא עומד בהן. |
enrollmentTime |
השעה שבה המכשיר שויך לארגון. הפלט שנוצר תמיד יהיה בפורמט RFC 3339, עם נורמליזציה של Z ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: |
lastStatusReportTime |
המועד האחרון שבו המכשיר שלח דוח סטטוס. הפלט שנוצר תמיד יהיה בפורמט RFC 3339, עם נורמליזציה של Z ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: |
lastPolicyComplianceReportTime |
הוצא משימוש. הפלט שנוצר תמיד יהיה בפורמט RFC 3339, עם נורמליזציה של Z ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: |
lastPolicySyncTime |
הפעם האחרונה שבה המכשיר שלף את המדיניות שלו. הפלט שנוצר תמיד יהיה בפורמט RFC 3339, עם נורמליזציה של Z ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: |
policyName |
שם המדיניות שחלה על המכשיר, בתבנית |
appliedPolicyName |
השם של המדיניות שחלה כרגע על המכשיר. |
appliedPolicyVersion |
הגרסה של המדיניות שחלה כרגע על המכשיר. |
apiLevel |
רמת ה-API של גרסת פלטפורמת Android שפועלת במכשיר. |
enrollmentTokenData |
אם המכשיר נרשם באמצעות טוקן הרשמה עם נתונים נוספים, השדה הזה מכיל את הנתונים האלה. |
enrollmentTokenName |
אם המכשיר נרשם באמצעות טוקן הרשמה, השדה הזה מכיל את שם הטוקן. |
disabledReason |
אם מצב המכשיר הוא |
softwareInfo |
מידע מפורט על תוכנת המכשיר. המידע הזה זמין רק אם המדיניות |
hardwareInfo |
מידע מפורט על החומרה של המכשיר. |
displays[] |
מידע מפורט על המסכים במכשיר. המידע הזה זמין רק אם המדיניות |
applicationReports[] |
דוחות על אפליקציות שמותקנות במכשיר. המידע הזה זמין רק אם הערך של |
previousDeviceNames[] |
אם אותו מכשיר פיזי נרשם כמה פעמים, השדה הזה יכיל את השמות הקודמים של המכשיר. המספר הסידורי משמש כמזהה הייחודי כדי לקבוע אם אותו מכשיר פיזי נרשם בעבר. השמות מופיעים בסדר כרונולוגי. |
networkInfo |
פרטי הרשת של המכשיר. המידע הזה זמין רק אם המדיניות |
memoryInfo |
פרטי הזיכרון: מכילים מידע על הזיכרון והאחסון של המכשיר. |
memoryEvents[] |
אירועים שקשורים למדידות של זיכרון ואחסון בסדר כרונולוגי. המידע הזה זמין רק אם המדיניות האירועים נשמרים למשך תקופה מסוימת, ואירועים ישנים נמחקים. |
powerManagementEvents[] |
אירועים של ניהול צריכת החשמל במכשיר בסדר כרונולוגי. המידע הזה זמין רק אם המדיניות |
hardwareStatusSamples[] |
דוגמאות לסטטוס החומרה בסדר כרונולוגי. המידע הזה זמין רק אם המדיניות |
deviceSettings |
מידע על הגדרות המכשיר. המידע הזה זמין רק אם המדיניות |
user |
המשתמש שהוא הבעלים של המכשיר. |
systemProperties |
מיפוי של השם והערך של מאפייני המערכת שנבחרו שקשורים למכשיר. המידע הזה זמין רק אם המדיניות אובייקט שמכיל רשימה של |
securityPosture |
ערך של מצב האבטחה של המכשיר שמשקף את רמת האבטחה של המכשיר. |
ownership |
בעלות על המכשיר המנוהל. |
commonCriteriaModeInfo |
מידע על מצב Common Criteria – תקני אבטחה שמוגדרים בCommon Criteria for Information Technology Security Evaluation (CC). המידע הזה זמין רק אם |
appliedPasswordPolicies[] |
דרישות הסיסמה שחלות כרגע על המכשיר.
|
dpcMigrationInfo |
פלט בלבד. מידע שקשור להעברה של המכשיר הזה מניהול של בקר מדיניות מכשירים (DPC) אחר. |
defaultApplicationInfo[] |
פלט בלבד. פרטי האפליקציה שמוגדרים כברירת מחדל עבור כל סוגי האפליקציות מדווחים במכשירים שמנוהלים באופן מלא. הסוגים |
NonComplianceDetail
| ייצוג ב-JSON |
|---|
{ "settingName": string, "nonComplianceReason": enum ( |
| שדות | |
|---|---|
settingName |
השם של הגדרת המדיניות. זהו שם השדה ב-JSON של שדה |
nonComplianceReason |
הסיבה לכך שהמכשיר לא עומד בדרישות ההגדרה. |
packageName |
שם החבילה שמציין איזו אפליקציה לא עומדת בדרישות, אם רלוונטי. |
fieldPath |
בהגדרות עם שדות מקוננים, אם שדה מקונן מסוים לא עומד בדרישות התאימות, מצוין הנתיב המלא לשדה הבעייתי. הנתיב מפורמט באותו אופן שבו שדה מדיניות JSON יקבל הפניה ב-JavaScript, כלומר: 1) בשדות מסוג אובייקט, שם השדה מופיע ואחריו נקודה ואז שם שדה המשנה. 2) בשדות מסוג מערך, אחרי שם השדה מופיע אינדקס המערך בתוך סוגריים. לדוגמה, כדי לציין בעיה בשדה |
currentValue |
אם אי אפשר להחיל את הגדרת המדיניות, הערך הנוכחי של ההגדרה במכשיר. |
installationFailureReason |
אם המדיניות |
specificNonComplianceReason |
הסיבה הספציפית למדיניות לכך שהמכשיר לא עומד בדרישות ההגדרה. |
specificNonComplianceContext |
הקשר נוסף לגבי |
ערך
| ייצוג ב-JSON |
|---|
{ // Union field |
| שדות | |
|---|---|
שדה איחוד kind. סוג הערך. הערך kind יכול להיות רק אחד מהבאים: |
|
nullValue |
מייצג ערך null. |
numberValue |
מייצג ערך כפול. |
stringValue |
מייצג ערך מחרוזת. |
boolValue |
מייצג ערך בוליאני. |
structValue |
מייצג ערך מובנה. |
listValue |
מייצג |
Struct
| ייצוג ב-JSON |
|---|
{ "fields": { string: value, ... } } |
| שדות | |
|---|---|
fields |
מפה לא מסודרת של ערכים עם הקלדה דינמית. אובייקט שמכיל רשימה של |
FieldsEntry
| ייצוג ב-JSON |
|---|
{ "key": string, "value": value } |
| שדות | |
|---|---|
key |
|
value |
|
ListValue
| ייצוג ב-JSON |
|---|
{ "values": [ value ] } |
| שדות | |
|---|---|
values[] |
שדה חוזר של ערכים עם הקלדה דינמית. |
SpecificNonComplianceContext
| ייצוג ב-JSON |
|---|
{ "oncWifiContext": { object ( |
| שדות | |
|---|---|
oncWifiContext |
הקשר נוסף לגבי אי-תאימות שקשורה להגדרת Wi-Fi. פרטים נוספים זמינים ב |
passwordPoliciesContext |
הקשר נוסף לגבי אי-תאימות שקשורה למדיניות בנושא סיסמאות. פרטים נוספים זמינים ב |
defaultApplicationContext |
פלט בלבד. הקשר נוסף לגבי אי-תאימות שקשורה להגדרות ברירת המחדל של האפליקציה. |
OncWifiContext
| ייצוג ב-JSON |
|---|
{ "wifiGuid": string } |
| שדות | |
|---|---|
wifiGuid |
ה-GUID של תצורת Wi-Fi שלא עומדת בדרישות. |
PasswordPoliciesContext
| ייצוג ב-JSON |
|---|
{
"passwordPolicyScope": enum ( |
| שדות | |
|---|---|
passwordPolicyScope |
היקף הסיסמה שלא עומדת בדרישות. |
DefaultApplicationContext
| ייצוג ב-JSON |
|---|
{
"defaultApplicationScope": enum ( |
| שדות | |
|---|---|
defaultApplicationScope |
פלט בלבד. ההיקף של הגדרת ברירת מחדל של אפליקציה שלא עומדת בדרישות. |
חותמת זמן
| ייצוג ב-JSON |
|---|
{ "seconds": string, "nanos": integer } |
| שדות | |
|---|---|
seconds |
מייצג שניות של זמן UTC מאז ראשית זמן יוניקס (Unix epoch) ב-1970-01-01T00:00:00Z. הערך חייב להיות בין -62135596800 ל-253402300799 כולל (שמתאים לטווח 0001-01-01T00:00:00Z עד 9999-12-31T23:59:59Z). |
nanos |
שברים לא שליליים של שנייה ברזולוציית ננו-שנייה. השדה הזה מייצג את החלק של משך הזמן בננו-שניות, ולא חלופה לשניות. ערכי שניות שליליים עם שברים עדיין צריכים לכלול ערכי ננו-שניות לא שליליים שסופרים קדימה בזמן. הערך חייב להיות בין 0 ל-999,999,999, כולל. |
UserFacingMessage
| ייצוג ב-JSON |
|---|
{ "localizedMessages": { string: string, ... }, "defaultMessage": string } |
| שדות | |
|---|---|
localizedMessages |
מפה שמכילה זוגות של <locale, message>, כאשר locale הוא קוד שפה בתקן BCP 47, כמו en-US, es-ES או fr. אובייקט שמכיל רשימה של |
defaultMessage |
הודעת ברירת המחדל שמוצגת אם לא צוינה הודעה מותאמת לשפה או שהלוקאל של המשתמש לא תואם לאף אחת מההודעות המותאמות לשפה. אם מספקים הודעות מותאמות לשוק המקומי, צריך לספק הודעת ברירת מחדל. |
LocalizedMessagesEntry
| ייצוג ב-JSON |
|---|
{ "key": string, "value": string } |
| שדות | |
|---|---|
key |
|
value |
|
SoftwareInfo
| ייצוג ב-JSON |
|---|
{
"androidVersion": string,
"androidDevicePolicyVersionCode": integer,
"androidDevicePolicyVersionName": string,
"androidBuildNumber": string,
"deviceKernelVersion": string,
"bootloaderVersion": string,
"androidBuildTime": string,
"securityPatchLevel": string,
"primaryLanguageCode": string,
"deviceBuildSignature": string,
"systemUpdateInfo": {
object ( |
| שדות | |
|---|---|
androidVersion |
מחרוזת גרסת Android שמוצגת למשתמש. לדוגמה, |
androidDevicePolicyVersionCode |
קוד הגרסה של אפליקציית Device Policy ל-Android. |
androidDevicePolicyVersionName |
הגרסה של אפליקציית Android Device Policy שמוצגת למשתמש. |
androidBuildNumber |
מחרוזת של מזהה build של Android שנועדה להצגה למשתמש. לדוגמה, |
deviceKernelVersion |
גרסת ליבה, לדוגמה, |
bootloaderVersion |
מספר הגרסה של תוכנת האתחול של המערכת, לדוגמה, |
androidBuildTime |
משך זמן של תהליך build. הפלט שנוצר תמיד יהיה בפורמט RFC 3339, עם נורמליזציה של Z ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: |
securityPatchLevel |
רמת תיקון האבטחה, למשל |
primaryLanguageCode |
קוד שפה של IETF BCP 47 ללוקאל הראשי במכשיר. |
deviceBuildSignature |
גיבוב SHA-256 של |
systemUpdateInfo |
מידע על עדכון מערכת פוטנציאלי בהמתנה. |
SystemUpdateInfo
| ייצוג ב-JSON |
|---|
{
"updateStatus": enum ( |
| שדות | |
|---|---|
updateStatus |
הסטטוס של עדכון: אם קיים עדכון ומה הסוג שלו. |
updateReceivedTime |
השעה שבה העדכון היה זמין לראשונה. ערך אפס מציין שהשדה הזה לא מוגדר. השדה הזה מוגדר רק אם יש עדכון זמין (כלומר, אם הערך של הפלט שנוצר תמיד יהיה בפורמט RFC 3339, עם נורמליזציה של Z ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: |
HardwareInfo
| ייצוג ב-JSON |
|---|
{
"brand": string,
"hardware": string,
"deviceBasebandVersion": string,
"manufacturer": string,
"serialNumber": string,
"model": string,
"batteryShutdownTemperatures": [
number
],
"batteryThrottlingTemperatures": [
number
],
"cpuShutdownTemperatures": [
number
],
"cpuThrottlingTemperatures": [
number
],
"gpuShutdownTemperatures": [
number
],
"gpuThrottlingTemperatures": [
number
],
"skinShutdownTemperatures": [
number
],
"skinThrottlingTemperatures": [
number
],
"enterpriseSpecificId": string,
"euiccChipInfo": [
{
object ( |
| שדות | |
|---|---|
brand |
המותג של המכשיר. לדוגמה, |
hardware |
שם החומרה. לדוגמה, |
deviceBasebandVersion |
גרסת פס בסיס. לדוגמה, |
manufacturer |
יצרן. לדוגמה, |
serialNumber |
המספר הסידורי של המכשיר. עם זאת, במכשירים בבעלות אישית עם Android מגרסה 12 ואילך, ההגדרה הזו זהה להגדרה |
model |
הדגם של המכשיר. לדוגמה, |
batteryShutdownTemperatures[] |
סף הטמפרטורה (במעלות צלזיוס) שמעליו המכשיר יכבה בגלל הסוללה, לכל סוללה במכשיר. |
batteryThrottlingTemperatures[] |
סף הטמפרטורה של הסוללה שמעבר לו מתבצעת הגבלת הביצועים (throttling) של הסוללה במעלות צלזיוס, לכל סוללה במכשיר. |
cpuShutdownTemperatures[] |
סף הטמפרטורה לכיבוי המעבד (CPU) במעלות צלזיוס לכל מעבד במכשיר. |
cpuThrottlingTemperatures[] |
סף הטמפרטורה של ויסות נתונים (throttle) של מעבד (CPU) במעלות צלזיוס לכל מעבד במכשיר. |
gpuShutdownTemperatures[] |
סף הטמפרטורה לכיבוי ה-GPU במעלות צלזיוס לכל GPU במכשיר. |
gpuThrottlingTemperatures[] |
סף הטמפרטורה של ויסות הנתונים של ה-GPU במעלות צלזיוס לכל GPU במכשיר. |
skinShutdownTemperatures[] |
ספי טמפרטורת העור של המכשיר במעלות צלזיוס. |
skinThrottlingTemperatures[] |
סף הטמפרטורה של העור במכשיר במעלות צלזיוס. |
enterpriseSpecificId |
פלט בלבד. מזהה שמזהה באופן ייחודי מכשיר בבעלות אישית בארגון מסוים. באותו מכשיר פיזי, כשהוא רשום לאותו ארגון, המזהה הזה נשמר בין ההגדרות ואפילו אחרי איפוס להגדרות המקוריות. המזהה הזה זמין במכשירים בבעלות אישית עם פרופיל עבודה, במכשירים עם Android מגרסה 12 ואילך. |
euiccChipInfo[] |
פלט בלבד. מידע שקשור לצ'יפ eUICC. |
EuiccChipInfo
| ייצוג ב-JSON |
|---|
{ "eid": string } |
| שדות | |
|---|---|
eid |
פלט בלבד. מסמך הזהות המוטמע (EID) שמזהה את שבב ה-eUICC עבור כל שבב eUICC במכשיר. התכונה הזו זמינה במכשירים בבעלות החברה עם Android מגרסה 13 ואילך. |
רשת המדיה
| ייצוג ב-JSON |
|---|
{
"name": string,
"displayId": integer,
"refreshRate": integer,
"state": enum ( |
| שדות | |
|---|---|
name |
השם של התצוגה. |
displayId |
מזהה תצוגה ייחודי. |
refreshRate |
קצב הרענון של התצוגה בפריימים לשנייה. |
state |
המצב של התצוגה. |
width |
רוחב התצוגה בפיקסלים. |
height |
גובה התצוגה בפיקסלים. |
density |
צפיפות התצוגה מבוטאת בנקודות לאינץ'. |
ApplicationReport
| ייצוג ב-JSON |
|---|
{ "packageName": string, "versionName": string, "versionCode": integer, "events": [ { object ( |
| שדות | |
|---|---|
packageName |
שם החבילה של האפליקציה. |
versionName |
גרסת האפליקציה כפי שהיא מוצגת למשתמש. |
versionCode |
קוד הגרסה של האפליקציה, שבעזרתו אפשר לקבוע אם גרסה מסוימת עדכנית יותר מגרסה אחרת. |
events[] |
רשימת אירועים באפליקציה שהתרחשו ב-30 השעות האחרונות. |
displayName |
השם המוצג של האפליקציה. |
packageSha256Hash |
גיבוב SHA-256 של קובץ ה-APK של האפליקציה, שאפשר להשתמש בו כדי לוודא שהאפליקציה לא שונתה. כל בית (byte) של ערך הגיבוב מיוצג כמספר הקסדצימלי בן שתי ספרות. |
signingKeyCertFingerprints[] |
גיבוב SHA-1 של כל |
installerPackageName |
שם החבילה של האפליקציה שהתקינה את האפליקציה הזו. |
applicationSource |
המקור של החבילה. |
state |
מצב האפליקציה. |
keyedAppStates[] |
רשימה של מצבי אפליקציה עם מפתח שדווחו על ידי האפליקציה. |
userFacingType |
האם האפליקציה פונה למשתמשים. |
ApplicationEvent
| ייצוג ב-JSON |
|---|
{
"eventType": enum ( |
| שדות | |
|---|---|
eventType |
סוג אירוע באפליקציה. |
createTime |
השעה שבה האירוע נוצר. הפלט שנוצר תמיד יהיה בפורמט RFC 3339, עם נורמליזציה של Z ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: |
KeyedAppState
| ייצוג ב-JSON |
|---|
{
"key": string,
"severity": enum ( |
| שדות | |
|---|---|
key |
המפתח של מצב האפליקציה. משמש כנקודת ייחוס למה שהאפליקציה מספקת לגבי הסטטוס. לדוגמה, כשמספקים משוב על הגדרה מנוהלת, המפתח הזה יכול להיות המפתח של ההגדרה המנוהלת. |
severity |
רמת החומרה של מצב האפליקציה. |
message |
מחרוזת הודעה בפורמט חופשי להסבר על מצב האפליקציה (אופציונלי). אם המצב הופעל על ידי ערך מסוים (למשל ערך של הגדרה מנוהלת), צריך לכלול אותו בהודעה. |
data |
באופן אופציונלי, ערך שניתן לקריאה על ידי מכונה, כדי שמערכת ה-EMM תוכל לקרוא אותו. לדוגמה, הגדרת ערכים שהאדמין יכול לבחור לבצע לגביהם שאילתה במסוף EMM (למשל, 'הודעה אם הנתונים של battery_warning הם < 10'). |
createTime |
השעה שבה נוצר מצב האפליקציה במכשיר. הפלט שנוצר תמיד יהיה בפורמט RFC 3339, עם נורמליזציה של Z ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: |
lastUpdateTime |
השעה שבה מצב האפליקציה עודכן לאחרונה. הפלט שנוצר תמיד יהיה בפורמט RFC 3339, עם נורמליזציה של Z ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: |
NetworkInfo
| ייצוג ב-JSON |
|---|
{
"imei": string,
"meid": string,
"wifiMacAddress": string,
"networkOperatorName": string,
"telephonyInfos": [
{
object ( |
| שדות | |
|---|---|
imei |
מספר ה-IMEI של מכשיר ה-GSM. לדוגמה, |
meid |
מספר ה-MEID של מכשיר ה-CDMA. לדוגמה, |
wifiMacAddress |
כתובת ה-MAC של ה-Wi-Fi של המכשיר. לדוגמה, |
networkOperatorName |
השם האלפביתי של המפעיל הרשום הנוכחי. לדוגמה, Vodafone. |
telephonyInfos[] |
מספק מידע על הטלפוניה שמשויך לכל כרטיס SIM במכשיר. התמיכה קיימת רק במכשירים בניהול מלא החל מרמת Android API 23. |
TelephonyInfo
| ייצוג ב-JSON |
|---|
{ "phoneNumber": string, "carrierName": string, "iccId": string, "activationState": enum ( |
| שדות | |
|---|---|
phoneNumber |
מספר הטלפון שמשויך לכרטיס ה-SIM. |
carrierName |
שם הספק שמשויך לכרטיס ה-SIM הזה. |
iccId |
פלט בלבד. מספר ה-ICCID שמשויך לכרטיס ה-SIM הזה. |
activationState |
פלט בלבד. מצב ההפעלה של כרטיס ה-SIM במכשיר. ההגדרה הזו רלוונטית רק ל-eSIM. התכונה הזו נתמכת בכל המכשירים ברמת API 35 ומעלה. הערך הזה הוא תמיד |
configMode |
פלט בלבד. מצב ההגדרה של כרטיס ה-SIM במכשיר. ההגדרה הזו רלוונטית רק ל-eSIM. התכונה הזו נתמכת בכל המכשירים ברמת API 35 ומעלה. הערך הזה הוא תמיד |
MemoryInfo
| ייצוג ב-JSON |
|---|
{ "totalRam": string, "totalInternalStorage": string } |
| שדות | |
|---|---|
totalRam |
הנפח הכולל של ה-RAM במכשיר בבייטים. |
totalInternalStorage |
נפח האחסון הפנימי הכולל במכשיר בבייטים. |
MemoryEvent
| ייצוג ב-JSON |
|---|
{
"eventType": enum ( |
| שדות | |
|---|---|
eventType |
סוג האירוע. |
createTime |
השעה שבה האירוע נוצר. הפלט שנוצר תמיד יהיה בפורמט RFC 3339, עם נורמליזציה של Z ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: |
byteCount |
מספר הבייטים הפנויים במדיה, או במקרה של |
PowerManagementEvent
| ייצוג ב-JSON |
|---|
{
"eventType": enum ( |
| שדות | |
|---|---|
eventType |
סוג האירוע. |
createTime |
השעה שבה האירוע נוצר. הפלט שנוצר תמיד יהיה בפורמט RFC 3339, עם נורמליזציה של Z ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: |
batteryLevel |
עבור אירועים מסוג |
HardwareStatus
| ייצוג ב-JSON |
|---|
{ "createTime": string, "batteryTemperatures": [ number ], "cpuTemperatures": [ number ], "gpuTemperatures": [ number ], "skinTemperatures": [ number ], "fanSpeeds": [ number ], "cpuUsages": [ number ] } |
| שדות | |
|---|---|
createTime |
השעה שבה בוצעו המדידות. הפלט שנוצר תמיד יהיה בפורמט RFC 3339, עם נורמליזציה של Z ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: |
batteryTemperatures[] |
הטמפרטורות הנוכחיות של הסוללות במעלות צלזיוס לכל סוללה במכשיר. |
cpuTemperatures[] |
טמפרטורות נוכחיות של יחידת העיבוד המרכזית (CPU) במעלות צלזיוס לכל יחידת עיבוד מרכזית במכשיר. |
gpuTemperatures[] |
טמפרטורות ה-GPU הנוכחיות במעלות צלזיוס לכל GPU במכשיר. |
skinTemperatures[] |
טמפרטורת העור הנוכחית של המכשיר במעלות צלזיוס. |
fanSpeeds[] |
מהירויות המאווררים בסיבובים לדקה (RPM) לכל מאוורר במכשיר. מערך ריק מציין שאין מאווררים או שהמערכת לא תומכת במהירות המאווררים. |
cpuUsages[] |
אחוז השימוש ב-CPU לכל ליבה שזמינה במכשיר. השימוש הוא 0 לכל ליבה לא מחוברת. מערך ריק מרמז שהשימוש במעבד לא נתמך במערכת. |
DeviceSettings
| ייצוג ב-JSON |
|---|
{
"isDeviceSecure": boolean,
"unknownSourcesEnabled": boolean,
"developmentSettingsEnabled": boolean,
"adbEnabled": boolean,
"isEncrypted": boolean,
"encryptionStatus": enum ( |
| שדות | |
|---|---|
isDeviceSecure |
אם המכשיר מאובטח באמצעות קוד גישה או סיסמה. |
unknownSourcesEnabled |
האם מופעלת התקנה של אפליקציות ממקורות לא מוכרים. |
developmentSettingsEnabled |
האם מצב הפיתוח מופעל במכשיר. |
adbEnabled |
ההגדרה הזאת קובעת אם ADB מופעל במכשיר. |
isEncrypted |
האם הצפנת האחסון מופעלת. |
encryptionStatus |
סטטוס ההצפנה מ-DevicePolicyManager. |
verifyAppsEnabled |
האם אימות Google Play Protect נאכף במכשיר. |
משתמש
| ייצוג ב-JSON |
|---|
{ "accountIdentifier": string } |
| שדות | |
|---|---|
accountIdentifier |
מזהה ייחודי שאתם יוצרים למשתמש הזה, כמו |
SystemPropertiesEntry
| ייצוג ב-JSON |
|---|
{ "key": string, "value": string } |
| שדות | |
|---|---|
key |
|
value |
|
SecurityPosture
| ייצוג ב-JSON |
|---|
{ "devicePosture": enum ( |
| שדות | |
|---|---|
devicePosture |
ערך של מצב האבטחה של המכשיר. |
postureDetails[] |
פרטים נוספים לגבי מצב האבטחה של המכשיר. |
PostureDetail
| ייצוג ב-JSON |
|---|
{ "securityRisk": enum ( |
| שדות | |
|---|---|
securityRisk |
סיכון אבטחה ספציפי שמשפיע לרעה על מצב האבטחה של המכשיר. |
advice[] |
המלצות לאדמינים שיעזרו לצמצם את הסיכון הזה ולשפר את רמת האבטחה של המכשיר. |
CommonCriteriaModeInfo
| ייצוג ב-JSON |
|---|
{ "commonCriteriaModeStatus": enum ( |
| שדות | |
|---|---|
commonCriteriaModeStatus |
האם מצב Common Criteria מופעל. |
policySignatureVerificationStatus |
פלט בלבד. הסטטוס של אימות חתימת המדיניות. |
PasswordRequirements
| ייצוג ב-JSON |
|---|
{ "passwordMinimumLength": integer, "passwordMinimumLetters": integer, "passwordMinimumLowerCase": integer, "passwordMinimumNonLetter": integer, "passwordMinimumNumeric": integer, "passwordMinimumSymbols": integer, "passwordMinimumUpperCase": integer, "passwordQuality": enum ( |
| שדות | |
|---|---|
passwordMinimumLength |
האורך המינימלי המותר של הסיסמה. הערך 0 מציין שאין הגבלה. האכיפה מתבצעת רק אם הערך של |
passwordMinimumLetters |
מספר האותיות המינימלי שנדרש בסיסמה. האכיפה מתבצעת רק אם |
passwordMinimumLowerCase |
מספר האותיות הקטנות המינימלי שנדרש בסיסמה. האכיפה מתבצעת רק אם |
passwordMinimumNonLetter |
מספר התווים המינימלי שאינם אותיות (ספרות או סמלים) שנדרשים בסיסמה. האכיפה מתבצעת רק אם |
passwordMinimumNumeric |
מספר הספרות המינימלי שנדרש בסיסמה. האכיפה מתבצעת רק אם |
passwordMinimumSymbols |
מספר הסמלים המינימלי שנדרש בסיסמה. האכיפה מתבצעת רק אם |
passwordMinimumUpperCase |
מספר האותיות הגדולות המינימלי שנדרש בסיסמה. האכיפה מתבצעת רק אם |
passwordQuality |
איכות הסיסמה הנדרשת. |
passwordHistoryLength |
אורך היסטוריית הסיסמאות. אחרי שמגדירים את השדה הזה, המשתמש לא יכול להזין סיסמה חדשה שזהה לסיסמה כלשהי בהיסטוריה. הערך 0 מציין שאין הגבלה. |
maximumFailedPasswordsForWipe |
מספר הסיסמאות השגויות לפתיחת נעילת המכשיר שאפשר להזין לפני שמבוצע איפוס נתוני המכשיר. הערך 0 מציין שאין הגבלה. |
passwordExpirationTimeout |
הזמן הקצוב לתפוגת התוקף של הסיסמה. משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, שמסתיים ב-' |
passwordScope |
ההיקף שהדרישה לסיסמה חלה עליו. |
requirePasswordUnlock |
משך הזמן שעובר אחרי שפותחים את הנעילה של מכשיר או פרופיל עבודה באמצעות שיטת אימות חזקה (סיסמה, קוד אימות, קו פתיחת נעילה) ועד שאפשר לפתוח את הנעילה באמצעות שיטת אימות אחרת (למשל טביעת אצבע, סוכני מהימנות, זיהוי פנים). אחרי שפרק הזמן שצוין חולף, אפשר להשתמש רק בשיטות אימות חזקות כדי לבטל את הנעילה של המכשיר או של פרופיל העבודה. |
unifiedLockSettings |
ההגדרה קובעת אם מותר להשתמש בנעילה מאוחדת במכשיר ובפרופיל העבודה במכשירים עם Android מגרסה 9 ואילך עם פרופיל עבודה. אפשר להגדיר את המדיניות הזו רק אם המדיניות |
משך
| ייצוג ב-JSON |
|---|
{ "seconds": string, "nanos": integer } |
| שדות | |
|---|---|
seconds |
שניות חתומות של טווח הזמן. הערך חייב להיות בין -315,576,000,000 לבין +315,576,000,000, כולל. הערה: הגבולות האלה מחושבים לפי: 60 שניות/דקה * 60 דקות/שעה * 24 שעות/יום * 365.25 ימים/שנה * 10,000 שנים |
nanos |
שברים חתומים של שנייה ברזולוציית ננו-שנייה של טווח הזמן. משכי זמן של פחות משנייה אחת מיוצגים באמצעות שדה |
DpcMigrationInfo
| ייצוג ב-JSON |
|---|
{ "previousDpc": string, "additionalData": string } |
| שדות | |
|---|---|
previousDpc |
פלט בלבד. אם המכשיר הזה הועבר מ-DPC אחר, זהו שם החבילה שלו. אחרת, השדה לא מאוכלס. |
additionalData |
פלט בלבד. אם המכשיר הזה הועבר מ-DPC אחר, השדה |
DefaultApplicationInfo
| ייצוג ב-JSON |
|---|
{ "defaultApplicationType": enum ( |
| שדות | |
|---|---|
defaultApplicationType |
פלט בלבד. סוג האפליקציה שמוגדר כברירת מחדל. |
packageName |
פלט בלבד. שם החבילה של אפליקציית ברירת המחדל הנוכחית. |
defaultApplicationSettingAttempts[] |
פלט בלבד. פרטים על ניסיונות ההגדרה של אפליקציית ברירת המחדל, באותו סדר שמופיע ב- |
DefaultApplicationSettingAttempt
| ייצוג ב-JSON |
|---|
{
"packageName": string,
"attemptOutcome": enum ( |
| שדות | |
|---|---|
packageName |
פלט בלבד. שם החבילה של האפליקציה שניסיתם להוריד. |
attemptOutcome |
פלט בלבד. התוצאה של הגדרת האפליקציה כברירת מחדל. |
הערות על כלי
רמז הרסני: ❌ | רמז אידמפוטנטי: ✅ | רמז לקריאה בלבד: ✅ | רמז לעולם פתוח: ❌