Method: chromeosdevices.action
代わりに BatchChangeChromeOsDeviceStatus を使用してください。ChromeOS デバイスに影響するアクションを実行します。これには、デバイスのプロビジョニング解除、無効化、再有効化が含まれます。
警告:
デバイスをデプロビジョニングすると、デバイス ポリシーの同期が停止し、デバイスレベルのプリンタが削除されます。デバイスのプロビジョニングを解除すると、再登録する前にデバイスをワイプする必要があります。
紛失または盗難にあったデバイスの場合は、無効化アクションを使用する必要があります。
無効にしたデバイスを再有効化すると、デバイスのライセンスが消費されます。再有効化アクションを完了する際に使用可能なライセンスが不足している場合は、エラーが表示されます。 デバイスのデプロビジョニングと無効化について詳しくは、ヘルプセンター をご覧ください。
HTTP リクエスト
POST https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos/{resourceId}/action
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ
customerId
string
お客様の Google Workspace アカウントの一意の ID。アカウント管理者は、my_customer
エイリアスを使用してアカウントの customerId
を表すこともできます。customerId
も Users リソース の一部として返されます。
resourceId
string
デバイスの一意の ID です。resourceId
は、chromeosdevices.list メソッドからのレスポンスで返されます。
リクエスト本文
リクエストの本文には ChromeOsDeviceAction
のインスタンスが含まれます。
レスポンスの本文
成功した場合、レスポンスはメソッドによって定義された形式の汎用 HTTP レスポンスになります。
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/admin.directory.device.chromeos
詳細については、承認ガイド をご覧ください。
ChromeOsDeviceAction
ChromeOS デバイスのステータス更新に関するデータ。
JSON 表現
{
"action" : string ,
"deprovisionReason" : string
}
フィールド
action
string
chromeosdevices.action: ChromeOS デバイスで実行するアクション。
有効な値は次のとおりです。
deprovision
: デバイスを使わなくなったか売却する場合、あるいは返却するか修理に送る場合に、デバイスを管理の対象から削除するには、プロビジョニング解除アクションを使用して管理から切断します。
disable
: 組織のデバイスが紛失したか盗難にあった場合は、他で使用されないようデバイスを無効にできます。無効にした Chrome 搭載デバイスがその後起動されたときには、デバイスが無効になったことを示すメッセージと、デバイスの返却先として管理者が指定した連絡先情報が表示されます。注 : 無効にしたデバイスに表示するメッセージの設定は、管理コンソールで行う必要があります。
reenable
: 紛失したデバイスが見つかったか戻ってきた場合、無効にしたデバイスを再度有効化できます。Chrome 搭載デバイスを誤って無効にした場合もこの機能を使用できます。注 : 再有効化は、無効としてマークされたデバイスでのみ行えます。
pre_provisioned_disable
: 登録できない事前プロビジョニング済みデバイス。管理者はステータスを「pre_provision_reenable」に変更することで、ゼロタッチ登録を許可するためにデバイスを再度有効にすることができます。注 : この状態からデバイスをデプロビジョニングできます。
pre_provisioned_reenable
: デバイスは OEM によって事前にプロビジョニングされています。この状態のデバイスはゼロタッチ登録の対象となります。
deprovisionReason
string
アクションがプロビジョニング解除の場合にのみ使用されます。プロビジョニング解除アクションでは、このフィールドは必須です。
注 : 永続サブスクリプションのお客様のライセンスに影響する可能性があるため、プロビジョニング解除の理由は監査されます。
有効な値は次のとおりです。
different_model_replacement
: デバイスをアップグレードする場合や、同じデバイスの新しいモデルに交換する場合に使用します。
retiring_device
: デバイスを売却する、寄付する、または今後一切使用しない場合に使用します。
same_model_replacement
: デバイスでハードウェアの問題が発生し、修理ベンダー / メーカーによる同じモデルまたは類似モデルとの交換を行う場合に使用します。
upgrade_transfer
: クラウド対応デバイスを 1 年以内に Chromebook に交換する場合に使用します。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンス により使用許諾されます。コードサンプルは Apache 2.0 ライセンス により使用許諾されます。詳しくは、Google Developers サイトのポリシー をご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2024-11-09 UTC。
[null,null,["最終更新日 2024-11-09 UTC。"],[[["This API (`customer.devices.chromeos/action`) is deprecated and `BatchChangeChromeOsDeviceStatus` should be used instead."],["It allows administrators to manage the status of Chrome OS devices, including deprovisioning, disabling, and re-enabling."],["Deprovisioning removes device management, disabling prevents usage (ideal for lost/stolen devices), and re-enabling restores device access."],["Before re-enrollment, deprovisioned devices require wiping, and re-enabling a device consumes a device license."]]],[]]