REST Resource: customers.devices

リソース: Device

ゼロタッチ登録に登録されている Android デバイスまたは ChromeOS デバイス。

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。詳細については、ID をご覧ください。
name

string

出力専用。API リソース名（customers/[CUSTOMER_ID]/devices/[DEVICE_ID] 形式）。サーバーによって割り当てられます。
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.

  // 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 モデルと ChromeOS モデルをご覧ください。
deviceType

enum (DeviceType)

デバイスの種類
chromeOsAttestedDeviceId

string

OEM から提供され、製造プロセスと販売プロセスで使用される識別子。ChromeOS デバイスにのみ適用されます。
共用体フィールド hardware_id。モデム ID に基づくハードウェア ID。hardware_id は次のいずれかになります。
imei

string

デバイスの IMEI 番号。入力時に検証されます。
meid

string

デバイスの MEID 番号。
共用体フィールド hardware_id2。デュアル SIM デバイス用の 2 つ目のハードウェア ID。設定する場合は、最初のハードウェア ID と同じ ID タイプにする必要があります。hardware_id2 は次のいずれかになります。
imei2

string

デバイスの 2 つ目の IMEI 番号。
meid2

string

デバイスの 2 つ目の MEID 番号。

DeviceType

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

列挙型
DEVICE_TYPE_ANDROID Android デバイス
DEVICE_TYPE_CHROME_OS ChromeOS デバイス

DeviceMetadata

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)

デバイスを購入したお客様の ID。
googleWorkspaceCustomerId

string

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

enum (AdditionalService)

デバイスに登録されている追加サービス。

DeviceProvisioningSectionType

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

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

AdditionalService

デバイスに登録されている追加サービス。

列挙型
DEVICE_PROTECTION デバイス保護サービス（Android Enterprise Essentials とも呼ばれます）。デバイス保護サービスを利用してデバイスを申請するには、パートナーシップ チームに登録する必要があります。

メソッド

applyConfiguration

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

get

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

list

 お客様のデバイスの一覧が表示されます。

removeConfiguration

 デバイスから構成を削除します。

unclaim

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