ดึงข้อมูลอุปกรณ์ Chrome ทั้งหมดสำหรับบัญชี
หากต้องการแสดงรายการอุปกรณ์ Chrome ทั้งหมดที่มอบหมายให้กับบัญชี ให้ใช้คำขอ GET
ต่อไปนี้และรวมการให้สิทธิ์ที่อธิบายไว้ในคำขอสิทธิ์ ตัวอย่างโค้ดนี้มีการขึ้นบรรทัดใหม่เพื่อให้ง่ายต่อการอ่านทำความเข้าใจ
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
คือตัวระบุที่ไม่ซ้ำกันสำหรับบัญชี Google ของลูกค้า- ในฐานะผู้ดูแลระบบบัญชี คุณยังใช้สตริง
my_customer
ที่แสดงถึงcustomerId
ของบัญชีได้ด้วย อีกวิธีหนึ่งในการรับค่าcustomerId
คือการใช้การดำเนินการเรียกข้อมูลผู้ใช้ ใช้อีเมลของผู้ดูแลระบบหรือค่าid
ของผู้ใช้ที่ไม่ซ้ำของผู้ดูแลระบบในพารามิเตอร์เส้นทางuserKey
ของการดำเนินการ
สำหรับพร็อพเพอร์ตี้ของสตริงการค้นหา คำขอ และการตอบกลับ โปรดดูข้อมูลอ้างอิง API
ตัวอย่าง: กรองอุปกรณ์ตามผู้ใช้
ตัวอย่างนี้จะค้นหาผู้ใช้ที่เจาะจงโดยใช้query=user:help desk
การตอบกลับมีทรัพยากร chromeosdevice
รายการเดียว โดยที่ annotatedUser
คือ help desk
คำขอ 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
การตอบสนองของ 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" }
ตัวอย่าง: กรองอุปกรณ์ตามหมายเลขซีเรียล
ตัวอย่างนี้ค้นหาหมายเลขซีเรียลโดยใช้ query=id:123456
โดยที่ 123456
คือหมายเลขซีเรียลของอุปกรณ์ คําตอบที่แสดงด้านล่างมีการตอบกลับที่ตรงกันรายการเดียว ซึ่งพร็อพเพอร์ตี้ serialNumber
ตรงกับค่าการค้นหา
คำขอ 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
การตอบสนองของ 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" }
ตัวอย่างการตอบกลับนี้มีพร็อพเพอร์ตี้ model
, meid
และ macAddress
หากอุปกรณ์ไม่มีพร็อพเพอร์ตี้เหล่านี้ ก็จะไม่รวมอยู่ในคำตอบ ดูรายละเอียดทั้งหมดได้ที่การแสดงทรัพยากร ChromeOS
ส่งออกรายการ MEID
meid
คือ Mobile Device Identifier (MEID) สำหรับการ์ดของอุปกรณ์เคลื่อนที่ 3G ในอุปกรณ์ Chrome โดยทั่วไปแล้ว MEID จะใช้เมื่อเพิ่มอุปกรณ์ในแพ็กเกจการชำระเงินภายหลังของผู้ให้บริการระบบไร้สาย หากต้องการส่งออกรายการ MEID ให้ใช้คำขอ GET
ต่อไปนี้และค่า nextPageToken
เพื่อเรียกข้อมูลรายการ MEID ทั้งหมด ตัวอย่างโค้ดนี้มีการขึ้นบรรทัดใหม่เพื่อให้ง่ายต่อการอ่านทำความเข้าใจ
GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}/ devices/chromeos?fields=nextPageToken,chromeosdevices(meid)
ดึงข้อมูลอุปกรณ์ Chrome
หากต้องการเรียกดูพร็อพเพอร์ตี้ของอุปกรณ์ Chrome ให้ใช้คำขอ GET
ต่อไปนี้และรวมการให้สิทธิ์ที่อธิบายไว้ในคำขอสิทธิ์ ตัวอย่างโค้ดนี้มีการขึ้นบรรทัดใหม่เพื่อให้ง่ายต่อการอ่านทำความเข้าใจ
GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}/ devices/chromeos/deviceId?projection={FULL|BASIC}
customerId
คือตัวระบุที่ไม่ซ้ำกันสำหรับบัญชี Google ของลูกค้า- ในฐานะผู้ดูแลระบบบัญชี คุณยังใช้สตริง
my_customer
ที่แสดงถึงcustomerId
ของบัญชีได้ด้วย อีกวิธีหนึ่งในการรับค่าcustomerId
คือการใช้การดำเนินการเรียกข้อมูลผู้ใช้ ใช้อีเมลของผู้ดูแลระบบหรือค่าid
ของผู้ใช้ที่ไม่ซ้ำของผู้ดูแลระบบในพารามิเตอร์เส้นทางuserKey
ของการดำเนินการ deviceId
เป็นตัวระบุที่ไม่ซ้ำกันสำหรับอุปกรณ์และจะอยู่ในการตอบสนองของการดำเนินการเรียกข้อมูลอุปกรณ์ Chrome ทั้งหมด
สำหรับพร็อพเพอร์ตี้ของสตริงการค้นหา คำขอ และการตอบกลับ โปรดดูข้อมูลอ้างอิง API
คำขอ JSON
ตัวอย่างคำขอ ตัวอย่างโค้ดนี้มีการขึ้นบรรทัดใหม่เพื่อให้ง่ายต่อการอ่านGET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices/ chromeos/deviceId?projection=full
การตอบสนองของ JSON
คำขอที่สำเร็จจะแสดงรหัสสถานะ HTTP 200 นอกจากรหัสสถานะแล้ว การตอบกลับจะแสดงพร็อพเพอร์ตี้ของอุปกรณ์ 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" }
อัปเดตอุปกรณ์ Chrome
หากต้องการอัปเดตอุปกรณ์ Chrome ให้ใช้คำขอ PUT
ต่อไปนี้และรวมการให้สิทธิ์ที่อธิบายไว้ในคำขอสิทธิ์ ตัวอย่างโค้ดนี้มีการขึ้นบรรทัดใหม่เพื่อให้ง่ายต่อการอ่านทำความเข้าใจ
PUT https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}/ devices/chromeos/deviceId?projection={FULL|BASIC}
customerId
คือตัวระบุที่ไม่ซ้ำกันสำหรับบัญชี Google ของลูกค้า- ในฐานะผู้ดูแลระบบบัญชี คุณยังใช้สตริง
my_customer
ที่แสดงถึงcustomerId
ของบัญชีได้ด้วย อีกวิธีหนึ่งในการรับค่าcustomerId
คือการใช้การดำเนินการเรียกข้อมูลผู้ใช้ ใช้อีเมลของผู้ดูแลระบบหรือค่าid
ของผู้ใช้ที่ไม่ซ้ำของผู้ดูแลระบบในพารามิเตอร์เส้นทางuserKey
ของการดำเนินการ deviceId
เป็นตัวระบุที่ไม่ซ้ำกันสำหรับอุปกรณ์และจะอยู่ในการตอบสนองของการดำเนินการเรียกข้อมูลอุปกรณ์ Chrome ทั้งหมด
สำหรับพร็อพเพอร์ตี้ของสตริงการค้นหา คำขอ และการตอบกลับ โปรดดูข้อมูลอ้างอิง API
คำขอ JSON
ตัวอย่างคำขอ JSON ต่อไปนี้อัปเดตพร็อพเพอร์ตี้ annotatedUser
, annotatedLocation
, annotatedAssetId
, notes
และ orgUnitPath
ของอุปกรณ์ Chrome ตัวอย่างโค้ดนี้มีการขึ้นบรรทัดใหม่เพื่อให้ง่ายต่อการอ่านทำความเข้าใจ
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"
}
สำหรับคำขออัปเดต ให้รวมเฉพาะพร็อพเพอร์ตี้ที่มีค่าที่อัปเดตในคำขอ
คำขอที่สำเร็จจะแสดงรหัสสถานะ HTTP 200 นอกจากรหัสสถานะแล้ว การตอบกลับจะแสดงพร็อพเพอร์ตี้สำหรับอุปกรณ์ Chrome ที่อัปเดต
การยกเลิกการจัดสรรหรือการปิดใช้อุปกรณ์ Chrome
หากต้องการยกเลิกการจัดสรรหรือปิดใช้อุปกรณ์ Chrome ให้ใช้คำขอ POST
ต่อไปนี้และรวมการให้สิทธิ์ที่อธิบายไว้ในคำขอสิทธิ์ ตัวอย่างโค้ดนี้มีการขึ้นบรรทัดใหม่เพื่อให้ง่ายต่อการอ่านทำความเข้าใจ
POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer or customerId/ devices/chromeos:batchChangeStatus
customerId
คือตัวระบุที่ไม่ซ้ำกันสำหรับบัญชี Google ของลูกค้า- ในฐานะผู้ดูแลระบบบัญชี คุณยังใช้สตริง
my_customer
ที่แสดงถึงcustomerId
ของบัญชีได้ด้วย อีกวิธีหนึ่งในการรับค่าcustomerId
คือการใช้การดำเนินการเรียกข้อมูลผู้ใช้ ใช้อีเมลของผู้ดูแลระบบหรือค่าid
ของผู้ใช้ที่ไม่ซ้ำของผู้ดูแลระบบในพารามิเตอร์เส้นทางuserKey
ของการดำเนินการ
สำหรับพร็อพเพอร์ตี้คำขอและการตอบกลับ โปรดดูข้อมูลอ้างอิง API
คำขอ JSON
คำขอ JSON ต่อไปนี้แสดงตัวอย่างคำขอยกเลิกการจัดสรรและปิดใช้อุปกรณ์ 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", }
คำขอที่สำเร็จจะแสดงรหัสสถานะ HTTP 200
ย้ายอุปกรณ์ Chrome ไปยังหน่วยขององค์กร
หากต้องการย้ายอุปกรณ์ Chrome ไปยังหน่วยขององค์กรสูงสุด 50 เครื่อง ให้ใช้คำขอ POST
ต่อไปนี้และรวมการให้สิทธิ์ที่อธิบายไว้ในคำขอสิทธิ์ ตัวอย่างโค้ดนี้มีการขึ้นบรรทัดใหม่เพื่อให้ง่ายต่อการอ่านทำความเข้าใจ
POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/ devices/chromeos/moveDevicesToOu?orgUnitPath=/SomeOuName
customerId
คือตัวระบุที่ไม่ซ้ำกันสำหรับบัญชี Google ของลูกค้า- ในฐานะผู้ดูแลระบบบัญชี คุณยังใช้สตริง
my_customer
ที่แสดงถึงcustomerId
ของบัญชีได้ด้วย อีกวิธีหนึ่งในการรับค่าcustomerId
คือการใช้การดำเนินการเรียกข้อมูลผู้ใช้ ใช้อีเมลของผู้ดูแลระบบหรือค่าid
ของผู้ใช้ที่ไม่ซ้ำของผู้ดูแลระบบในพารามิเตอร์เส้นทางuserKey
ของการดำเนินการ
สำหรับพร็อพเพอร์ตี้คำขอและการตอบกลับ โปรดดูข้อมูลอ้างอิง API
คำขอ JSON
คำขอ JSON ต่อไปนี้แสดงตัวอย่างคำขอย้ายอุปกรณ์ Chrome 3 เครื่องไปยังหน่วยขององค์กรชื่อ /Marketing
POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/ devices/chromeos/chromeos/moveDevicesToOu?orgUnitPath=/Marketing
เนื้อหาคำขอสำหรับการย้ายอุปกรณ์คือ
{ "deviceIds": ["deviceId_1", "deviceId_2", "deviceId_3"] }
คำขอที่สำเร็จจะแสดงรหัสสถานะ HTTP 200