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 فهرست شده‌اند.

deviceType

enum ( DeviceType )

نوع دستگاه

chromeOsAttestedDeviceId

string

شناسه ای که توسط OEM ها ارائه می شود که از طریق فرآیند تولید و فروش انجام می شود. فقط برای دستگاه‌های Chrome OS قابل اجرا است.

فیلد اتحادیه hardware_id . شناسه سخت افزار بر اساس شناسه مودم. hardware_id می تواند تنها یکی از موارد زیر باشد:
imei

string

شماره IMEI دستگاه در ورودی تایید شد.

meid

string

شماره MEID دستگاه

فیلد اتحادیه hardware_id2 . دومین شناسه سخت افزاری، برای دستگاه های دو سیم کارته. اگر تنظیم شود، باید همان نوع شناسه شناسه سخت افزاری اول باشد. hardware_id2 تنها می تواند یکی از موارد زیر باشد:
imei2

string

دومین شماره IMEI دستگاه.

meid2

string

شماره MEID دوم دستگاه.

نوع دستگاه

سیستم عامل دستگاه.

Enums
DEVICE_TYPE_ANDROID دستگاه اندروید
DEVICE_TYPE_CHROME_OS دستگاه سیستم عامل کروم

Metadata دستگاه

ورودی‌های فراداده‌ای که می‌توانند به یک 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 که صاحب دستگاه سیستم عامل Chrome است.

additionalService

enum ( AdditionalService )

خدمات اضافی برای دستگاه ثبت شده است.

DeviceProvisioningSectionType

نوع بخش یک رکورد تأمین.

Enums
SECTION_TYPE_SIM_LOCK نوع بخش قفل سیم کارت
SECTION_TYPE_ZERO_TOUCH نوع بخش ثبت نام بدون لمس.

خدمات اضافی

خدمات اضافی برای دستگاه ثبت شده است.

Enums
DEVICE_PROTECTION سرویس محافظت از دستگاه، همچنین به عنوان Android Enterprise Essentials شناخته می شود. برای درخواست دستگاهی با خدمات حفاظت از دستگاه، باید در تیم مشارکت ثبت نام کنید.

روش ها

applyConfiguration

 پیکربندی را برای ثبت دستگاه برای ثبت نام بدون لمس روی دستگاه اعمال می کند.

get

 جزئیات یک دستگاه را دریافت می کند.

list

 دستگاه های مشتری را فهرست می کند.

removeConfiguration

 یک پیکربندی را از دستگاه حذف می کند.

unclaim

 دستگاهی را از مشتری سلب می کند و آن را از ثبت نام بدون لمس حذف می کند.