Utiliser Customer Insights - API de données

Dynamics 365 Customer Insights : les données fournissent des API pour créer vos propres applications en fonction de vos données dans Customer Insights. Vous pouvez trouver des détails sur ces API dans la référence de l’API, qui inclut des informations sur les opérations, les paramètres et les réponses.

Commencez à tester les API

Un administrateur doit activer l’accès d’API à vos données. Une fois l’accès activé, n’importe quel utilisateur peut utiliser l’API avec la clé d’abonnement.

1. Connectez-vous à Customer Insights - Données ou inscrivez-vous à une version d’évaluation de Customer Insights.

2. Accédez à Autorisations des paramètres> et sélectionnez l’onglet API.

3. Si l’accès API à l’environnement n’est pas configuré, sélectionnez Activer.

   Lorsque vous activez les API, vous créez une clé d’abonnement primaire et une clé secondaire pour votre environnement que vous utilisez dans les requêtes API. Pour régénérer les clés, sélectionnez Régénérer primaire ou Régénérer secondaire dans l’onglet APIs .

4. Sélectionnez Explorer nos API pour essayer les API.

5. Recherchez et sélectionnez une opération d’API, puis sélectionnez Essayer.

   

6. Dans le volet latéral, définissez la valeur dans le menu déroulant Autorisationsur implicite. L’en-tête Authorization est ajouté avec un jeton de porteur. Votre clé d’abonnement se remplit automatiquement.

7. Si vous le souhaitez, ajoutez tous les paramètres de requête nécessaires.

8. Faites défiler jusqu’au bas du volet latéral, puis sélectionnez Envoyer.

   La réponse HTTP s’affiche en bas du volet.

Créer une inscription d’application dans le portail Azure

Créez une nouvelle inscription d’application pour utiliser les API dans une application Azure en utilisant des autorisations déléguées.

1. Complétez la section Prise en main.

2. Connectez-vous au portail Azure avec le compte qui peut accéder aux données Customer Insights.

3. Recherchez, puis sélectionnez Inscriptions d’applications.

4. Sélectionnez Nouvelle inscription, indiquez un nom de candidature et choisissez le type de compte.

   Si vous le souhaitez, ajoutez une URL de redirection. http://localhost est suffisant pour développer une application sur votre ordinateur local.

5. Sélectionnez Inscription.

6. Lors de votre nouvelle inscription à l’application, allez dans les permissions de l’API.

7. Sélectionnez Ajouter une autorisation et sélectionnez Dynamics 365 AI for Customer Insights dans le volet latéral.

8. Pour le type d’autorisation, sélectionnez Autorisations déléguées , puis sélectionnez l’autorisation user_impersonation .

9. Sélectionnez Ajouter des autorisations.

10. Sélectionnez Accorder le consentement de l’administrateur pour... pour terminer l’inscription de l’application.

11. Pour accéder à l’API sans connexion utilisateur, accédez à Définir des autorisations d’application serveur à serveur.

Vous pouvez utiliser l’ID d’application/client pour cette inscription d’application auprès de la bibliothèque d’authentification Microsoft (MSAL) pour obtenir un jeton du porteur à envoyer avec votre demande à l’API.

Pour plus d’informations sur l’utilisation des API dans nos bibliothèques clientes, consultez les bibliothèques clientes Customer Insights.

Définir les autorisations d’application serveur à serveur

Créez une inscription à une application qui ne nécessite pas d’interaction utilisateur et qui peut tourner sur un serveur.

1. Sur votre inscription d’application dans le portail Azure, accédez aux autorisations d’API.

2. Sélectionnez Ajouter une autorisation.

3. Sélectionnez les API que mon organisation utilise l’onglet et choisissez Dynamics 365 AI for Customer Insights dans la liste.

4. Pour le type d’autorisation, sélectionnez Autorisations d’application , puis sélectionnez l’autorisation api.access .

5. Sélectionnez Ajouter des autorisations.

6. Revenez aux autorisations d’API pour l’inscription de votre application.

7. Sélectionnez Accorder le consentement de l’administrateur pour... pour terminer l’inscription de l’application.

8. Ajoutez le nom de l’inscription de l’application en tant qu’utilisateur dans Customer Insights - Données.

   1. Ouvrez Customer Insights - Données, accédez à Paramètres>Permissions, puis sélectionnez Ajouter des utilisateurs.

   2. Recherchez le nom de votre inscription d’application, sélectionnez-le dans les résultats de la recherche, puis sélectionnez Enregistrer.

Exemples de requêtes

Pour obtenir une courte liste des exemples de requêtes OData à utiliser avec les API, consultez les exemples de requêtes OData.

Bibliothèques clientes pour Customer Insights

Commencez à utiliser les bibliothèques clientes disponibles pour les API Customer Insights - Données. Vous pouvez trouver tout le code source des bibliothèques et les applications d’exemple sur un dépôt GitHub.

C# NuGet

Utilisez les bibliothèques clientes C# de NuGet.org. Actuellement, le package cible les frameworks netstandard2.0 et netcoreapp2.0. Pour plus d’informations sur le package NuGet, voir Microsoft.Dynamics. CustomerInsights.Api.

Ajouter la bibliothèque de client C# à un projet C#

1. Dans Visual Studio, ouvrez le Gestionnaire de package NuGet pour votre projet.

2. Recherchez Microsoft.Dynamics.CustomerInsights.Api.

3. Sélectionnez Installer pour ajouter le package au projet.

   Vous pouvez également exécuter cette commande dans la console du Gestionnaire de package NuGet : Install-Package -Id Microsoft.Dynamics.CustomerInsights.Api -Source nuget.org -ProjectName <project name> [-Version <version>]

Utiliser la bibliothèque de client C#

1. Utilisez la Microsoft Authentication Library (MSAL) pour obtenir un AccessToken accès en utilisant votre inscription existante à l’application Azure.

2. Après vous être authentifié et avoir obtenu un jeton, créez un nouveau HttpClient ou utilisez-en un existant. Définissez DefaultRequestHeaders "Authorization" sur Bearer "jeton d’accès" et définissez Ocp-Apim-Subscription-Key sur la clé d’abonnement de votre environnement Customer Insights - Data.

   Réinitialisez l’en-tête d’autorisation le cas échéant. Par exemple, lorsque le jeton expire.

3. Passez-le HttpClient dans la construction du CustomerInsights client.

4. Effectuez des appels avec le client aux « méthodes d’extension », par exemple GetAllInstancesAsync. Si vous préférez accéder à la base Microsoft.Rest.HttpOperationResponse, utilisez les « http message methods », par exemple, GetAllInstancesWithHttpMessagesAsync.

5. La réponse est probablement object de type, car la méthode peut retourner plusieurs types (par exemple, IList<InstanceInfo> et ApiErrorResult). Pour vérifier le type de retour, utilisez les objets dans les types de réponse spécifiés dans la page de détails de l’API pour cette opération.

   Si vous avez besoin de plus d’informations sur la requête, utilisez les méthodes de message http pour accéder à l’objet réponse brute.

package Node.js

Utilisez les Node.js bibliothèques clients disponibles via NPM : https://www.npmjs.com/package/@microsoft/customerinsights

Paquet Python

Utilisez les bibliothèques clientes Python disponibles via PyPi : https://pypi.org/project/customerinsights/