Enrollmenttokens: create

Membuat token pendaftaran untuk perusahaan. Metode ini adalah bagian dari EnrollmentTokensService.

Permintaan

Permintaan HTTP

POST https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/enrollmentTokens

Parameter

Nama parameter Nilai Deskripsi
Parameter jalur
enterpriseId string ID perusahaan.

Otorisasi

Permintaan ini memerlukan otorisasi dengan cakupan berikut:

Cakupan
https://www.googleapis.com/auth/androidenterprise

Untuk mengetahui informasi selengkapnya, lihat halaman autentikasi dan otorisasi.

Isi permintaan

Dalam isi permintaan, berikan data dengan struktur berikut:

{
  "kind": "androidenterprise#enrollmentToken",
  "token": string,
  "enrollmentTokenType": string,
  "duration": {
    "seconds": long,
    "nanos": integer
  },
  "googleAuthenticationOptions": {
    "authenticationRequirement": string,
    "requiredAccountEmail": string
  }
}
Nama properti Nilai Deskripsi Catatan
kind string
token string Nilai token yang diteruskan ke perangkat dan mengotorisasi perangkat untuk mendaftar. Kolom ini bersifat hanya baca dan dibuat oleh server.
enrollmentTokenType string [Wajib] Jenis token pendaftaran.

Nilai yang dapat diterima adalah:
  • "enrollmentTokenTypeUnspecified"
  • "userDevice"
  • "userlessDevice"
duration nested object [Opsional] Durasi waktu token pendaftaran berlaku, mulai dari 1 menit hingga Durations.MAX_VALUE, sekitar 10.000 tahun. Jika tidak ditentukan, durasi defaultnya adalah 1 jam. Di JSON REST API, durasi ini direpresentasikan sebagai string (misalnya, `3600s`).
duration.seconds long Detik yang ditandatangani dari rentang waktu.
googleAuthenticationOptions nested object [Opsional] Memberikan opsi terkait autentikasi Google selama pendaftaran.
googleAuthenticationOptions.authenticationRequirement string [Opsional] Menentukan apakah pengguna harus melakukan autentikasi dengan Google selama pendaftaran. Jika disediakan, setelan ini akan mengganti GoogleAuthenticationSettings untuk resource perusahaan saat perangkat didaftarkan dengan token ini.

Nilai yang dapat diterima adalah:
  • "authenticationRequirementUnspecified"
  • "optional"
  • "required"
googleAuthenticationOptions.requiredAccountEmail string [Opsional] Menentukan Akun Google terkelola yang harus digunakan pengguna selama pendaftaran. AuthenticationRequirement harus ditetapkan ke REQUIRED jika kolom ini ditetapkan.

Respons

Jika berhasil, metode ini akan menampilkan isi respons dengan struktur berikut:

{
  "kind": "androidenterprise#enrollmentToken",
  "token": string,
  "enrollmentTokenType": string,
  "duration": {
    "seconds": long,
    "nanos": integer
  },
  "googleAuthenticationOptions": {
    "authenticationRequirement": string,
    "requiredAccountEmail": string
  }
}
Nama properti Nilai Deskripsi Catatan
kind string
token string Nilai token yang diteruskan ke perangkat dan mengotorisasi perangkat untuk mendaftar. Kolom ini bersifat hanya baca dan dibuat oleh server.
enrollmentTokenType string [Wajib] Jenis token pendaftaran.

Nilai yang dapat diterima adalah:
  • "enrollmentTokenTypeUnspecified"
  • "userDevice"
  • "userlessDevice"
duration nested object [Opsional] Durasi waktu token pendaftaran berlaku, mulai dari 1 menit hingga Durations.MAX_VALUE, sekitar 10.000 tahun. Jika tidak ditentukan, durasi defaultnya adalah 1 jam. Di JSON REST API, durasi ini direpresentasikan sebagai string (misalnya, `3600s`).
duration.seconds long Detik yang ditandatangani dari rentang waktu.
googleAuthenticationOptions nested object [Opsional] Memberikan opsi terkait autentikasi Google selama pendaftaran.
googleAuthenticationOptions.authenticationRequirement string [Opsional] Menentukan apakah pengguna harus melakukan autentikasi dengan Google selama pendaftaran. Setelan ini, jika ditentukan, GoogleAuthenticationSettings yang ditentukan untuk resource perusahaan akan diabaikan untuk perangkat yang didaftarkan dengan token ini.

Nilai yang dapat diterima adalah:
  • "authenticationRequirementUnspecified"
  • "optional"
  • "required"
googleAuthenticationOptions.requiredAccountEmail string [Opsional] Menentukan Akun Google terkelola yang harus digunakan pengguna selama pendaftaran.AuthenticationRequirement harus ditetapkan keREQUIRED if this field is set.