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 אם לא הוגדרה במכשיר תצורה כלשהי.

מזהה מכשיר

כולל את המזהים של חומרה ומוצר כדי לזהות מכשיר מיוצר. כדי להבין את הדרישות לקבוצות מזהים, אפשר לקרוא את המאמר מזהים.

ייצוג 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.
}
שדות
serialNumber

string

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

string

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

string

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

enum (DeviceType)

סוג המכשיר
chromeOsAttestedDeviceId

string

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

string

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

string

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

סוג המכשיר

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

Enums
DEVICE_TYPE_ANDROID מכשיר Android
DEVICE_TYPE_CHROME_OS מכשיר Chrome OS

מטא נתונים של המכשיר

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

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

map (key: string, value: string)

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

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

תביעה במכשיר

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

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

enum (DeviceProvisioningSectionType)

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

string (int64 format)

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

string

המזהה של חשבון Google Workspace שאליו שייך מכשיר Chrome OS.
additionalService

enum (AdditionalService)

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

סוג הקצאת מכשיר

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

Enums
SECTION_TYPE_SIM_LOCK סוג הקטע של נעילת ה-SIM.
SECTION_TYPE_ZERO_TOUCH סוג קטע ההרשמה דרך הארגון.

שירות נוסף

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

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

שיטות

applyConfiguration

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

get

 קבלת פרטים של מכשיר.

list

 רשימת המכשירים של הלקוח.

removeConfiguration

 הסרה של תצורה מהמכשיר.

unclaim

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