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 に交換する場合に使用します。