API โทเค็นการลงทะเบียนการจัดการ Chrome ช่วยให้ผู้ดูแลระบบจัดการ โทเค็นการลงทะเบียนที่ใช้ในการลงทะเบียนเบราว์เซอร์ Chrome ใน Chrome Enterprise Core ได้ ชุด API นี้ใช้เพื่อสร้าง เรียกข้อมูล แสดงรายการ และเพิกถอนโทเค็นการลงทะเบียน สำหรับอุปกรณ์ได้
ภาพรวมโดยย่อของเมธอด API
URL จะสัมพันธ์กับ
https://chromemanagement.googleapis.com/v1/customers/{customer_id}
| คำอธิบาย | Relative URL | เมธอด HTTP |
|---|---|---|
| สร้างโทเค็นการลงทะเบียน | /enrollmentTokens | POST |
| เรียกข้อมูลโทเค็นการลงทะเบียน | /enrollmentTokens/{token_permanent_id} | รับ |
| แสดงรายการโทเค็นการลงทะเบียน | /enrollmentTokens | รับ |
| เพิกถอนโทเค็นการลงทะเบียน | /enrollmentTokens/{token_permanent_id}:revoke | POST |
ดูตัวอย่างโค้ดสำหรับ คำขอและการตอบกลับตัวอย่าง
กำลังกรองผลการค้นหา
เมื่อแสดงโทเค็นการลงทะเบียนด้วยเมธอด
/enrollmentTokens
คุณจะจำกัดผลลัพธ์ให้แคบลงได้โดยใช้พารามิเตอร์การค้นหา filter พารามิเตอร์ตัวกรองทั้งหมดต้องมีการหลีก URL เมื่อส่งในคำขอ HTTP คุณรวมเงื่อนไขหลายรายการได้โดยใช้โอเปอเรเตอร์ AND
- ฟิลด์ String และ Enum: รองรับตัวดำเนินการเปรียบเทียบ
=และ: - การกรองหน่วยขององค์กร: คุณสามารถกรองโทเค็นที่สร้างขึ้นสำหรับ
หน่วยขององค์กรที่เฉพาะเจาะจงได้โดยระบุ
org_unit_pathหรือorg_unit_id
ฟิลด์ที่กรองได้
| ช่อง | คำอธิบาย |
|---|---|
device_type
|
ประเภทอุปกรณ์ที่ใช้โทเค็นการลงทะเบียน
(ปัจจุบันคือ CHROME_BROWSER) |
token_state
|
สถานะของโทเค็นการลงทะเบียน (ACTIVE, EXPIRED,
REVOKED) |
org_unit_path
|
เส้นทางหน่วยขององค์กรสำหรับโทเค็นการลงทะเบียน
(เช่น /Marketing) |
org_unit_id
|
รหัสหน่วยขององค์กรที่ปิดบังไว้สำหรับโทเค็นการลงทะเบียน |
สิทธิ์ของผู้ดูแลระบบ
API โทเค็นการลงทะเบียนการจัดการ Chrome จะเป็นไปตามการมอบหมายบทบาทผู้ดูแลระบบ
| วิธีการ | ต้องมีสิทธิ์ของผู้ดูแลระบบ |
|---|---|
| CreateEnrollmentToken | "บริการ -> การจัดการ Chrome -> การตั้งค่า -> เบราว์เซอร์ที่มีการจัดการ" |
| GetEnrollmentToken | "บริการ -> การจัดการ Chrome -> การตั้งค่า ->
เบราว์เซอร์ที่มีการจัดการ" หรือ "บริการ -> การจัดการ Chrome -> การตั้งค่า -> เบราว์เซอร์ที่มีการจัดการ -> อ่าน" |
| ListEnrollmentTokens | "บริการ -> การจัดการ Chrome -> การตั้งค่า ->
เบราว์เซอร์ที่มีการจัดการ" หรือ "บริการ -> การจัดการ Chrome -> การตั้งค่า -> เบราว์เซอร์ที่มีการจัดการ -> อ่าน" |
| RevokeEnrollmentToken | "บริการ -> การจัดการ Chrome -> การตั้งค่า -> เบราว์เซอร์ที่มีการจัดการ" |
หากต้องการจัดการบทบาทและสิทธิ์ของผู้ดูแลระบบ ให้ไปที่ "คอนโซลผู้ดูแลระบบ -> บทบาทผู้ดูแลระบบ"
ขอบเขต API
API โทเค็นการลงทะเบียนการจัดการ Chrome ต้องใช้ขอบเขต OAuth ต่อไปนี้
| วิธีการ | ขอบเขต OAuth ที่จำเป็น |
|---|---|
| CreateEnrollmentToken | https://www.googleapis.com/auth/chrome.management.enrollmenttokens |
| GetEnrollmentToken | https://www.googleapis.com/auth/chrome.management.enrollmenttokens หรือ https://www.googleapis.com/auth/chrome.management.enrollmenttokens.readonly |
| ListEnrollmentTokens | https://www.googleapis.com/auth/chrome.management.enrollmenttokens หรือ https://www.googleapis.com/auth/chrome.management.enrollmenttokens.readonly |
| RevokeEnrollmentToken | https://www.googleapis.com/auth/chrome.management.enrollmenttokens |
ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมการตรวจสอบสิทธิ์