Customer Insights – Data-ohjelmointirajapintojen käyttö

Dynamics 365 Customer Insights – tietojen avulla voit luoda omia sovelluksia Customer Insights -tietoihisi perustuen. Lisätietoja näistä API-rajapinnoista löytyy API-viitteestä, joka sisältää tietoa operaatioista, parametreista ja vastauksista.

Ohjelmointirajapintojen kokeilemisen aloittaminen

Järjestelmänvalvojan on otettava käyttöön ohjelmointirajapinnan pääsy tietoihisi. Kun käyttöoikeus on käytössä, kuka tahansa käyttäjä voi käyttää ohjelmointirajapintaa yhdessä tilausavaimen kanssa.

1. Kirjaudu sisään Customer Insightsiin – Tiedot tai rekisteröi Customer Insights -kokeiluversio.

2. Siirry kohtaan Asetukset>Käyttöoikeudet ja valitse Ohjelmointirajapinnat-välilehti .

3. Jos API-pääsyä ympäristöön ei ole asetettu, valitse Enable.

   Kun otat API:t käyttöön, luot ensisijaisen ja toissijaisen tilausavaimen ympäristöösi, joita käytät API-pyynnöissä. Avainten uudelleengenerointiin valitse API-välilehdeltäRegenerate ensisijainen tai Regenerate toissijainen.

4. Kokeile ohjelmointirajapintoja valitsemalla Tutustu ohjelmointirajapintoihin .

5. Etsi ja valitse ohjelmointirajapintatoiminto ja valitse Kokeile.

   

6. Määritä sivuruudussa avattavassa Valtuutus-valikossa olevaksi implisiittinen arvo. Otsikko Authorization lisätään haltijatunnuksen kanssa. Tilausavain täyttyy automaattisesti.

7. Halutessasi voit lisätä kaikki tarvittavat kyselyparametrit.

8. Vieritä sivuruudun alareunaan ja valitse Lähetä.

   HTTP-vastaus näkyy ruudun alareunassa.

Luo uusi sovellusrekisteröinti Azure-portaalissa

Luo uusi sovellusrekisteröinti käyttääksesi API-rajapintoja Azure-sovelluksessa käyttämällä delegoituja käyttöoikeuksia.

1. Viimeistele Aloittaminen-osio.

2. Kirjaudu sisään Azure-portaaliin tilillä, jolla voit käyttää Customer Insights -tietoja.

3. Etsi ja valitse sitten Sovelluksen rekisteröinnit.

4. Valitse Uusi rekisteröinti, anna hakemuksen nimi ja valitse tilityyppi.

   Halutessasi voit lisätä uudelleenohjauksen URL-osoitteen. http://localhost riittää sovelluksen kehittämiseen paikallisessa tietokoneessa.

5. Valitse Rekisteröi.

6. Uuden sovelluksen rekisteröinnissä mene API-oikeuksiin.

7. Valitse Lisää käyttöoikeus ja valitse sivuruudusta Dynamics 365 AI for Customer Insights .

8. Valitse Käyttöoikeustyyppi-kohdassaDelegoidut käyttöoikeudet ja valitse sitten user_impersonation käyttöoikeus.

9. Valitse Lisää käyttöoikeuksia.

10. Viimeistele sovelluksen rekisteröinti valitsemalla Myönnä järjestelmänvalvojan suostumus...

11. Jos haluat käyttää ohjelmointirajapintaa ilman käyttäjän kirjautumista, siirry kohtaan Palvelimen ja palvelimen sovellusten käyttöoikeuksien määrittäminen.

Voit käyttää sovellustunnusta sovelluksen rekisteröintiin Microsoftin todentamiskirjastossa (MSAL), jos haluat käyttöön haltijatunnuksen, joka lähetetään pyyntösi yhteydessä ohjelmointirajapintaan.

Saat lisätietoja ohjelmointirajapintojen käytöstä asiakaskirjastoissa kohdasta Customer Insights -asiakaskirjastot.

Palvelimen ja palvelimen sovellusten käyttöoikeuksien määrittäminen

Luo sovellusrekisteröinti, joka ei vaadi käyttäjän vuorovaikutusta ja voi toimia palvelimella.

1. Siirry Sovelluksen rekisteröinnissä Azure-portaalissa kohtaan Ohjelmointirajapinnan käyttöoikeudet.

