REST Resource: customers.configurations

Recurso: Configuración

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

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

Los clientes pueden agregar todos los parámetros de configuración que necesiten. Sin embargo, la inscripción automática funciona mejor cuando un cliente establece una configuración predeterminada que se aplica a cualquier dispositivo nuevo que compre 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. Es 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. Es el ID de la configuración. El servidor lo asigna.
configurationName

string

Obligatorio. Es 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 les muestra este nombre a los administradores de TI.
dpcResourcePath

string

Obligatorio. Es el nombre de 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 extras de aprovisionamiento de EMM en 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 la organización a los usuarios durante el aprovisionamiento del dispositivo.
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 les muestra esta dirección de correo electrónico a los usuarios del dispositivo antes de que se aprovisionen. El valor se valida en la entrada.
contactPhone

string

Obligatorio. Es el número de teléfono al que los usuarios pueden llamar desde otro dispositivo para obtener ayuda. La inscripción automática les muestra este número a los usuarios del dispositivo antes de que se aprovisionen. 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 proporcionarles más detalles sobre lo que sucede con su dispositivo. La inscripción automática muestra este mensaje antes de que se aprovisione el dispositivo.
isDefault

boolean

Obligatorio. Indica si esta es la configuración predeterminada que se usa para la inscripción automática en cualquier dispositivo nuevo que compre la organización en el futuro. Solo una configuración de cliente puede ser la predeterminada. Establece este valor en true y cambia el valor 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 pasa por el aprovisionamiento en el asistente de configuración, generalmente, debido a la falta de conectividad de red durante el asistente de configuración. Varía de 0 a 6 horas, con 2 horas predeterminadas si no se configura.

Una duración en segundos con un máximo de 9 dígitos decimales, que termina en 's'. Ejemplo: "3.5s".

Métodos

create

 Crea una configuración nueva.

delete

 Borra una configuración sin usar.

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.