REST Resource: customers.configurations

Recurso: Configuration

Una configuración recopila las opciones de aprovisionamiento para dispositivos Android. Cada configuración combina lo siguiente:

  • El controlador de política de dispositivo (DPC) de EMM instalado en los dispositivos
  • Políticas de EMM aplicadas en los dispositivos
  • Son metadatos que se muestran en el dispositivo para ayudar a los usuarios durante la configuración.

Los clientes pueden agregar todas las configuraciones que necesiten. Sin embargo, la inscripción automática funciona mejor cuando un cliente establece una configuración predeterminada que se aplica a todos los dispositivos nuevos que compra la organización.

Representación JSON
{
  "name": string,
  "configurationId": string,
  "configurationName": string,
  "dpcResourcePath": string,
  "dpcExtras": string,
  "companyName": string,
  "contactEmail": string,
  "contactPhone": string,
  "customMessage": string,
  "isDefault": boolean,
  "forcedResetTime": string
}
Campos
name

string

Solo salida. El nombre del recurso de la API en el formato customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]. El servidor lo asigna.

configurationId

string (int64 format)

Solo salida. El ID de la configuración. El servidor lo asigna.

configurationName

string

Obligatorio. Un nombre corto que describe el propósito de la configuración. Por ejemplo, Equipo de ventas o Empleados temporales. El portal de inscripción automática muestra este nombre a los administradores de TI.

dpcResourcePath

string

Obligatorio. El nombre del recurso del DPC (controlador de política de dispositivo) seleccionado en el formato customers/[CUSTOMER_ID]/dpcs/*. Para enumerar los DPC admitidos, llama a customers.dpcs.list.

dpcExtras

string

Los elementos adicionales de aprovisionamiento de EMM con formato JSON que se pasan al DPC.

companyName

string

Obligatorio. Es el nombre de la organización. La inscripción automática les muestra el nombre de esta organización a los usuarios de los dispositivos durante el aprovisionamiento de dispositivos.

contactEmail

string

Obligatorio. Es la dirección de correo electrónico con la que los usuarios del dispositivo pueden comunicarse para obtener ayuda. La inscripción automática muestra esta dirección de correo electrónico a los usuarios de los dispositivos antes de aprovisionarlos. El valor se valida cuando se ingresa.

contactPhone

string

Obligatorio. Número de teléfono al que los usuarios del dispositivo pueden llamar desde otro dispositivo para obtener ayuda. La inscripción automática muestra este número a los usuarios de los dispositivos antes de aprovisionarlos. Acepta números, espacios, el signo más, guiones y paréntesis.

customMessage

string

Un mensaje, que contiene una o dos oraciones, para ayudar a los usuarios de dispositivos a obtener ayuda o brindarles más detalles sobre lo que le ocurre a su dispositivo. La inscripción automática muestra este mensaje antes de que se aprovisione el dispositivo.

isDefault

boolean

Obligatorio. Si esta es la configuración predeterminada que la inscripción automática aplica a cualquier dispositivo nuevo que la organización compre en el futuro. Solo una configuración de cliente puede ser la predeterminada. Establecer este valor en true cambia el valor de isDefault de la configuración predeterminada anterior a false.

forcedResetTime

string (Duration format)

Opcional. Es el tiempo de espera antes de forzar el restablecimiento de la configuración de fábrica del dispositivo si este no se aprovisionó con el asistente de configuración, por lo general, debido a una falta de conectividad de red durante el asistente de configuración. Va de 0 a 6 horas y, si no se configura, el valor predeterminado es 2 horas.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

Métodos

create

Crea una configuración nueva.

delete

Borra una configuración que no se usa.

get

Obtiene los detalles de una configuración.

list

Enumera las configuraciones de un cliente.

patch

Actualiza los valores de campo de una configuración.