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ı kaydetme yetkisi 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 ve en fazla dokuz kesirli basamağa sahip, 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, bu değerde cihazın kayıttan sonra atandığı kuruluş biriminin kimliği bulunabilir. Bir cihaz jetonla kaydolduktan sonra bu veriler Device kaynağının enrollmentTokenData alanında gösterilir. Veriler 1.024 karakterden uzun olmamalıdır. Aksi takdirde, oluşturma isteği başarısız olur.

qrCode

string

UTF-8 gösterimi, bir cihazı bu kayıt jetonuyla kaydettirmek için QR kodu oluşturmak üzere kullanılabilen bir JSON dizesi. NFC kullanarak bir 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ştirildiğinde kullanıcı cihazda bir iş profili oluşturabilir.
  • 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ştirildiğinde kullanıcı cihazda bir iş profili oluşturabilir.
  • 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.