Method: customer.devices.chromeos.batchChangeStatus

وضعیت دسته ای از دستگاه های ChromeOS را تغییر می دهد. برای اطلاعات بیشتر در مورد تغییر وضعیت دستگاه ChromeOS دستگاه‌های ChromeOS را تعمیر، استفاده مجدد یا بازنشست کنید .

درخواست HTTP

POST https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos:batchChangeStatus

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
customerId

string

ضروری. شناسه غیرقابل تغییر حساب Google Workspace.

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "deviceIds": [
    string
  ],
  "changeChromeOsDeviceStatusAction": enum (ChangeChromeOsDeviceStatusAction),
  "deprovisionReason": enum (DeprovisionReason)
}
زمینه های
deviceIds[]

string

ضروری. فهرست شناسه‌های دستگاه‌های ChromeOS برای تغییر. حداکثر 50.

changeChromeOsDeviceStatusAction

enum ( ChangeChromeOsDeviceStatusAction )

ضروری. اقدامی که باید در دستگاه ChromeOS به منظور تغییر وضعیت آن انجام شود.

deprovisionReason

enum ( DeprovisionReason )

اختیاری. دلیل عدم ارائه دستگاه اگر «changeChromeOsDeviceStatusAction» روی «CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION» تنظیم شده باشد، باید ارائه شود. در غیر این صورت این قسمت را حذف کنید.

بدن پاسخگو

پاسخ تغییر وضعیت دسته ای از دستگاه های ChromeOS.

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "changeChromeOsDeviceStatusResults": [
    {
      object (ChangeChromeOsDeviceStatusResult)
    }
  ]
}
زمینه های
changeChromeOsDeviceStatusResults[]

object ( ChangeChromeOsDeviceStatusResult )

نتایج برای هر یک از دستگاه‌های ChromeOS ارائه شده در درخواست.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/admin.directory.device.chromeos

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.

ChangeChromeOsDeviceStatusAction

اقدامی که باید برای تغییر وضعیت دستگاه ChromeOS انجام شود.

Enums
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_UNSPECIFIED مقدار پیش فرض. ارزش استفاده نشده است
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION یک دستگاه ChromeOS را لغو می کند. اگر دستگاه‌های ChromeOS دارید که دیگر در سازمان شما مورد استفاده قرار نمی‌گیرند، باید آن‌ها را حذف کنید تا دیگر آنها را مدیریت نکنید. عدم ارائه دستگاه، همه خط‌مشی‌های موجود در دستگاه و همچنین چاپگرهای سطح دستگاه و امکان استفاده از دستگاه به‌عنوان کیوسک را حذف می‌کند. بسته به ارتقای مرتبط با دستگاه، این عمل ممکن است مجوز را دوباره به مجموعه مجوزها بازگرداند. که به شما امکان می دهد از مجوز در دستگاه دیگری استفاده کنید.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DISABLE دستگاه ChromeOS را غیرفعال می کند. اگر کاربر دستگاه خود را گم کرد یا به سرقت رفت، از این عمل استفاده کنید، این باعث می‌شود دستگاه همچنان مدیریت شود، بنابراین همچنان خط‌مشی‌ها را دریافت می‌کند، اما هیچ‌کس نمی‌تواند از آن استفاده کند. بسته به ارتقای مرتبط با دستگاه، این عمل ممکن است مجوز را دوباره به مجموعه مجوزها بازگرداند. که به شما امکان می دهد از مجوز در دستگاه دیگری استفاده کنید.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_REENABLE دستگاه ChromeOS را دوباره فعال می کند تا پس از غیرفعال شدن استفاده شود. وقتی دستگاه دیگر گم نشد یا بازیابی شد دوباره آن را فعال می کند. این اجازه می دهد تا دستگاه دوباره استفاده شود. بسته به ارتقای مرتبط با دستگاه، ممکن است یک مجوز از مجموعه مجوزها مصرف شود، به این معنی که اگر مجوزهای کافی موجود نباشد، عملیات با شکست مواجه خواهد شد.

ChangeChromeOsDeviceStatusResult

نتیجه یک دستگاه ChromeOS واحد برای عملیات تغییر وضعیت.

نمایندگی JSON
{
  "deviceId": string,

  // Union field result can be only one of the following:
  "error": {
    object (Status)
  },
  "response": {
    object (ChangeChromeOsDeviceStatusSucceeded)
  }
  // End of list of possible types for union field result.
}
زمینه های
deviceId

string

شناسه منحصر به فرد دستگاه ChromeOS.

result میدان اتحادیه

result می تواند تنها یکی از موارد زیر باشد:

error

object ( Status )

نتیجه خطای عملیات در صورت خرابی.

response

object ( ChangeChromeOsDeviceStatusSucceeded )

دستگاه می تواند وضعیت خود را با موفقیت تغییر دهد.

وضعیت

نوع Status یک مدل خطای منطقی را تعریف می کند که برای محیط های برنامه نویسی مختلف، از جمله REST API و RPC API مناسب است. توسط gRPC استفاده می شود. هر پیام Status شامل سه داده است: کد خطا، پیام خطا و جزئیات خطا.

در راهنمای طراحی API می‌توانید درباره این مدل خطا و نحوه کار با آن اطلاعات بیشتری کسب کنید.

نمایندگی JSON
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
زمینه های
code

integer

کد وضعیت، که باید مقداری از google.rpc.Code باشد.

message

string

یک پیغام خطای برنامه‌نویس، که باید به زبان انگلیسی باشد. هر پیام خطای کاربر باید بومی سازی شده و در قسمت google.rpc.Status.details ارسال شود یا توسط مشتری بومی سازی شود.

details[]

object

لیستی از پیام هایی که حاوی جزئیات خطا هستند. مجموعه ای متداول از انواع پیام ها برای استفاده API ها وجود دارد.

یک شی حاوی فیلدهایی از نوع دلخواه. یک فیلد اضافی "@type" حاوی یک URI است که نوع را مشخص می کند. مثال: { "id": 1234, "@type": "types.example.com/standard/id" } .

ChangeChromeOsDeviceStatusSucceeded

این نوع هیچ فیلدی ندارد.

پاسخی برای تغییر وضعیت دستگاه ChromeOS با موفقیت.