REST Resource: enterprises.enrollmentTokens

Resource: EnrollmentToken

Token pendaftaran.

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

string

Nama token pendaftaran, yang dibuat oleh server selama pembuatan, dalam format enterprises/{enterpriseId}/enrollmentTokens/{enrollmentTokenId}.
value

string

Nilai token yang diteruskan ke perangkat dan memberikan otorisasi ke perangkat untuk mendaftar. Ini adalah kolom hanya-baca yang dibuat oleh server.
duration

string (Duration format)

Durasi saat token pendaftaran valid, mulai dari 1 menit hingga Durations.MAX_VALUE, sekitar 10.000 tahun. Jika tidak ditentukan, durasi defaultnya adalah 1 jam. Perhatikan bahwa jika durasi yang diminta menyebabkan expirationTimestamp yang dihasilkan melebihi Timestamps.MAX_VALUE, expirationTimestamp akan dikonversi menjadi Timestamps.MAX_VALUE.

Durasi dalam detik dengan maksimal sembilan digit pecahan, diakhiri dengan 's'. Contoh: "3.5s".
expirationTimestamp

string (Timestamp format)

Waktu habis masa berlaku token. Ini adalah kolom hanya-baca yang dibuat oleh server.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
policyName

string

Nama kebijakan yang awalnya diterapkan ke perangkat terdaftar, dalam format enterprises/{enterpriseId}/policies/{policyId}. Jika tidak ditentukan, policyName untuk pengguna perangkat akan diterapkan. Jika userName juga tidak ditentukan, enterprises/{enterpriseId}/policies/default akan diterapkan secara default. Saat memperbarui kolom ini, Anda hanya dapat menentukan policyId selama policyId tidak berisi garis miring. Nama kebijakan lainnya akan ditentukan.
additionalData

string

Data arbitrer opsional yang terkait dengan token pendaftaran. Informasi ini dapat berisi, misalnya, ID unit organisasi tempat perangkat ditetapkan setelah pendaftaran. Setelah perangkat didaftarkan dengan token, data ini akan ditampilkan di kolom enrollmentTokenData dari resource Device. Data harus terdiri dari maksimal 1.024 karakter; jika tidak, permintaan pembuatan akan gagal.
qrCode

string

String JSON yang representasi UTF-8-nya dapat digunakan untuk membuat kode QR guna mendaftarkan perangkat dengan token pendaftaran ini. Untuk mendaftarkan perangkat menggunakan NFC, data NFC harus berisi representasi java.util.Properties serial dari properti di JSON.
oneTimeOnly

boolean

Apakah token pendaftaran hanya untuk penggunaan satu kali. Jika tanda disetel ke benar (true), hanya satu perangkat yang dapat menggunakannya untuk pendaftaran.
user
(deprecated)

object (User)

Kolom ini tidak digunakan lagi dan nilainya diabaikan.
allowPersonalUsage

enum (AllowPersonalUsage)

Mengontrol apakah penggunaan pribadi diizinkan di perangkat yang disediakan dengan token pendaftaran ini.

Untuk perangkat milik perusahaan:

  • Mengaktifkan penggunaan pribadi memungkinkan pengguna menyiapkan profil kerja di perangkat.
  • Untuk menonaktifkan penggunaan pribadi, pengguna harus menyediakan perangkat sebagai perangkat terkelola sepenuhnya.

Untuk perangkat milik pribadi:

  • Mengaktifkan penggunaan pribadi memungkinkan pengguna menyiapkan profil kerja di perangkat.
  • Menonaktifkan penggunaan pribadi akan mencegah perangkat disediakan. Penggunaan pribadi tidak dapat dinonaktifkan di perangkat milik pribadi.

Metode

create

 Membuat token pendaftaran untuk perusahaan tertentu.

delete

 Menghapus token pendaftaran.

get

 Mendapatkan token pendaftaran yang aktif dan belum habis masa berlakunya.

list

 Mencantumkan token pendaftaran yang aktif dan belum habis masa berlakunya untuk perusahaan tertentu.