Method: chromeosdevices.action

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

Chrome OS デバイスに影響を与えるアクションを実行します。これには、デバイスのデプロビジョニング、無効化、再有効化が含まれます。

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

詳しくは、OAuth 2.0 の概要をご覧ください。

Chrome OS デバイス アクション

Chrome OS デバイスの更新状況に関するデータです。

JSON 表現
{
  "action": string,
  "deprovisionReason": string
}
フィールド
action

string

Chrome OS デバイスで実行する chromeosdevices.action

指定できる値は次のとおりです。

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