2. Valitse Lisää käyttöoikeus.

3. Valitse organisaationi käyttämät ohjelmointirajapinnat -välilehti ja valitse luettelosta Dynamics 365 AI for Customer Insights .

4. Valitse Käyttöoikeustyyppi-kohdassaSovelluksen käyttöoikeudet ja valitse sitten api.access-käyttöoikeus .

5. Valitse Lisää käyttöoikeuksia.

6. Siirry takaisin sovelluksen rekisteröinnin ohjelmointirajapinnan käyttöoikeuksiin .

7. Viimeistele sovelluksen rekisteröinti valitsemalla Myönnä järjestelmänvalvojan suostumus...

8. Lisää sovelluksen rekisteröinnin nimi käyttäjänä Kohdassa Customer Insights – Tiedot.

   1. Avaa Customer Insights – Tiedot, valitse Asetukset>Käyttöoikeudet ja valitse Lisää käyttäjiä.

   2. Hae sovelluksen rekisteröinnin nimi, valitse se hakutuloksista ja valitse Tallenna.

Esimerkkikyselyt

Katso lyhyt luettelo OData-mallikyselyistä, jotka toimivat ohjelmointirajapintojen kanssa, artikkelista OData-kyselyesimerkit.

Customer Insights -asiakaskirjastot

Aloita Customer Insights – Data -ohjelmointirajapinnoille käytettävissä olevien asiakaskirjastojen käyttö. Kaikki kirjaston lähdekoodit ja esimerkkisovellukset löytyvät GitHub-reposta.

C# NuGet

Käytä C#-asiakaskirjastoja NuGet.org. Tällä hetkellä paketti kohdistuu netstandard2.0- ja netcoreapp2.0-kehyksiin. Lisätietoja NuGet-paketista löytyy osoitteesta Microsoft.Dynamics. CustomerInsights.API.

C#-asiakaskirjaston lisääminen C#-projektiin

1. Avaa Visual Studiossa projektisi NuGet paketinhallinta .

2. Hae Microsoft.Dynamics.CustomerInsights.Api.

3. Lisää paketti projektiin valitsemalla Asenna .

   Vaihtoehtoisesti voit suorittaa tämän komennon NuGet paketinhallinta Consolessa: Install-Package -Id Microsoft.Dynamics.CustomerInsights.Api -Source nuget.org -ProjectName <project name> [-Version <version>]

C#-asiakaskirjaston käyttäminen

1. Käytä Microsoft Authentication Library (MSAL) -palvelua saadaksesi AccessToken tietoa olemassa olevan Azure-sovelluksen rekisteröinnin kautta.

2. Kun olet tunnistanut ja hankkinut tokenin, rakenna uusi HttpClient tai käytä olemassa olevaa. Aseta DefaultRequestHeadersin "Authorization"Bearer "access tokeniksi" ja aseta Ocp-Apim-Subscription-Keytilausavaimeksi Customer Insights - Data -ympäristöstäsi.

   Palauta valtuutusotsikko tarvittaessa. Esimerkiksi kun token vanhenee.

3. Välitä tämä HttpClientCustomerInsights-asiakasohjelman muodostimeen.

4. Tee kutsuja asiakasohjelmalla "laajennusmetodeihin", esimerkiksi GetAllInstancesAsync. Jos haluat päästä käsiksi taustalla Microsoft.Rest.HttpOperationResponseolevaan , käytä esimerkiksi "http-viestimetodeja", GetAllInstancesWithHttpMessagesAsyncesimerkiksi .

5. Vastaus on todennäköinen object tyyppi, IList<InstanceInfo> koska menetelmä voi palauttaa useita tyyppejä (esimerkiksi ja ApiErrorResult). Voit tarkistaa palautustyypin käyttämällä objekteja kyseisen toiminnon ohjelmointirajapinnan tietosivulla määritetyissä vastaustyypeissä.

   Jos tarvitset lisätietoja pyynnöstä, käytä http-viestimetodeja päästäksesi raakavastauksen objektiin.

Node.js paketti

Käytä NPM:n kautta saatavilla olevia Node.js asiakaskirjastoja: https://www.npmjs.com/package/@microsoft/customerinsights

Python-paketti

Käytä Python-asiakaskirjastoja, jotka ovat käytettävissä PyPin kautta: https://pypi.org/project/customerinsights/