REST Resource: customers.configurations

Resource: Konfigurasi

Konfigurasi mengumpulkan opsi penyediaan untuk perangkat Android. Setiap konfigurasi menggabungkan hal berikut:

  • Pengontrol kebijakan perangkat (DPC) EMM diinstal di perangkat.
  • Kebijakan EMM diterapkan di perangkat.
  • Metadata yang ditampilkan di perangkat untuk membantu pengguna selama penyiapan.

Pelanggan dapat menambahkan konfigurasi sebanyak yang mereka butuhkan. Namun, pendaftaran zero-touch berfungsi optimal jika pelanggan menetapkan konfigurasi default yang diterapkan ke perangkat baru yang dibeli organisasi.

Representasi JSON
{
  "name": string,
  "configurationId": string,
  "configurationName": string,
  "dpcResourcePath": string,
  "dpcExtras": string,
  "companyName": string,
  "contactEmail": string,
  "contactPhone": string,
  "customMessage": string,
  "isDefault": boolean,
  "forcedResetTime": string
}
Kolom
name

string

Hanya output. Nama resource API dalam format customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]. Ditetapkan oleh server.

configurationId

string (int64 format)

Hanya output. ID konfigurasi. Ditetapkan oleh server.

configurationName

string

Wajib diisi. Nama pendek yang menjelaskan tujuan konfigurasi. Misalnya, Tim penjualan atau Karyawan magang. Portal pendaftaran zero-touch menampilkan nama ini kepada admin IT.

dpcResourcePath

string

Wajib diisi. Nama resource DPC (pengontrol kebijakan perangkat) yang dipilih dalam format customers/[CUSTOMER_ID]/dpcs/*. Untuk mencantumkan DPC yang didukung, panggil customers.dpcs.list.

dpcExtras

string

Tambahan penyediaan EMM berformat JSON yang diteruskan ke DPC.

companyName

string

Wajib diisi. Nama organisasi. Pendaftaran zero-touch menampilkan nama organisasi ini kepada pengguna perangkat selama proses penyediaan perangkat.

contactEmail

string

Wajib diisi. Alamat email yang dapat dihubungi pengguna perangkat untuk mendapatkan bantuan. Pendaftaran zero-touch menampilkan alamat email ini kepada pengguna perangkat sebelum proses penyediaan perangkat. Nilai divalidasi pada saat input.

contactPhone

string

Wajib diisi. Nomor telepon yang dapat dihubungi pengguna perangkat, menggunakan perangkat lain, untuk mendapatkan bantuan. Pendaftaran zero-touch menampilkan nomor ini kepada pengguna perangkat sebelum penyediaan perangkat. Menerima angka, spasi, tanda plus, tanda hubung, dan tanda kurung.

customMessage

string

Pesan, yang berisi satu atau dua kalimat, untuk membantu pengguna perangkat mendapatkan bantuan atau memberi mereka detail lebih lanjut tentang apa yang terjadi pada perangkat mereka. Pendaftaran zero-touch menampilkan pesan ini sebelum proses penyediaan perangkat.

isDefault

boolean

Wajib diisi. Apakah ini merupakan konfigurasi default yang diterapkan pendaftaran zero-touch ke semua perangkat baru yang dibeli organisasi di masa mendatang. Hanya satu konfigurasi pelanggan yang dapat menjadi default. Menyetel nilai ini ke true akan mengubah nilai isDefault konfigurasi default sebelumnya menjadi false.

forcedResetTime

string (Duration format)

Opsional. Waktu tunggu sebelum memaksa reset perangkat ke setelan pabrik jika perangkat tidak melalui proses penyediaan di wizard penyiapan, biasanya karena kurangnya konektivitas jaringan selama wizard penyiapan. Rentang 0-6 jam, dengan 2 jam sebagai default jika tidak disetel.

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

Metode

create

Membuat konfigurasi baru.

delete

Menghapus konfigurasi yang tidak digunakan.

get

Mendapatkan detail konfigurasi.

list

Mencantumkan konfigurasi pelanggan.

patch

Memperbarui nilai kolom konfigurasi.