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)

משך הזמן שאסימון הרישום תקף, מדקה אחת עד Durations.MAX_VALUE, כ-10,000 שנים. אם לא מציינים שום דבר, ברירת המחדל של משך הזמן היא שעה אחת. לתשומת ליבך: אם משך הזמן המבוקש גורם לחריגה מ-expirationTimestamp שמתקבל מ-Timestamps.MAX_VALUE, הערך של expirationTimestamp נאלץ להיות Timestamps.MAX_VALUE.

משך זמן בשניות עם עד תשע ספרות עשרוניות, המסתיים ב-'s'. דוגמה: "3.5s".
expirationTimestamp

string (Timestamp format)

מועד התפוגה של האסימון. זהו שדה לקריאה בלבד שנוצר על ידי השרת.

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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 שלה יכול לשמש ליצירת קוד QR כדי לרשום מכשיר עם אסימון הרישום הזה. כדי לרשום מכשיר באמצעות NFC, רשומת ה-NFC חייבת להכיל ייצוג java.util.Properties בהסדרה של הנכסים ב-JSON.
oneTimeOnly

boolean

אם אסימון הרישום מיועד לשימוש חד-פעמי בלבד. אם הדגל מוגדר כ-True, רק מכשיר אחד יכול להשתמש בו לרישום.
user
(deprecated)

object (User)

השדה הזה הוצא משימוש והמערכת תתעלם מהערך.
allowPersonalUsage

enum (AllowPersonalUsage)

המדיניות הזו קובעת אם השימוש האישי מותר במכשיר שהוקצה לו אסימון הרישום הזה.

למכשירים בבעלות החברה:

  • הפעלת שימוש אישי מאפשרת למשתמש להגדיר פרופיל עבודה במכשיר.
  • כדי להשבית את השימוש האישי, המשתמש צריך להקצות את המכשיר כמכשיר מנוהל באופן מלא.

למכשירים בבעלות אישית:

  • הפעלת שימוש אישי מאפשרת למשתמש להגדיר פרופיל עבודה במכשיר.
  • השבתת השימוש האישי תמנע את ניהול התצורה של המכשיר. לא ניתן להשבית שימוש אישי במכשיר בבעלות אישית.

שיטות

create

 יצירת אסימון רישום לארגון נתון.

delete

 מחיקת אסימון רישום.

get

 מקבל אסימון רישום פעיל ותקף.

list

 רשימה של אסימוני הרשמה פעילים ותקפים של ארגון נתון.