Truy xuất tất cả thiết bị Chrome cho một tài khoản
Để trả về danh sách tất cả thiết bị Chrome đã chỉ định cho một tài khoản, hãy sử dụng lệnh sau
Yêu cầu GET
và bao gồm nội dung uỷ quyền được mô tả trong
Uỷ quyền cho các yêu cầu. Để dễ đọc,
mã mẫu này có trả về dòng:
GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}/ devices/chromeos?projection={BASIC|FULL}&query=query &orderBy=orderBy category&sortOrder={ASCENDING|DESCENDING} &pageToken=token for next results page, if applicable &maxResults=max number of results per page
customerId
là giá trị nhận dạng riêng biệt của Tài khoản Google của khách hàng.- Là quản trị viên tài khoản, bạn cũng có thể sử dụng chuỗi
my_customer
đại diện chocustomerId
của tài khoản. Một cách khác để tảicustomerId
là sử dụng thuộc tính Truy xuất người dùng hoạt động. Sử dụng địa chỉ email của quản trị viên hoặc người dùng duy nhất của quản trị viênid
trong tham số đường dẫnuserKey
của toán tử.
Đối với các chuỗi truy vấn, thuộc tính yêu cầu và phản hồi, hãy xem Tài liệu tham khảo API.
Ví dụ: Lọc thiết bị theo người dùng
Ví dụ này tìm kiếm một người dùng cụ thể bằng cách sử dụngquery=user:help desk
. Chiến lược phát hành đĩa đơn
phản hồi chứa một tài nguyên chromeosdevice
duy nhất, trong đó
annotatedUser
là help desk
:
Yêu cầu JSON
GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices/ chromeos?projection=FULL&query=user:help desk&orderBy=status &sortOrder=ASCENDING&maxResults=100
Nội dung phản hồi JSON
{ "kind": "directory#chromeosdevices", "chromeosdevices": [ { "kind": "directory#chromeosdevice", "etag": "1234567890" "deviceId": "def456", "serialNumber": "234567", "status": "ACTIVE", "lastSync": "2013-03-05T17:30:04.325Z", "supportEndDate": "2014-04-05T17:30:04.325Z", "annotatedUser": "help desk", "annotatedLocation": "Mountain View help desk Chromebook", "annotatedAssetId": "1234567890", "notes": "Loaned from support", "orderNumber": "1234", "willAutoRenew": true, "osVersion": "Browser Version 18.0", "platformVersion": "Platform Version 1415.2.0", "firmwareVersion": "Firmware Version 1.2.3.4", "bootMode": "validated", "lastEnrollmentTime": "2012-04-05T17:30:04.325Z", "orgUnitPath": "corp/engineering", "recentUsers": [ { "type": "USER_TYPE_MANAGED", "email": "user@customer.com" } ], "activeTimeRanges": [ { "date": "2012-04-05", "activeTime": "3600000" } ], } ], "nextPageToken": "abcdefghijkl123" }
Ví dụ: Lọc thiết bị theo số sê-ri
Ví dụ này tìm kiếm số sê-ri cụ thể bằng cách sử dụng
query=id:123456
, trong đó 123456
là
số sê-ri của thiết bị. Phản hồi hiển thị bên dưới chứa một phản hồi trùng khớp duy nhất, trong đó
Thuộc tính serialNumber
khớp với giá trị tìm kiếm.
Yêu cầu JSON
GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices/ chromeos?projection=FULL&query=id:123456&orderBy=status &sortOrder=ASCENDING&maxResults=100
Nội dung phản hồi JSON
{ "kind": "directory#chromeosdevices", "chromeosdevices": [ { "kind": "directory#chromeosdevice", "deviceId": "abc123", "serialNumber": "123456", "status": "SHIPPED", "supportEndDate": "1404457200000", "model": "model_value", "meid": "meid_value", "macAddress": "mac_address_value", "orderNumber": "1234", "willAutoRenew": true } ], "nextPageToken": "abcdefghijkl123" }
Ví dụ về phản hồi này bao gồm model
, meid
và
Thuộc tính macAddress
. Nếu một thiết bị không có các thuộc tính này, thì chúng sẽ không
được đưa vào phản hồi. Để biết toàn bộ thông tin chi tiết, hãy xem
Đại diện cho tài nguyên của Chromeosdevices.
Xuất danh sách MEID
meid
là Mã nhận dạng thiết bị di động (MEID) cho thẻ di động 3G trong
Thiết bị Chrome. MEID thường được sử dụng khi thêm thiết bị vào
gói dịch vụ trả sau. Để xuất danh sách MEID, sử dụng yêu cầu GET
sau đây và
các giá trị nextPageToken
để truy xuất danh sách MEID đầy đủ. Để dễ đọc,
mã mẫu có trả về dòng:
GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}/ devices/chromeos?fields=nextPageToken,chromeosdevices(meid)
Truy xuất thiết bị Chrome
Để truy xuất các thuộc tính của thiết bị Chrome, hãy sử dụng yêu cầu GET
sau đây và
bao gồm việc uỷ quyền được mô tả trong
Uỷ quyền cho các yêu cầu. Để dễ đọc,
mã mẫu này có trả về dòng:
GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}/ devices/chromeos/deviceId?projection={FULL|BASIC}
customerId
là giá trị nhận dạng riêng biệt của Tài khoản Google của khách hàng.- Là quản trị viên tài khoản, bạn cũng có thể sử dụng chuỗi
my_customer
đại diện chocustomerId
của tài khoản. Một cách khác để tảicustomerId
là sử dụng thuộc tính Truy xuất người dùng hoạt động. Sử dụng địa chỉ email của quản trị viên hoặc người dùng duy nhất của quản trị viênid
trong tham số đường dẫnuserKey
của toán tử. deviceId
là giá trị nhận dạng duy nhất của một thiết bị và được tìm thấy trong phản hồi của thao tác Truy xuất tất cả thiết bị Chrome.
Đối với các chuỗi truy vấn, thuộc tính yêu cầu và phản hồi, hãy xem Tài liệu tham khảo API.
Yêu cầu JSON
Một yêu cầu mẫu. Để dễ đọc, mã mẫu này có các câu trả về dòng:GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices/ chromeos/deviceId?projection=full
Nội dung phản hồi JSON
Yêu cầu thành công sẽ trả về một Mã trạng thái HTTP 200. Cùng với mã trạng thái thì phản hồi sẽ trả về các thuộc tính của thiết bị Chrome:
{ "kind": "directory#chromeosdevice", "deviceId": "device_id_value", "serialNumber": "device_serial_number", "status": "ACTIVE", "lastSync": "2012-04-05T17:30:04.325Z", "supportEndDate": "2014-04-05T17:30:04.325Z", "annotatedUser": "help desk", "annotatedLocation": "Mountain View help desk Chromebook", "annotatedAssetId": "12345667890", "notes": "Loaned from support", "orderNumber": "123456", "willAutoRenew": true, "osVersion": "Browser Version 18.0", "platformVersion": "Platform Version 1415.2.0", "firmwareVersion": "Firmware Version 1.2.3.4", "bootMode": "validated" "lastEnrollmentTime": "2012-04-05T17:30:04.325Z", "orgUnitPath": "corp/engineering" }
Cập nhật thiết bị Chrome
Để cập nhật thiết bị Chrome, hãy thực hiện yêu cầu PUT
sau đây và đưa vào
uỷ quyền được mô tả trong
Uỷ quyền cho các yêu cầu. Để dễ đọc,
mã mẫu này có trả về dòng:
PUT https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}/ devices/chromeos/deviceId?projection={FULL|BASIC}
customerId
là giá trị nhận dạng riêng biệt của Tài khoản Google của khách hàng.- Là quản trị viên tài khoản, bạn cũng có thể sử dụng chuỗi
my_customer
đại diện chocustomerId
của tài khoản. Một cách khác để tảicustomerId
là sử dụng thuộc tính Truy xuất người dùng hoạt động. Sử dụng địa chỉ email của quản trị viên hoặc người dùng duy nhất của quản trị viênid
trong tham số đường dẫnuserKey
của toán tử. deviceId
là giá trị nhận dạng duy nhất của một thiết bị và được tìm thấy trong phản hồi của thao tác Truy xuất tất cả thiết bị Chrome.
Đối với các chuỗi truy vấn, thuộc tính yêu cầu và phản hồi, hãy xem Tài liệu tham khảo API.
Yêu cầu JSON
Yêu cầu JSON trong ví dụ sau đây cập nhật annotatedUser
của thiết bị Chrome,
annotatedLocation
, annotatedAssetId
, notes
và
orgUnitPath
. Để dễ đọc, mã mẫu này có các câu trả về dòng:
PUT https://admin.googleapis.com/admin/directory/v1/customer/my_customer/ devices/chromeos/deviceId?projection=full
{
"deviceId": "device_id_value",
"annotatedUser": "help desk",
"annotatedLocation": "Mountain View help desk Chromebook",
"annotatedAssetId": "1234567890",
"notes": "Loaned from support",
"orgUnitPath": "/corp/sales"
}
Đối với yêu cầu cập nhật, bạn chỉ nên gửi những thuộc tính có giá trị được cập nhật vào yêu cầu.
Yêu cầu thành công sẽ trả về một Mã trạng thái HTTP 200. Cùng với mã trạng thái thì phản hồi sẽ trả về thuộc tính cho thiết bị Chrome đã cập nhật.
Hủy cấp phép hoặc tắt thiết bị Chrome
Để huỷ cấp phép hoặc tắt thiết bị Chrome, hãy dùng yêu cầu POST
sau
và bao gồm giấy uỷ quyền được mô tả trong
Uỷ quyền cho các yêu cầu. Để dễ đọc,
mã mẫu này có trả về dòng:
POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer or customerId/ devices/chromeos:batchChangeStatus
customerId
là giá trị nhận dạng riêng biệt của Tài khoản Google của khách hàng.- Là quản trị viên tài khoản, bạn cũng có thể sử dụng chuỗi
my_customer
đại diện chocustomerId
của tài khoản. Một cách khác để tảicustomerId
là sử dụng thuộc tính Truy xuất người dùng hoạt động. Sử dụng địa chỉ email của quản trị viên hoặc người dùng duy nhất của quản trị viênid
trong tham số đường dẫnuserKey
của toán tử.
Để biết các thuộc tính yêu cầu và phản hồi, hãy xem Tài liệu tham khảo API.
Yêu cầu JSON
Yêu cầu JSON sau đây cho thấy một yêu cầu mẫu để huỷ cấp phép và vô hiệu hoá Thiết bị Chrome:
POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/
devices/chromeos:batchChangeStatus
{ "deviceIds": ["deviceId_1", "deviceId_2", "deviceId_3"], "changeChromeOsDeviceStatusAction": "CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION", "deprovisionReason": "DEPROVISION_REASON_RETIRING_DEVICE" }
{ "deviceIds": ["deviceId_1", "deviceId_2", "deviceId_3"], "changeChromeOsDeviceStatusAction": "CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DISABLE", }
Yêu cầu thành công sẽ trả về một Mã trạng thái HTTP 200.
Di chuyển thiết bị Chrome sang đơn vị tổ chức
Để di chuyển tối đa 50 thiết bị Chrome sang một Đơn vị tổ chức, hãy sử dụng các thao tác sau
Yêu cầu POST
và bao gồm nội dung uỷ quyền được mô tả trong
Uỷ quyền cho các yêu cầu. Để dễ đọc,
mã mẫu này có trả về dòng:
POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/ devices/chromeos/moveDevicesToOu?orgUnitPath=/SomeOuName
customerId
là giá trị nhận dạng riêng biệt của Tài khoản Google của khách hàng.- Là quản trị viên tài khoản, bạn cũng có thể sử dụng chuỗi
my_customer
đại diện chocustomerId
của tài khoản. Một cách khác để tảicustomerId
là sử dụng lệnh Truy xuất người dùng. Sử dụng địa chỉ email của quản trị viên hoặc người dùng duy nhất của quản trị viên Giá trịid
trong tham số đường dẫnuserKey
của toán tử.
Để biết các thuộc tính yêu cầu và phản hồi, hãy xem Tài liệu tham khảo API.
Yêu cầu JSON
Yêu cầu JSON sau đây cho thấy một yêu cầu mẫu để di chuyển 3 thiết bị Chrome sang một
Đơn vị tổ chức có tên là /Marketing
:
POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/ devices/chromeos/chromeos/moveDevicesToOu?orgUnitPath=/Marketing
Nội dung yêu cầu cho việc di chuyển thiết bị là:
{ "deviceIds": ["deviceId_1", "deviceId_2", "deviceId_3"] }
Yêu cầu thành công sẽ trả về một Mã trạng thái HTTP 200.