REST Resource: customers.devices

משאב: מכשיר

מכשיר Android או Chrome OS שרשום להרשמה דרך הארגון ללא מגע.

ייצוג ב-JSON 
{
  "deviceId": string,
  "deviceIdentifier": {
    object (DeviceIdentifier)
  },
  "name": string,
  "deviceMetadata": {
    object (DeviceMetadata)
  },
  "claims": [
    {
      object (DeviceClaim)
    }
  ],
  "configuration": string
}
שדות
deviceId

string (int64 format)

פלט בלבד. המזהה של המכשיר. הוקצתה על ידי השרת.
deviceIdentifier

object (DeviceIdentifier)

מזהי החומרה שמזהים מכשיר שיוצרו. מידע נוסף זמין במאמר מזהים.
name

string

פלט בלבד. שם המשאב ב-API בפורמט customers/[CUSTOMER_ID]/devices/[DEVICE_ID]. הוקצתה על ידי השרת.
deviceMetadata

object (DeviceMetadata)

המטא-נתונים שמצורפים למכשיר. הם מובנים כצמדי מפתח/ערך.
claims[]

object (DeviceClaim)

פלט בלבד. הצהרות הקצאה של מכשיר. למכשירים שדרושה להם הרשמה דרך הארגון יש הצהרה מסוג SECTION_TYPE_ZERO_TOUCH. צריך להתקשר למספר customers.devices.unclaim כדי להסיר את המכשיר מההרשמה דרך הארגון.
configuration

string

ההגדרות האישיות שהופעלו במכשיר בפורמט customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]. הערך הוא null אם לא הוחלו הגדרות אישיות במכשיר.

DeviceIdentifier

אנקפסולציה של מזהי חומרה ומוצרים לצורך זיהוי מכשיר שיוצר. במאמר מזהים מוסבר על הדרישות לגבי קבוצות מזהים.

ייצוג ב-JSON 
{
  "serialNumber": string,
  "manufacturer": string,
  "model": string,
  "deviceType": enum (DeviceType),
  "chromeOsAttestedDeviceId": string,

  // Union field hardware_id can be only one of the following:
  "imei": string,
  "meid": string
  // End of list of possible types for union field hardware_id.

  // Union field hardware_id2 can be only one of the following:
  "imei2": string,
  "meid2": string
  // End of list of possible types for union field hardware_id2.
}
שדות
serialNumber

string

המספר הסידורי של המכשיר על ידי היצרן. יכול להיות שהערך הזה לא ייחודי בכל דגמי המכשירים.
manufacturer

string

השם של יצרן המכשיר. תואם לערך המובנה של המכשיר שהוחזר מ-android.os.Build.MANUFACTURER. הערכים המותרים מפורטים ביצרני Android.
model

string

שם הדגם של המכשיר. הערכים המותרים מפורטים בדגמי Android ובדגמים של Chrome OS.
deviceType

enum (DeviceType)

סוג המכשיר
chromeOsAttestedDeviceId

string

מזהה שמסופק על ידי יצרני ציוד מקורי, ומשויך לכל תהליך הייצור והמכירה. האפשרות רלוונטית רק למכשירי Chrome OS.
שדה האיחוד hardware_id. מזהה חומרה שמבוסס על מזהה מודם. הערך של hardware_id יכול להיות רק אחת מהאפשרויות הבאות:
imei

string

מספר ה-IMEI של המכשיר. בוצע אימות בקלט.
meid

string

מספר ה-MEID של המכשיר.
שדה איחוד hardware_id2. מזהה החומרה השני, למכשירים עם SIM כפול. אם הוא מוגדר, הוא חייב להיות מאותו סוג מזהה כמו מזהה החומרה הראשון. hardware_id2 יכול להיות רק אחת מהאפשרויות הבאות:
imei2

string

מספר ה-IMEI השני של המכשיר.
meid2

string

מספר ה-MEID השני של המכשיר.

DeviceType

מערכת ההפעלה שמותקנת במכשיר.

טיפוסים בני מנייה (enum)
DEVICE_TYPE_ANDROID מכשיר Android
DEVICE_TYPE_CHROME_OS מכשיר Chrome OS

DeviceMetadata

רשומות מטא-נתונים שאפשר לצרף ל-Device. מידע נוסף זמין במאמר מטא-נתונים של מכשיר.

ייצוג ב-JSON 
{
  "entries": {
    string: string,
    ...
  }
}
שדות
entries

map (key: string, value: string)

רשומות של מטא-נתונים שתועדו כצמדי מפתח-ערך.

אובייקט שמכיל רשימה של זוגות "key": value. דוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

DeviceClaim

רשומה של מכשיר שהמפיץ הגיש עליו תלונה בשם לקוח. למכשירים שדרושה להם הרשמה דרך הארגון יש הצהרה מסוג SECTION_TYPE_ZERO_TOUCH. מידע נוסף זמין במאמר הצהרה על מכשירים של לקוחות.

ייצוג JSON 
{
  "sectionType": enum (DeviceProvisioningSectionType),
  "ownerCompanyId": string,
  "googleWorkspaceCustomerId": string,
  "additionalService": enum (AdditionalService)
}
שדות
sectionType

enum (DeviceProvisioningSectionType)

פלט בלבד. סוג התלונה שהוגשה לגבי המכשיר.
ownerCompanyId

string (int64 format)

המזהה של הלקוח שרכש את המכשיר.
googleWorkspaceCustomerId

string

המספר של חשבון Google Workspace שמכשיר ChromeOS נמצא בבעלותו.
additionalService

enum (AdditionalService)

השירות הנוסף שרשום במכשיר.

DeviceProvisioningSectionType

סוג הקטע של רשומת הקצאה.

טיפוסים בני מנייה (enum)
SECTION_TYPE_SIM_LOCK סוג הקטע לנעילת כרטיס SIM.
SECTION_TYPE_ZERO_TOUCH סוג הקטע של הרשמה דרך הארגון.

AdditionalService

שירות נוסף שרשום למכשיר.

טיפוסים בני מנייה (enum)
DEVICE_PROTECTION שירות להגנת מכשירים, שנקרא גם Android Enterprise Essentials. כדי לתבוע בעלות על מכשיר באמצעות השירות להגנה על המכשירים, צריך להירשם אצל צוות השותפות.

שיטות

applyConfiguration

 המערכת מחילה הגדרות אישיות על המכשיר כדי לרשום את המכשיר להרשמה דרך הארגון.

get

 הצגת הפרטים של מכשיר.

list

 בתיבת הדו-שיח הזו מפורטים המכשירים של הלקוחות.

removeConfiguration

 הסרת הגדרה מהמכשיר.

unclaim

 ביטול הבעלות של לקוח על מכשיר והסרת המכשיר מההרשמה דרך הארגון.