REST Resource: customers.configurations

Recurso: configuração

Uma configuração coleta as opções de provisionamento para dispositivos Android. Cada configuração combina:

  • O controlador de política de dispositivo (DPC) do EMM instalado nos dispositivos.
  • Políticas de EMM aplicadas nos dispositivos.
  • Metadados mostrados no dispositivo para ajudar os usuários durante a configuração.

Os clientes podem adicionar quantas configurações precisarem. No entanto, o registro sem toque funciona melhor quando um cliente define uma configuração padrão aplicada a todos os novos dispositivos comprados pela organização.

Representação 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

Apenas saída. O nome do recurso da API no formato customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]. Atribuído pelo servidor.

configurationId

string (int64 format)

Apenas saída. O ID da configuração. Atribuído pelo servidor.

configurationName

string

Obrigatório. Um nome curto que descreve a finalidade da configuração. Por exemplo, Equipe de vendas ou Funcionários temporários. O portal de registro sem toque mostra esse nome para os administradores de TI.

dpcResourcePath

string

Obrigatório. O nome do recurso do DPC (controlador de política do dispositivo) selecionado no formato customers/[CUSTOMER_ID]/dpcs/*. Para listar os DPCs compatíveis, chame customers.dpcs.list.

dpcExtras

string

Os extras de provisionamento de EMM no formato JSON que são transmitidos ao DPC.

companyName

string

Obrigatório. É o nome da organização. O registro sem toque mostra o nome da organização para os usuários durante o provisionamento do dispositivo.

contactEmail

string

Obrigatório. O endereço de e-mail com que os usuários do dispositivo podem entrar em contato para receber ajuda. O registro sem toque mostra esse endereço de e-mail para os usuários antes do provisionamento de dispositivo. O valor é validado na entrada.

contactPhone

string

Obrigatório. O número de telefone para o qual os usuários de dispositivos podem ligar, de outro dispositivo, para receber ajuda. O registro sem toque mostra esse número para os usuários antes do provisionamento do dispositivo. Aceita numerais, espaços, o sinal de adição, hifens e parênteses.

customMessage

string

Uma mensagem com uma ou duas frases para ajudar os usuários do dispositivo a receber ajuda ou dar mais detalhes sobre o que está acontecendo com o dispositivo. O registro sem toque vai mostrar essa mensagem antes do provisionamento do dispositivo.

isDefault

boolean

Obrigatório. Define se essa é a configuração padrão que o registro sem toque vai aplicar a todos os novos dispositivos que a organização comprar no futuro. Apenas uma configuração de cliente pode ser o padrão. Definir esse valor como true muda o valor de isDefault da configuração padrão anterior para false.

forcedResetTime

string (Duration format)

Opcional. O tempo limite antes de forçar a redefinição para a configuração original do dispositivo se ele não passar pelo provisionamento no assistente de configuração, geralmente devido à falta de conectividade de rede durante esse processo. Varia de 0 a 6 horas, com 2 horas sendo o padrão se não definido.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

Métodos

create

Cria uma nova configuração.

delete

Exclui uma configuração não utilizada.

get

Recebe os detalhes de uma configuração.

list

Lista as configurações de um cliente.

patch

Atualiza os valores dos campos de uma configuração.