リソース: 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)または International Mobile Equipment Identity(IMEI)です。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-State は、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 のアップデートまたはサポートの提供を停止するまでのタイムスタンプ。「autoUpdateThrough」を使用してくださいしてください。 |
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 |
ファイル形式 |
screenshotFiles[].downloadUrl |
ファイルのダウンロード URL |
screenshotFiles[].createTime |
ファイルの作成日時 |
orgUnitId |
組織部門の一意の ID。orgUnitPath は、人が読める形式の orgUnitId です。orgUnitPath はパス内の組織部門の名前を変更することで変更できますが、orgUnitId は組織部門ごとに変更できません。このプロパティは、API を使用して更新できます。デバイスの組織構造を作成する方法について詳しくは、管理者向けヘルプセンターをご覧ください。 |
osUpdateStatus |
デバイスの OS アップデートのステータス。 |
firstEnrollmentTime |
デバイスが初めて登録された日時。 |
lastDeprovisionTimestamp |
(読み取り専用)デバイスが最後にデプロビジョニングされた日時。 |
deprovisionReason |
(読み取り専用)デプロビジョニングの理由。 |
deviceLicenseType |
出力専用。デバイスのライセンスの種類。 |
backlightInfo[] |
出力専用。デバイスのバックライトに関する情報が含まれています。 |
autoUpdateThrough |
出力専用。デバイスが Chrome のアップデートまたはサポートの受信を停止する時点のタイムスタンプ。 |
extendedSupportEligible |
出力専用。デバイスで拡張サポートのオプトインが必要かどうかを指定します。 |
extendedSupportStart |
出力専用。自動更新に関する拡張サポート ポリシーが開始されるデバイスの日付。 |
extendedSupportEnabled |
出力専用。デバイスで拡張サポート ポリシーが有効になっているかどうか。 |
fanInfo[] |
出力専用。デバイスのファン情報。 |
chromeOsType |
出力専用。デバイスの ChromeOS の種類。 |
OsUpdateStatus
現在の OS 更新ステータスに関する情報が含まれています。
JSON 表現 |
---|
{
"state": enum ( |
フィールド | |
---|---|
state |
OS アップデートの更新状態。 |
targetOsVersion |
ダウンロードして適用する OS イメージの新しいプラットフォーム バージョン。更新ステータスが UPDATE_STATUS_DOWNLOAD_IN_PROGRESS または UPDATE_STATUS_NEED_REBOOT の場合にのみ設定されます。これはダミーの「0.0.0.0」でもよいことに注意してください。UPDATE_STATUS_NEED_REBOOT の一部のエッジケースアップデート エンジンは再起動なしに再起動されます。 |
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 |
デバイスに年間のキオスク アップグレードが適用されている。 |
BacklightInfo
デバイスのバックライトに関する情報です。
JSON 表現 |
---|
{ "path": string, "maxBrightness": integer, "brightness": integer } |
フィールド | |
---|---|
path |
出力専用。システム上のこのバックライトのパス。呼び出し元が他の情報と相互に関連する必要がある場合に役立ちます。 |
maxBrightness |
出力専用。バックライトの最大輝度。 |
brightness |
出力専用。バックライトの現在の明るさ(0 ~ maxBrightness)。 |
FanInfo
デバイスのファンに関する情報です。
JSON 表現 |
---|
{ "speedRpm": integer } |
フィールド | |
---|---|
speedRpm |
出力専用。ファンの速度(RPM)。 |
ChromeOsType
デバイスの ChromeOS の種類。
列挙型 | |
---|---|
CHROME_OS_TYPE_UNSPECIFIED |
ChromeOS の種類が指定されていません。 |
CHROME_OS_FLEX |
ChromeOS のタイプ: ChromeOS Flex。 |
CHROME_OS |
ChromeOS タイプ: ChromeOS |
メソッド |
|
---|---|
(deprecated) |
代わりに BatchChangeChromeOsDeviceStatus を使用してください。 |
|
ChromeOS デバイスのプロパティを取得します。 |
|
アカウント内の ChromeOS デバイスのページ分けされたリストを取得します。 |
|
複数の ChromeOS デバイスを組織部門に移動または挿入できます。 |
|
デバイスの更新可能なプロパティ(annotatedUser 、annotatedLocation 、notes 、orgUnitPath 、annotatedAssetId など)を更新します。 |
|
デバイスの更新可能なプロパティ(annotatedUser 、annotatedLocation 、notes 、orgUnitPath 、annotatedAssetId など)を更新します。 |