REST Resource: enterprises.enrollmentTokens

Kaynak: EnrollmentToken

Kayıt jetonu.

JSON gösterimi
{
  "name": string,
  "value": string,
  "duration": string,
  "expirationTimestamp": string,
  "policyName": string,
  "additionalData": string,
  "qrCode": string,
  "oneTimeOnly": boolean,
  "user": {
    object (User)
  },
  "allowPersonalUsage": enum (AllowPersonalUsage)
}
Alanlar
name

string

Oluşturma sırasında sunucu tarafından oluşturulan kayıt jetonunun adı (enterprises/{enterpriseId}/enrollmentTokens/{enrollmentTokenId} biçiminde).

value

string

Cihaza iletilen ve cihazın kayıt yaptırması için yetki veren jeton değeri. Bu, sunucu tarafından oluşturulan salt okunur bir alandır.

duration

string (Duration format)

Kayıt jetonunun geçerlilik süresi 1 dakika ile Durations.MAX_VALUE (yaklaşık 10.000 yıl) arasındadır. Bir değer belirtilmezse varsayılan süre 1 saattir. İstenilen süre, elde edilen expirationTimestamp değerinin Timestamps.MAX_VALUE değerini aşmasına neden olursa expirationTimestamp değerinin Timestamps.MAX_VALUE değerine zorlanacağını unutmayın.

En fazla dokuz kesirli basamak içeren ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".

expirationTimestamp

string (Timestamp format)

Jetonun geçerlilik bitiş zamanı. Bu, sunucu tarafından oluşturulan salt okunur bir alandır.

Nanosaniye çözünürlüğüne sahip ve en fazla dokuz kesirli basamak içeren RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

policyName

string

Kayıtlı cihaza ilk uygulanan politikanın adı (enterprises/{enterpriseId}/policies/{policyId} biçiminde). Belirtilmezse cihazın kullanıcısı için policyName uygulanır. userName da belirtilmezse varsayılan olarak enterprises/{enterpriseId}/policies/default uygulanır. Bu alanı güncellerken, policyId eğik çizgi içermediği sürece yalnızca policyId değerini belirtebilirsiniz. Politika adının geri kalanı tahmin edilir.

additionalData

string

Kayıt jetonuyla ilişkili isteğe bağlı, rastgele veriler. Örneğin, cihazın kayıttan sonra atandığı kuruluş biriminin kimliği bu alana eklenebilir. Bir cihaz jetonla kaydolduktan sonra bu veriler Device kaynağının enrollmentTokenData alanında gösterilir. Veriler 1.024 karakterden uzun olamaz. Aksi takdirde, oluşturma isteği başarısız olur.

qrCode

string

Bir cihazı bu kayıt jetonuyla kaydettirmek üzere bir QR kodu oluşturmak için UTF-8 temsili kullanılabilecek bir JSON dizesi. NFC kullanarak cihaz kaydettirmek için NFC kaydının, JSON'daki mülkleri serileştirilmiş bir java.util.Properties temsili içermesi gerekir.

oneTimeOnly

boolean

Kayıt jetonunun yalnızca bir kez kullanılıp kullanılamayacağını belirtir. İşaretçi doğru olarak ayarlanırsa yalnızca bir cihaz kayıt için bu işaretçiyi kullanabilir.

user
(deprecated)

object (User)

Bu alanın desteği sonlandırılmıştır ve değeri yoksayılır.

allowPersonalUsage

enum (AllowPersonalUsage)

Bu kayıt jetonuyla temel hazırlığı yapılan bir cihazda kişisel kullanıma izin verilip verilmeyeceğini kontrol eder.

Şirkete ait cihazlar için:

  • Kişisel kullanımı etkinleştirmek, kullanıcının cihazda bir iş profili oluşturmasına olanak tanır.
  • Kişisel kullanımı devre dışı bırakmak için kullanıcının cihazı tümüyle yönetilen cihaz olarak temel hazırlığını yapması gerekir.

Şahıslara ait cihazlar için:

  • Kişisel kullanımı etkinleştirmek, kullanıcının cihazda bir iş profili oluşturmasına olanak tanır.
  • Kişisel kullanım devre dışı bırakılırsa cihazın temel hazırlığı yapılmaz. Kişisel kullanım, kişisel cihazlarda devre dışı bırakılamaz.

Yöntemler

create

Belirli bir kuruluş için kayıt jetonu oluşturur.

delete

Kayıt jetonunu siler.

get

Etkin ve süresi dolmamış bir kayıt jetonu alır.

list

Belirli bir kuruluşun etkin ve süresi dolmamış kayıt jetonlarını listeler.