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 ChromeOS デバイスでの chromeosdevices.action 有効な値は次のとおりです。 deprovision: 有効でなくなったデバイス、再販中のデバイス、または返却 / 修理の依頼を送信しようとしているデバイスを管理対象から削除します。デプロビジョニング操作を使用して、このデバイスの管理対象を解除します。 disable: 組織内のデバイスの紛失または盗難が疑われる場合は、デバイスを無効にして、第三者が使用できないようにすることができます。デバイスを無効にした場合、Chrome デバイスをオンにしたときにユーザーには、無効であることを示す画面と、デバイスの返却先に関するお客様の連絡先情報が表示されます。 注: 無効になっているデバイスにメッセージが表示されるようにするには、管理コンソールで設定を完了する必要があります。 reenable: 置き忘れたデバイスが見つかった場合や、紛失したデバイスが返却された場合に、無効にしたデバイスを再有効化します。この機能は、誤って Chrome デバイスを無効としてマークした場合にも使用できます。 注: 再有効化の操作は、無効としてマークされたデバイスでのみ実行できます。 pre_provisioned_disable: 登録できない事前プロビジョニング済みデバイス。管理者はデバイスを再度有効にして、ステータスを「pre_provisioned_reenable」に変更することで、ゼロタッチ登録を許可できます。注: この状態から、デバイスのプロビジョニングを解除できます。 pre_provisioned_reenable: デバイスは OEM によって事前にプロビジョニングされています。この状態のデバイスは、ゼロタッチ登録の対象です。
deprovisionReason	string アクションをデプロビジョニングする場合にのみ使用されます。デプロビジョニング アクションでは、このフィールドは必須です。 注: 永久サブスクリプションをご利用のお客様のライセンスに影響する可能性があるため、デプロビジョニングの理由は監査されます。 有効な値は次のとおりです。 different_model_replacement: デバイスを同じデバイスの新しいモデルにアップグレードまたは交換する場合に使用します。 retiring_device: デバイスを再販、寄付、または完全に削除する場合に使用します。 same_model_replacement: デバイスでハードウェアの問題が発生し、修理ベンダー / メーカーによる同じモデルまたは類似したモデルの交換に交換される場合に使用します。 upgrade_transfer: 1 年以内にクラウド対応デバイスを Chromebook に交換する場合に使用します。