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.

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

enum (DeviceProvisioningSectionType)

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

string (int64 format)

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

string

המזהה של חשבון Google Workspace שבבעלותו מכשיר Chrome OS.
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

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