REST Resource: customers.configurations

Resource: Konfigurasi

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

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

Pelanggan dapat menambahkan konfigurasi sebanyak yang diperlukan. 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. 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. Nama resource DPC (pengontrol kebijakan perangkat) yang dipilih dalam format customers/[CUSTOMER_ID]/dpcs/*. Untuk menampilkan DPC yang didukung, panggil customers.dpcs.list.
dpcExtras

string

EMM berformat JSON yang menyediakan tambahan yang diteruskan ke DPC.
companyName

string

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

string

Wajib. 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 saat dimasukkan.
contactPhone

string

Wajib. Nomor telepon yang dapat dihubungi pengguna perangkat, yang 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 perangkat disediakan.
isDefault

boolean

Wajib. Apakah ini merupakan konfigurasi default yang diterapkan pendaftaran zero-touch untuk setiap 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 ke setelan pabrik jika perangkat tidak melalui penyediaan di wizard penyiapan, biasanya karena kurangnya konektivitas jaringan selama wizard penyiapan. Rentang dari 0-6 jam, dengan 2 jam menjadi 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.