REST Resource: customers.configurations

Ressource: Configuration

Une configuration collecte les options de provisionnement pour les appareils Android. Chaque configuration comprend les éléments suivants :

  • Outil de contrôle des règles relatives aux appareils EMM installé sur les appareils
  • Règles EMM appliquées aux appareils.
  • Métadonnées affichées sur l'appareil pour aider les utilisateurs lors de la configuration.

Les clients peuvent ajouter autant de configurations que nécessaire. Toutefois, l'enregistrement sans contact fonctionne mieux lorsqu'un client définit une configuration par défaut qui est appliquée à tous les nouveaux appareils achetés par l'organisation.

Représentation JSON 
{
  "name": string,
  "configurationId": string,
  "configurationName": string,
  "dpcResourcePath": string,
  "dpcExtras": string,
  "companyName": string,
  "contactEmail": string,
  "contactPhone": string,
  "customMessage": string,
  "isDefault": boolean,
  "forcedResetTime": string
}
Champs
name

string

Uniquement en sortie. Nom de la ressource d'API au format customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]. Attribué par le serveur.
configurationId

string (int64 format)

Uniquement en sortie. ID de la configuration. Attribué par le serveur.
configurationName

string

Obligatoire. Nom court décrivant l'objectif de la configuration. Par exemple : Équipe de vente ou Travailleurs intérimaires. Le portail d'enregistrement sans contact affiche ce nom aux administrateurs informatiques.
dpcResourcePath

string

Obligatoire. Nom de ressource de l'outil de contrôle des règles relatives aux appareils sélectionné, au format customers/[CUSTOMER_ID]/dpcs/*. Pour répertorier les DPC compatibles, appelez customers.dpcs.list.
dpcExtras

string

Les extras de provisionnement EMM au format JSON transmis au DPC.
companyName

string

Obligatoire. Nom de l'organisme. L'enregistrement sans contact affiche ce nom d'organisation pour les utilisateurs des appareils lors du provisionnement des appareils.
contactEmail

string

Obligatoire. Adresse e-mail que les utilisateurs des appareils peuvent contacter pour obtenir de l'aide. L'inscription sans contact présente cette adresse e-mail aux utilisateurs des appareils avant la phase de préparation. La valeur est validée à l'entrée.
contactPhone

string

Obligatoire. Numéro de téléphone que les utilisateurs des appareils peuvent appeler à l'aide d'un autre appareil pour obtenir de l'aide. L'enregistrement sans contact présente ce numéro aux utilisateurs des appareils avant la phase de préparation. Accepte les chiffres, les espaces, le signe plus, les traits d'union et les parenthèses.
customMessage

string

Message contenant une ou deux phrases, afin d'aider les utilisateurs d'appareils à obtenir de l'aide ou de leur fournir plus de détails sur ce qu'il advient de leur appareil L'enregistrement sans contact affiche ce message avant la préparation de l'appareil.
isDefault

boolean

Obligatoire. S'il s'agit de la configuration par défaut que l'enregistrement sans contact appliquera à tous les nouveaux appareils que l'organisation achètera à l'avenir. Une seule configuration client peut être utilisée par défaut. Si vous définissez cette valeur sur true, la valeur isDefault de la configuration par défaut précédente est remplacée par false.
forcedResetTime

string (Duration format)

Facultatif. Délai avant la réinitialisation de la configuration d'usine si l'appareil ne passe pas par l'assistant de configuration, généralement en raison d'un manque de connectivité réseau. Sa valeur doit être comprise entre 0 et 6 heures (la valeur par défaut étant 2 heures, elle n'est pas configurée).

Durée en secondes avec neuf chiffres au maximum, finissant par "s". Exemple: "3.5s".

Méthodes

create

 Crée une configuration.

delete

 Supprime une configuration inutilisée.

get

 Récupère les détails d'une configuration.

list

 Liste les configurations d'un client.

patch

 Met à jour les valeurs des champs d'une configuration.