リソース: ChromeOsDevice
Google Chrome デバイスは ChromeOS で動作します。一般的な API タスクの詳細については、デベロッパー ガイドをご覧ください。
JSON 表現 |
---|
{ "deviceId": string, "serialNumber": string, "status": string, "lastSync": string, "supportEndDate": string, "annotatedUser": string, "annotatedLocation": string, "notes": string, "model": string, "meid": string, "orderNumber": string, "willAutoRenew": boolean, "osVersion": string, "platformVersion": string, "firmwareVersion": string, "macAddress": string, "bootMode": string, "lastEnrollmentTime": string, "kind": string, "recentUsers": [ { "type": string, "email": string } ], "activeTimeRanges": [ { "activeTime": integer, "date": string } ], "ethernetMacAddress": string, "annotatedAssetId": string, "etag": string, "diskVolumeReports": [ { "volumeInfo": [ { "volumeId": string, "storageTotal": string, "storageFree": string } ] } ], "systemRamTotal": string, "cpuStatusReports": [ { "reportTime": string, "cpuUtilizationPercentageInfo": [ integer ], "cpuTemperatureInfo": [ { "temperature": integer, "label": string } ] } ], "cpuInfo": [ { "model": string, "architecture": string, "maxClockSpeedKhz": integer, "logicalCpus": [ { "maxScalingFrequencyKhz": integer, "currentScalingFrequencyKhz": integer, "idleDuration": string, "cStates": [ { "displayName": string, "sessionDuration": string } ] } ] } ], "deviceFiles": [ { "name": string, "type": string, "downloadUrl": string, "createTime": string } ], "systemRamFreeReports": [ { "reportTime": string, "systemRamFreeInfo": [ string ] } ], "lastKnownNetwork": [ { "ipAddress": string, "wanIpAddress": string } ], "autoUpdateExpiration": string, "ethernetMacAddress0": string, "dockMacAddress": string, "manufactureDate": string, "orgUnitPath": string, "tpmVersionInfo": { "family": string, "specLevel": string, "manufacturer": string, "tpmModel": string, "firmwareVersion": string, "vendorSpecific": string }, "screenshotFiles": [ { "name": string, "type": string, "downloadUrl": string, "createTime": string } ], "orgUnitId": string, "osUpdateStatus": { object ( |
フィールド | |
---|---|
deviceId |
Chrome デバイスの一意の ID です。 |
serialNumber |
デバイスを有効にしたときに入力した Chrome デバイスのシリアル番号です。この値は、管理コンソールの [ChromeOS デバイス] タブに表示されているシリアル番号と同じです。 |
status |
デバイスのステータス。 指定できる値は次のとおりです。
|
lastSync |
デバイスが管理コンソールのポリシー設定と最後に同期された日時です。値は ISO 8601 の日付と時刻の形式です。時刻は、完全な日付、時、分、秒( |
supportEndDate |
デバイスのサポート最終日。これは、Google から直接購入したデバイスにのみ適用されます。値は ISO 8601 の日付と時刻の形式です。時刻は、完全な日付、時、分、秒( |
annotatedUser |
管理者から指摘されたデバイスのユーザーです。最大文字数は 100 文字です。空の値も使用できます。 |
annotatedLocation |
管理者が指定したデバイスの住所または場所。最大文字数は |
notes |
管理者によって追加された、このデバイスに関するメモ。このプロパティは、list メソッドの |
model |
デバイスのモデル情報。デバイスにこの情報がない場合、このプロパティはレスポンスに含まれません。 |
meid |
モバイル デバイスの 3G モバイルカードの Mobile Equipment Identifier(MEID)または IMEI(International Mobile Equipment Identity)。MEID/IMEI は通常、携帯通信会社の後払いサービスプランにデバイスを追加するときに使用されます。デバイスにこの情報がない場合、このプロパティはレスポンスに含まれません。MEID/IMEI リストをエクスポートする方法について詳しくは、デベロッパー ガイドをご覧ください。 |
orderNumber |
デバイスの注文番号。注文番号が付いているのは、Google から直接購入されたデバイスのみです。 |
willAutoRenew |
サポート終了日以降にデバイスのサポートを自動更新するかどうかを指定します。これは読み取り専用のプロパティです。 |
osVersion |
Chrome デバイスのオペレーティング システムのバージョンです。 |
platformVersion |
Chrome デバイスのプラットフォーム バージョンです。 |
firmwareVersion |
Chrome デバイスのファームウェア バージョンです。 |
macAddress |
デバイスのワイヤレス MAC アドレス。デバイスにこの情報がない場合、レスポンスには含まれません。 |
bootMode |
デバイスの起動モード。使用できる値は次のとおりです。
|
lastEnrollmentTime |
デバイスが最後に登録された日時。値は ISO 8601 の日付と時刻の形式です。時刻は、完全な日付、時、分、秒( |
kind |
リソースのタイプ。Chromeosdevices リソースの場合、値は |
recentUsers[] |
最近のデバイス ユーザーのリスト(最終ログイン時間の降順)。 |
recentUsers[].type |
ユーザーのタイプ。 指定できる値は次のとおりです。
|
recentUsers[].email |
ユーザーのメールアドレス。これは、ユーザータイプが |
activeTimeRanges[] |
有効な期間のリスト(読み取り専用)。 |
activeTimeRanges[].activeTime |
使用時間(ミリ秒単位)。 |
activeTimeRanges[].date |
使用日。 |
ethernetMacAddress |
イーサネット ネットワーク インターフェース上のデバイスの MAC アドレス。 |
annotatedAssetId |
管理者が指定したアセット ID、または登録時に指定されたアセット ID。 |
etag |
リソースの ETag。 |
diskVolumeReports[] |
マウント/接続されたボリュームに関するディスク容量とその他の情報に関するレポート。 |
diskVolumeReports[].volumeInfo[] |
ディスク ボリューム |
diskVolumeReports[].volumeInfo[].volumeId |
ボリューム ID |
diskVolumeReports[].volumeInfo[].storageTotal |
合計ディスク容量 [バイト単位] |
diskVolumeReports[].volumeInfo[].storageFree |
ディスクの空き容量 [バイト単位] |
systemRamTotal |
デバイスの合計 RAM(バイト単位) |
cpuStatusReports[] |
CPU 使用率と温度のレポート(読み取り専用) |
cpuStatusReports[].reportTime |
レポートを受け取った日時。 |
cpuStatusReports[].cpuUtilizationPercentageInfo[] |
|
cpuStatusReports[].cpuTemperatureInfo[] |
CPU 温度サンプルのリスト。 |
cpuStatusReports[].cpuTemperatureInfo[].temperature |
温度(摂氏)。 |
cpuStatusReports[].cpuTemperatureInfo[].label |
CPU ラベル |
cpuInfo[] |
デバイスの CPU 仕様に関する情報です。 |
cpuInfo[].model |
CPU モデル名。 |
cpuInfo[].architecture |
CPU アーキテクチャ。 |
cpuInfo[].maxClockSpeedKhz |
CPU の最大クロック速度(kHz)。 |
cpuInfo[].logicalCpus[] |
論理 CPU の情報 |
cpuInfo[].logicalCpus[].maxScalingFrequencyKhz |
ポリシーによって CPU が実行できる最大周波数。 |
cpuInfo[].logicalCpus[].currentScalingFrequencyKhz |
CPU の現在の周波数。 |
cpuInfo[].logicalCpus[].idleDuration |
前回の起動からのアイドル時間。 「 |
cpuInfo[].logicalCpus[].cStates[] |
C ステートは CPU の消費電力状態を示します。詳細については、CPU メーカーが公開しているドキュメントをご覧ください。 |
cpuInfo[].logicalCpus[].cStates[].displayName |
状態の名前。 |
cpuInfo[].logicalCpus[].cStates[].sessionDuration |
前回の再起動以降にこの状態で費やされた時間。 「 |
deviceFiles[] |
ダウンロードするデバイス ファイルのリスト(読み取り専用) |
deviceFiles[].name |
ファイル名 |
deviceFiles[].type |
ファイル形式 |
deviceFiles[].downloadUrl |
ファイルのダウンロード URL |
deviceFiles[].createTime |
ファイルの作成日時 |
systemRamFreeReports[] |
使用可能な RAM メモリ容量のレポート(読み取り専用) |
systemRamFreeReports[].reportTime |
レポートを受け取った日時。 |
systemRamFreeReports[].systemRamFreeInfo[] |
|
lastKnownNetwork[] |
最後に確認されたネットワークを含む(読み取り専用) |
lastKnownNetwork[].ipAddress |
IP アドレス。 |
lastKnownNetwork[].wanIpAddress |
WAN の IP アドレス。 |
autoUpdateExpiration |
(読み取り専用)デバイスが Chrome の更新やサポートの受信を停止する時点のタイムスタンプ |
ethernetMacAddress0 |
(読み取り専用)Chromebook の内部イーサネット ポートとオンボード ネットワーク(イーサネット)インターフェースで使用される MAC アドレス。形式は、区切り文字(大文字)のない 12 桁の 16 進数です。これは一部のデバイスにのみ関係します。 |
dockMacAddress |
(読み取り専用)デバイスが接続したドッキング ステーションの内蔵 MAC アドレス。ホルダーで使用するために割り当てられるメディア アクセス制御アドレス(MAC アドレス)は、工場出荷時に設定されます。MAC パススルー デバイス ポリシー用に予約されています。形式は、区切り文字(大文字)のない 12 桁の 16 進数です。これは一部のデバイスにのみ関係します。 |
manufactureDate |
(読み取り専用)デバイスが製造された日付(yyyy-mm-dd 形式)。 |
orgUnitPath |
デバイスに関連付けられている組織部門の名前を含む親の完全なパス。パス名では、大文字と小文字は区別されません。親組織部門が最上位の組織の場合は、スラッシュ( |
tpmVersionInfo |
トラステッド プラットフォーム モジュール(TPM)(読み取り専用) |
tpmVersionInfo.family |
TPM ファミリー。次のような TPM 2.0 スタイルのエンコードを使用しています。 |
tpmVersionInfo.specLevel |
TPM 仕様レベル。TPM 2.0 のライブラリ仕様と TPM 1.2 の Main Specification をご覧ください。 |
tpmVersionInfo.manufacturer |
TPM のメーカーコード。 |
tpmVersionInfo.tpmModel |
TPM のモデル番号。 |
tpmVersionInfo.firmwareVersion |
TPM ファームウェアのバージョン。 |
tpmVersionInfo.vendorSpecific |
ベンダー ID などのベンダー固有の情報。 |
screenshotFiles[] |
ダウンロードするスクリーンショット ファイルのリスト。タイプは常に「SCREENSHOT_FILE」です。(読み取り専用) |
screenshotFiles[].name |
ファイル名 |
screenshotFiles[].type |
ファイル形式 |
screenshotFiles[].downloadUrl |
ファイルのダウンロード URL |
screenshotFiles[].createTime |
ファイルの作成日時 |
orgUnitId |
組織部門の一意の ID。orgUnitPath は、人が読める形式の orgUnitId です。orgUnitPath は、パス内の組織部門の名前を変更することで変更される可能性がありますが、orgUnitId は 1 つの組織部門では変更できません。このプロパティは API を使用して更新できます。デバイスの組織構造を作成する方法について詳しくは、管理者向けヘルプセンターをご覧ください。 |
osUpdateStatus |
デバイスの OS アップデートのステータス。 |
firstEnrollmentTime |
デバイスが初めて登録された日時。 |
lastDeprovisionTimestamp |
(読み取り専用)最後にデバイスをデプロビジョニングした日時。 |
deprovisionReason |
(読み取り専用)プロビジョニング解除の理由。 |
deviceLicenseType |
出力のみ。デバイスのライセンスの種類。 |
backlightInfo[] |
出力のみ。デバイスのバックライト情報が含まれます。 |
OsUpdateStatus
現在の OS 更新ステータスに関する情報が含まれています。
JSON 表現 |
---|
{
"state": enum ( |
フィールド | |
---|---|
state |
OS アップデートの更新状態。 |
targetOsVersion |
ダウンロードして適用する OS イメージの新しいプラットフォーム バージョン。更新ステータスが UPDATE_STATUS_DOWNLOAD_IN_PROGRESS または UPDATE_STATUS_NEED_REBOOT の場合にのみ設定されます。これは、アップデート エンジンが再起動なしで再起動されるなど、一部のエッジケースでは、UPDATE_STATUS_NEED_REBOOT のダミー「0.0.0.0」である可能性があります。 |
targetKioskAppVersion |
保留中の更新済みキオスクアプリから、新たに必要なプラットフォーム バージョン。 |
updateTime |
前回 OS が成功した日時。 |
updateCheckTime |
最終更新日時。 |
rebootTime |
最後に再起動した日時。 |
UpdateState
OS アップデートの更新状態。
列挙型 | |
---|---|
UPDATE_STATE_UNSPECIFIED |
更新の状態は指定されていません。 |
UPDATE_STATE_NOT_STARTED |
保留中のアップデートがありますが、開始されていません。 |
UPDATE_STATE_DOWNLOAD_IN_PROGRESS |
保留中の更新をダウンロードしています。 |
UPDATE_STATE_NEED_REBOOT |
デバイスはアップデートをインストールする準備ができていますが、再起動する必要があります。 |
DeprovisionReason
ChromeOS デバイスをデプロビジョニングする理由。
列挙型 | |
---|---|
DEPROVISION_REASON_UNSPECIFIED |
デプロビジョニングの理由が不明です。 |
DEPROVISION_REASON_SAME_MODEL_REPLACEMENT |
同じモデルに置き換え。交換保証(RMA)があり、保証対象となる故障したデバイスを同じデバイスモデルに交換する場合。 |
DEPROVISION_REASON_UPGRADE |
デバイスがアップグレードされました。 |
DEPROVISION_REASON_DOMAIN_MOVE |
デバイスのドメインが変更されました。 |
DEPROVISION_REASON_SERVICE_EXPIRATION |
デバイスのサービスの有効期限が切れました。 |
DEPROVISION_REASON_OTHER |
サポートが終了した以前の理由で、デバイスがデプロビジョニングされました。 |
DEPROVISION_REASON_DIFFERENT_MODEL_REPLACEMENT |
別のモデルに置き換え。このデバイスを、アップグレードされたデバイスか、新しいデバイスのモデルと交換しようとしています。 |
DEPROVISION_REASON_RETIRING_DEVICE |
利用を終了しています。デバイスを寄付する、廃棄する、またはその他の理由で使わなくなる場合。 |
DEPROVISION_REASON_UPGRADE_TRANSFER |
ChromeOS Flex アップグレードの移行。1 年以内に Chromebook に交換する ChromeOS Flex デバイスである場合。 |
DEPROVISION_REASON_NOT_REQUIRED |
理由は必要ありませんでした。たとえば、ライセンスがお客様のライセンス プールに戻された場合などです。 |
DEPROVISION_REASON_REPAIR_CENTER |
修理サービス センターによってデバイスのプロビジョニングが解除されました。RMA 時に修理サービス センターのみが設定できます。 |
DeviceLicenseType
このデバイスのライセンスの種類です。
列挙型 | |
---|---|
DEVICE_LICENSE_TYPE_UNSPECIFIED |
ライセンスの種類が不明です。 |
ENTERPRISE |
デバイスには Chrome Enterprise Upgrade の永久ライセンスがバンドルされています。 |
ENTERPRISE_UPGRADE |
単体の Chrome Enterprise Upgrade 年間ライセンスがデバイスに含まれています。 |
EDUCATION_UPGRADE |
単体の Chrome Education Upgrade の永久ライセンスがデバイスに含まれている。 |
EDUCATION |
デバイスには Chrome Education Upgrade の永久ライセンスがバンドルされています。 |
KIOSK_UPGRADE |
デバイスには Kiosk Upgrade 年間ライセンスが含まれています。 |
BacklightInfo
デバイスのバックライトに関する情報。
JSON 表現 |
---|
{ "path": string, "maxBrightness": integer, "brightness": integer } |
フィールド | |
---|---|
path |
出力のみ。システム上のこのバックライトへのパス。発信者が他の情報との相関分析を行う必要がある場合に役立ちます。 |
maxBrightness |
出力のみ。バックライトの最大輝度。 |
brightness |
出力のみ。バックライトの現在の明るさ(0 ~ maxBrightness)。 |
Methods |
|
---|---|
(deprecated) |
代わりに BatchChangeChromeOsDeviceStatus を使用してください。 |
|
ChromeOS デバイスのプロパティを取得します。 |
|
アカウント内の ChromeOS デバイスのページ分けされたリストを取得します。 |
|
複数の ChromeOS デバイスを組織部門に移動または挿入します。 |
|
デバイスの更新可能なプロパティ(annotatedUser 、annotatedLocation 、notes 、orgUnitPath 、annotatedAssetId など)を更新します。 |
|
デバイスの更新可能なプロパティ(annotatedUser 、annotatedLocation 、notes 、orgUnitPath 、annotatedAssetId など)を更新します。 |