REST Resource: partners.devices

משאב: מכשיר

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

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

string (int64 format)

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

deviceIdentifier

object (DeviceIdentifier)

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

name

string

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

deviceMetadata

object (DeviceMetadata)

המטא-נתונים שמצורפים למכשיר. מובנה כצמדי מפתח-ערך. למידע נוסף, אפשר לקרוא את המאמר מטא-נתונים של מכשיר.

claims[]

object (DeviceClaim)

פלט בלבד. תביעת הבעלות על המכשיר. מכשירים שהוגשה לגביהם הצהרה על זכויות יוצרים בהרשמה דרך הארגון נתבעה עליהם בעלות מסוג SECTION_TYPE_ZERO_TOUCH. צריך להתקשר אל partners.devices.unclaim או partners.devices.unclaimAsync כדי להסיר את המכשיר מהרשמה דרך הארגון.

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,
  "resellerId": string,
  "additionalService": enum (AdditionalService)
}
שדות
sectionType

enum (DeviceProvisioningSectionType)

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

ownerCompanyId

string (int64 format)

המספר של הלקוח שרכש את המכשיר.

googleWorkspaceCustomerId

string

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

resellerId

string (int64 format)

המספר של המפיץ שתבע בעלות על המכשיר.

additionalService

enum (AdditionalService)

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

DeviceProvisioningSectionType

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

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

AdditionalService

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

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

שיטות

claim

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

claimAsync

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

findByIdentifier

איתור מכשירים לפי מזהי חומרה, כמו IMEI.

findByOwner

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

get

מקבל מכשיר.

metadata

מעדכן את המטא-נתונים של המפיץ המשויכים למכשיר.

unclaim

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

unclaimAsync

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

updateMetadataAsync

עדכון המטא-נתונים של המפיץ שמצורפים לקבוצת מכשירים.