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 をカプセル化します。識別子セットの要件については、識別子をご覧ください。

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 モデルChromeOS モデルに記載されています。

deviceType

enum (DeviceType)

デバイスのタイプ

chromeOsAttestedDeviceId

string

OEM が提供し、製造と販売のプロセスで保持される識別子。ChromeOS デバイスにのみ適用されます。

共用体フィールド hardware_id。モデム ID に基づくハードウェア ID。hardware_id は次のいずれかになります。
imei

string

デバイスの IMEI 番号。入力で検証される。

meid

string

デバイスの 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

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