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 enterprises/{enterpriseId}/enrollmentTokens/{enrollmentTokenId} biçiminde adı.

value

string

Cihaza iletilen ve cihazı kaydettirmek için yetkilendiren 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 arasında değişir ve yaklaşık 10.000 yıldır. Belirtilmezse varsayılan süre 1 saattir. İstenen süre, sonuçta ortaya çıkan expirationTimestamp değerinin Timestamps.MAX_VALUE değerini aşmasına neden olursa expirationTimestamp değerinin Timestamps.MAX_VALUE olarak zorlanacağını lütfen unutmayın.

En fazla dokuz kesir basamağı olan 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.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

policyName

string

İlk olarak kayıtlı cihaza uygulanan politikanın enterprises/{enterpriseId}/policies/{policyId} biçimindeki adı. Belirtilmezse cihaz kullanıcısı için policyName uygulanır. userName belirtilmezse varsayılan olarak enterprises/{enterpriseId}/policies/default uygulanır. policyId eğik çizgi içermediği sürece bu alanı güncellerken 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. Bu bilgi, örneğin kayıttan sonra cihazın atandığı kuruluş biriminin kimliğini içerebilir. Bir cihaz jetonla kaydolduktan sonra bu veriler, Device kaynağının enrollmentTokenData alanında gösterilir. Veriler 1.024 karakter veya daha kısa olmalıdır; 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. Bir cihazı NFC kullanarak kaydettirmek için NFC kaydının, JSON dosyasındaki özelliklerin serileştirilmiş java.util.Properties temsilini içermesi gerekir.

oneTimeOnly

boolean

Kayıt jetonunun yalnızca tek kullanımlık olup olmadığı. İşaret, doğru değerine ayarlanırsa bunu kayıt için yalnızca bir cihaz kullanabilir.

user
(deprecated)

object (User)

Bu alan kullanımdan kaldırılmıştır ve değer 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ın devre dışı bırakılması, kullanıcının cihazın temel hazırlığını tümüyle yönetilen bir cihaz olarak gerçekleştirmesini gerektirir.

Ş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ın devre dışı bırakılması, cihazın temel hazırlık işlemini yapmasını engeller. Şahıslara ait cihazlarda kişisel kullanım 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ş için etkin, süresi dolmamış kayıt jetonlarını listeler.