REST Resource: enterprises.enrollmentTokens

ทรัพยากร: EnrollmentToken

โทเค็นการลงทะเบียน

การแสดง JSON 
{
  "name": string,
  "value": string,
  "duration": string,
  "expirationTimestamp": string,
  "policyName": string,
  "additionalData": string,
  "qrCode": string,
  "oneTimeOnly": boolean,
  "user": {
    object (User)
  },
  "allowPersonalUsage": enum (AllowPersonalUsage)
}
ช่อง
name

string

ชื่อของโทเค็นการลงทะเบียนซึ่งเซิร์ฟเวอร์สร้างขึ้นระหว่างการสร้างในรูปแบบ enterprises/{enterpriseId}/enrollmentTokens/{enrollmentTokenId}
value

string

ค่าโทเค็นที่ส่งไปยังอุปกรณ์และอนุญาตให้อุปกรณ์ลงทะเบียน นี่คือฟิลด์แบบอ่านอย่างเดียวที่เซิร์ฟเวอร์สร้างขึ้น
duration

string (Duration format)

ระยะเวลาที่โทเค็นการลงทะเบียนใช้งานได้ ซึ่งอยู่ในช่วง 1 นาทีถึง Durations.MAX_VALUE หรือประมาณ 10,000 ปี หากไม่ได้ระบุไว้ ระยะเวลาเริ่มต้นจะเป็น 1 ชั่วโมง โปรดทราบว่าหากระยะเวลาที่ขอทําให้ expirationTimestamp ที่ได้ผลลัพธ์เกิน Timestamps.MAX_VALUE ระบบจะบังคับให้ expirationTimestamp เป็น Timestamps.MAX_VALUE

ระยะเวลาเป็นวินาทีที่มีเศษทศนิยมได้สูงสุด 9 หลัก โดยลงท้ายด้วย "s" เช่น "3.5s"
expirationTimestamp

string (Timestamp format)

เวลาหมดอายุของโทเค็น ฟิลด์นี้เป็นฟิลด์แบบอ่านอย่างเดียวที่เซิร์ฟเวอร์สร้างขึ้น

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
policyName

string

ชื่อของนโยบายที่นำไปใช้กับอุปกรณ์ที่ลงทะเบียนในตอนแรกในรูปแบบ enterprises/{enterpriseId}/policies/{policyId} หากไม่ได้ระบุ ระบบจะใช้ policyName ของผู้ใช้อุปกรณ์ หากไม่ได้ระบุ userName ด้วย ระบบจะใช้ enterprises/{enterpriseId}/policies/default โดยค่าเริ่มต้น เมื่ออัปเดตช่องนี้ คุณจะระบุได้เฉพาะ policyId ตราบใดที่ policyId นั้นไม่มีเครื่องหมายทับ ชื่อนโยบายส่วนที่เหลือจะได้รับการอนุมาน
additionalData

string

ข้อมูลที่กําหนดเองที่ไม่บังคับซึ่งเชื่อมโยงกับโทเค็นการลงทะเบียน ข้อมูลนี้อาจมี เช่น รหัสของหน่วยขององค์กรที่มอบหมายอุปกรณ์ให้หลังการลงทะเบียน หลังจากที่อุปกรณ์ลงทะเบียนด้วยโทเค็น ข้อมูลนี้จะแสดงในช่อง enrollmentTokenData ของทรัพยากร Device ข้อมูลต้องมีอักขระไม่เกิน 1, 024 ตัว มิฉะนั้นคำขอสร้างจะล้มเหลว
qrCode

string

สตริง JSON ที่มีการแสดงแบบ UTF-8 เพื่อสร้างคิวอาร์โค้ดเพื่อลงทะเบียนอุปกรณ์ด้วยโทเค็นการลงทะเบียนนี้ได้ หากต้องการลงทะเบียนอุปกรณ์โดยใช้ NFC ระเบียน NFC ต้องมีการแสดงแทน java.util.Properties ที่แปลงเป็นอนุกรมของพร็อพเพอร์ตี้ใน JSON
oneTimeOnly

boolean

โทเค็นการลงทะเบียนใช้ได้เพียงครั้งเดียวเท่านั้นหรือไม่ หากตั้งค่า Flag เป็น "จริง" จะมีเพียงอุปกรณ์เดียวเท่านั้นที่ใช้ Flag ดังกล่าวในการลงทะเบียนได้
user
(deprecated)

object (User)

ช่องนี้เลิกใช้งานแล้วและจะไม่มีการสนใจค่าดังกล่าว
allowPersonalUsage

enum (AllowPersonalUsage)

ควบคุมว่าจะอนุญาตให้ใช้งานส่วนตัวในอุปกรณ์ที่จัดสรรด้วยโทเค็นการลงทะเบียนนี้หรือไม่

สำหรับอุปกรณ์ของบริษัท ให้ทำดังนี้

  • การเปิดใช้การใช้งานส่วนตัวช่วยให้ผู้ใช้ตั้งค่าโปรไฟล์งานในอุปกรณ์ได้
  • การปิดใช้การใช้งานส่วนตัวกำหนดให้ผู้ใช้จัดสรรอุปกรณ์เป็นอุปกรณ์ที่มีการจัดการครบวงจร

สำหรับอุปกรณ์ส่วนตัว

  • การเปิดใช้การใช้งานส่วนตัวจะช่วยให้ผู้ใช้ตั้งค่าโปรไฟล์งานในอุปกรณ์ได้
  • การปิดใช้การใช้งานส่วนตัวจะทำให้อุปกรณ์ไม่สามารถจัดสรรได้ ปิดใช้งานการใช้งานส่วนตัวในอุปกรณ์ส่วนตัวไม่ได้

เมธอด

create

 สร้างโทเค็นการลงทะเบียนสําหรับองค์กรหนึ่งๆ

delete

 ลบโทเค็นการลงทะเบียน

get

 รับโทเค็นการลงทะเบียนที่ใช้งานอยู่และยังไม่หมดอายุ

list

 แสดงรายการโทเค็นการลงทะเบียนที่ใช้งานอยู่และยังไม่หมดอายุขององค์กรหนึ่งๆ