REST Resource: partners.devices

リソース: Device

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

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

string (int64 format)

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

deviceIdentifier

object (DeviceIdentifier)

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

name

string

出力専用。partners/[PARTNER_ID]/devices/[DEVICE_ID] 形式の API リソース名。サーバーによって割り当てられます。

deviceMetadata

object (DeviceMetadata)

デバイスに関連付けられているメタデータ。Key-Value ペアとして構成されます。詳細については、デバイスのメタデータをご覧ください。

claims[]

object (DeviceClaim)

出力専用。デバイスのプロビジョニング クレーム。ゼロタッチ登録で申告されたデバイスには、SECTION_TYPE_ZERO_TOUCH タイプの申告があります。partners.devices.unclaim または partners.devices.unclaimAsync を呼び出して、ゼロタッチ登録からデバイスを削除します。

DeviceIdentifier

ハードウェア ID とプロダクト ID をカプセル化して、製造されたデバイスを識別します。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,
  "resellerId": string,
  "additionalService": enum (AdditionalService)
}
フィールド
sectionType

enum (DeviceProvisioningSectionType)

出力専用。デバイスに対して行われた申し立ての種類。

ownerCompanyId

string (int64 format)

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

googleWorkspaceCustomerId

string

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

resellerId

string (int64 format)

デバイスを申し立てた販売店の ID。

additionalService

enum (AdditionalService)

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

DeviceProvisioningSectionType

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

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

AdditionalService

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

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

メソッド

claim

お客様のデバイスを申告し、ゼロタッチ登録に追加します。

claimAsync

お客様のデバイスのバッチを非同期で申し立てます。

findByIdentifier

IMEI などのハードウェア ID でデバイスを検索します。

findByOwner

お客様に代わって申請されたデバイスを見つけます。

get

デバイスを取得します。

metadata

デバイスに関連付けられている販売店のメタデータを更新します。

unclaim

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

unclaimAsync

お客様のデバイスのバッチの申し立てを非同期で取り消します。

updateMetadataAsync

デバイスのバッチに関連付けられている販売店のメタデータを更新します。