Créer agentUser

Espace de noms: microsoft.graph

Créez un objet agentUser . Vous pouvez également créer un utilisateur agent en utilisant le point de terminaison POST /users et en spécifiant le microsoft.graph.agentUser type dans le corps de la requête.

Au minimum, vous devez spécifier les propriétés requises. Vous pouvez aussi spécifier d’autres propriétés accessibles en écriture.

Cette opération retourne par défaut uniquement un sous-ensemble des propriétés de chaque agentUser. Ces propriétés par défaut sont indiquées dans la section Propriétés. Pour obtenir des propriétés qui ne sont pas renvoyées par défaut, effectuez une opération GET et spécifiez les propriétés dans une option de requête OData $select.

Cette API est disponible dans les déploiements de cloud national suivants.

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.

Requête HTTP

POST /users/microsoft.graph.agentUser

En-têtes de demande

Corps de la demande

Dans le corps de la demande, fournissez une représentation JSON de l’objet agentUser .

Le tableau suivant répertorie les propriétés requises lorsque vous créez un agentUser.

Étant donné que cette ressource prend en charge les extensions, vous pouvez utiliser l’opération POST et ajouter des propriétés personnalisées avec vos propres données à l’utilisateur de l’agent instance lors de sa création.

Réponse

Si elle réussit, cette méthode renvoie un 201 Created code de réponse et un objet agentUser dans le corps de la réponse.

La tentative de création d’un agentUser avec un identityParentId déjà lié à un autre agentUser retourne une 400 Bad Request erreur.

Exemples

Demande

L’exemple suivant illustre une demande.

POST https://graph.microsoft.com/beta/users/microsoft.graph.agentUser
Content-type: application/json

{
  "accountEnabled": true,
  "displayName": "Sales Agent",
  "mailNickname": "SalesAgent",
  "userPrincipalName": "salesagent@contoso.com",
  "identityParentId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

const options = {
	authProvider,
};

const client = Client.init(options);

const user = {
  accountEnabled: true,
  displayName: 'Sales Agent',
  mailNickname: 'SalesAgent',
  userPrincipalName: 'salesagent@contoso.com',
  identityParentId: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890'
};

await client.api('/users/microsoft.graph.agentUser')
	.version('beta')
	.post(user);

Réponse

L’exemple suivant illustre la réponse.

L’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

HTTP/1.1 201 Created
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#users/$entity",
    "@odata.type": "#microsoft.graph.agentUser",
    "id": "87d349ed-44d7-43e1-9a83-5f2406dee5bd",
    "businessPhones": [],
    "displayName": "Sales Agent",
    "mail": "salesagent@contoso.com",
    "mailNickname": "SalesAgent",
    "userPrincipalName": "salesagent@contoso.com",
    "identityParentId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Contenu connexe

• Ajout de données personnalisées à des ressources à l’aide des extensions
• Ajout de données personnalisées à des utilisateurs à l’aide des extensions d’ouverture