REST Resource: customers.devices

リソース: Device

ゼロタッチ登録に登録された Android デバイスまたは Chrome OS デバイス。

JSON 表現 
{
  "deviceId": string,
  "deviceIdentifier": {
    object (DeviceIdentifier)
  },
  "name": string,
  "deviceMetadata": {
    object (DeviceMetadata)
  },
  "claims": [
    {
      object (DeviceClaim)
    }
  ],
  "configuration": string
}
フィールド
deviceId

string (int64 format)

出力のみ。デバイスの ID。サーバーによって割り当てられます。
deviceIdentifier

object (DeviceIdentifier)

製造されたデバイスを識別するハードウェア ID。詳細については、識別子をご覧ください。
name

string

出力のみ。customers/[CUSTOMER_ID]/devices/[DEVICE_ID] 形式の API リソース名。サーバーによって割り当てられます。
deviceMetadata

object (DeviceMetadata)

デバイスに関連付けられているメタデータ。Key-Value ペアとして構造化されます。
claims[]

object (DeviceClaim)

出力のみ。デバイスのプロビジョニング要求。ゼロタッチ登録を申請したデバイスには、SECTION_TYPE_ZERO_TOUCH タイプの申請があります。customers.devices.unclaim を呼び出して、ゼロタッチ登録からデバイスを削除します。
configuration

string

customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID] の形式でデバイスに適用される構成。デバイスに構成が適用されていない場合、値は null になります。

DeviceIdentifier

ハードウェア ID とプロダクト ID をカプセル化して、製造されたデバイスを識別します。識別子セットの要件については、識別子をご覧ください。

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。モデム ID に基づくハードウェア ID。hardware_id は次のいずれかになります。
imei

string

デバイスの IMEI 番号。入力時に検証済み。
meid

string

デバイスの MEID 番号。

DeviceType

デバイスのオペレーティング システム。

列挙型
DEVICE_TYPE_ANDROID Android デバイス
DEVICE_TYPE_CHROME_OS Chrome OS デバイス

デバイス メタデータ

Device に追加できるメタデータ エントリ。詳しくは、デバイスのメタデータをご覧ください。

JSON 表現 
{
  "entries": {
    string: string,
    ...
  }
}
フィールド
entries

map (key: string, value: string)

Key-Value ペアとして記録されたメタデータ エントリ。

"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 デバイスを購入されたお客様の ID。
googleWorkspaceCustomerId

string

Chrome OS デバイスを所有する Google Workspace アカウントの ID。
additionalService

enum (AdditionalService)

デバイスに登録された追加サービス。

DeviceProvisioningSectionType

プロビジョニング レコードのセクションの種類。

列挙型
SECTION_TYPE_SIM_LOCK SIM ロックのセクションの種類。
SECTION_TYPE_ZERO_TOUCH ゼロタッチ登録セクションのタイプ。

追加サービス

デバイスに登録された追加サービス。

列挙型
DEVICE_PROTECTION デバイス保護サービス（別名 Android Enterprise Essentials）。デバイス保護サービスでデバイスの登録を行うには、パートナーシップ チームに登録する必要があります。

Methods

applyConfiguration

 デバイスに設定を適用して、ゼロタッチ登録用にデバイスを登録します。

get

 デバイスの詳細を取得します。

list

 お客様のデバイスを一覧表示します。

removeConfiguration

 デバイスから設定を削除します。

unclaim

 お客様のデバイスの登録を解除し、ゼロタッチ登録から削除します。