リソース: ChromeOsDevice
Google Chrome デバイスは Chrome OS で動作します。一般的な 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 モバイルカードの MEID(Mobile Equipment Identifier)または 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。 |
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 |
File 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 のメイン仕様をご覧ください。 |
tpmVersionInfo.manufacturer |
TPM メーカーコード。 |
tpmVersionInfo.tpmModel |
TPM のモデル番号。 |
tpmVersionInfo.firmwareVersion |
TPM ファームウェアのバージョン。 |
tpmVersionInfo.vendorSpecific |
ベンダー ID などのベンダー固有の情報。 |
screenshotFiles[] |
ダウンロードするスクリーンショット ファイルのリスト。タイプは常に "SCREENSHOT_FILE" です。(読み取り専用) |
screenshotFiles[].name |
ファイル名 |
screenshotFiles[].type |
File type |
screenshotFiles[].downloadUrl |
ファイルのダウンロード URL |
screenshotFiles[].createTime |
ファイルの作成日時 |
orgUnitId |
組織部門の一意の ID。orgUnitPath は、人が読める形式の orgUnitId です。orgUnitPath はパス内の組織部門の名前を変更することで変更できますが、1 つの組織部門に対して orgUnitId を変更することはできません。このプロパティは API を使用して更新できます。デバイスの組織構造を作成する方法について詳しくは、管理者向けヘルプセンターをご覧ください。 |
osUpdateStatus |
デバイスの OS アップデートのステータス。 |
firstEnrollmentTime |
デバイスが初めて登録された日時。 |
lastDeprovisionTimestamp |
(読み取り専用)デバイスが最後にデプロビジョニングされた日時。 |
deprovisionReason |
(読み取り専用)プロビジョニング解除の理由。 |
deviceLicenseType |
出力のみ。デバイスのライセンスの種類。 |
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
デバイスがデプロビジョニングされた理由。
列挙型 | |
---|---|
DEPROVISION_REASON_UNSPECIFIED |
デプロビジョニングの理由が不明です。 |
DEPROVISION_REASON_SAME_MODEL_REPLACEMENT |
デバイスを同じモデルのデバイスに交換した。 |
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 |
デバイスの永久アップグレードが新しいデバイスに移行されました。 |
DEPROVISION_REASON_NOT_REQUIRED |
理由は必要ありませんでした。たとえば、ライセンスが顧客のライセンス プールに戻されました。 |
DEPROVISION_REASON_REPAIR_CENTER |
修理サービス センターによってデバイスのプロビジョニングが解除されました。 |
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 の年間ライセンスが適用されている。 |
Methods |
|
---|---|
|
ChromeOS デバイスに影響する操作を行います。 |
|
ChromeOS デバイスのプロパティを取得します。 |
|
アカウント内の ChromeOS デバイスのページ分けされたリストを取得します。 |
|
複数の ChromeOS デバイスを 1 つの組織部門に移動または挿入します。 |
|
デバイスの更新可能なプロパティ(annotatedUser 、annotatedLocation 、notes 、orgUnitPath 、annotatedAssetId など)を更新します。 |
|
デバイスの更新可能なプロパティ(annotatedUser 、annotatedLocation 、notes 、orgUnitPath 、annotatedAssetId など)を更新します。 |