REST Resource: customers.devices

משאב: מכשיר

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

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

string

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

string

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

string

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

enum (DeviceType)

סוג המכשיר
chromeOsAttestedDeviceId

string

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

string

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

string

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

DeviceType

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

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

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)

מספר הלקוח שרכש את מכשיר Android.
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

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