Customer Insights - Data API-dega töötamine

Dynamics 365 Customer Insights - Data pakub API-sid, et luua oma rakendusi Customer Insightsi andmete põhjal. Nende API-de üksikasjad on loetletud API viites. Need sisaldavad lisateavet toimingute, parameetrite ja vastuste kohta.

Märkus.

Customer Insights - Data tabelitele pääseb juurde ka API-de abil Dataverse . Soovitame Dataverse kasutada rakendusliideseid Customer Insightsi andmete kohta päringute tegemiseks, kuna need pakuvad ulatuslikumat filtreerimist, suuremat läbilaskevõimet ja väiksemat latentsusaega. Lisateavet vaadake jaotisest Dataverse Customer Insightsi API-d.

API-de proovimise alustamine

Administraator peab lubama API-juurdepääsu teie andmetele. Kui juurdepääs on lubatud, saab iga kasutaja kasutada API-t koos tellimisvõtmega.

1. logige sisse Customer Insightsi prooviversiooni Customer Insights - Data või registreeruge selle kasutajaks.

2. Minge jaotisse Seadete> õigused ja valige vahekaart API-d .

3. Kui API juurdepääs keskkonnale pole seadistatud, valige Luba.

   API-de lubamine loob teie keskkonna jaoks esmase ja teisese tellimisvõtme, mida kasutatakse API-taotlustes. Võtmete taastamiseks valige API-de vahekaardil Regenerate primary või Regenerate sekundaarselt .

4. Valige API-de proovimiseks Avastage meie API-sid .

5. Otsige ja valige API-toiming ning valige Proovi seda.

   

6. Seadke külgpaanil rippmenüüs Autoriseerimine väärtus väärtuseks kaudne. Päis Authorization lisatakse esitaja märgiga. Teie tellimuse võti täidetakse automaatselt.

7. Soovi korral lisage kõik vajalikud päringuparameetrid.

8. Liikuge kerides külgpaani allossa ja valige Saada.

   HTTP-vastus kuvatakse paani allosas.

Uue rakenduse registreeringu loomine Azure'i portaalis

Looge uus rakenduse registreerimine API-de kasutamiseks Azure’i rakenduses delegeeritud õiguste abil.

1. Lõpetage jaotis Alustamine.

2. Logige Azure’i portaali sisse kontoga, millel on juurdepääs Customer Insightsi andmetele.

3. Otsige ja seejärel valige Rakenduse registreeringud.

4. Valige Uus registreerimine, sisestage rakenduse nimi ja valige konto tüüp.

   Võite lisada ka ümbersuunamise URL-i. http://localhost on piisav rakenduse arendamiseks teie kohalikus arvutis.

5. Valige Registreeri.

6. Avage uue rakenduse registreerimisel API load.

7. Valige Lisa õigus ja valige külgpaanil Dynamics 365 AI for Customer Insights .

8. Väljal Õiguse tüüp valige Delegeeritud õigused ja seejärel valige õigus user_impersonation .

9. Valige Õiguste lisamine.

10. Valige Anna administraatori nõusolek ..., et rakenduse registreerimine lõpule viia.

11. API-le juurdepääsemiseks ilma kasutaja sisse logimata avage jaotis Serveritevahelise rakenduse õiguste määramine.

Selle rakenduse registreerimisel Microsofti autentimisteegis (MSAL) saate kasutada rakenduse/kliendi ID-d, et hankida esitaja luba, mille soovite koos oma taotlusega API-le saata.

Lisateavet API-de kasutamise kohta meie klienditeekides leiate jaotisest Customer Insightsi klienditeegid.

Serveritevahelise rakenduse õiguste määramine

Looge rakenduse registreerimine, mis ei vaja kasutaja sekkumist ja mida saab serveris käitada.

1. Avage rakenduse registreerimisel Azure’i portaalis API load.

2. Valige Lisa õigus.

3. Valige vahekaart API-d, mida minu organisatsioon kasutab , ja valige loendist Dynamics 365 AI for Customer Insights .

4. Väljal Õiguse tüüp valige Rakenduse õigused ja seejärel valige õigus api.access .

5. Valige Õiguste lisamine.

6. Minge tagasi rakenduse registreerimise API lubade juurde .

7. Valige Anna administraatori nõusolek ..., et rakenduse registreerimine lõpule viia.

8. Lisage rakenduse nimi, milles registreerutakse kasutajaks Customer Insights - Data.

   1. Avage Customer Insights - Data, minge jaotisse Sätete>õigused ja valige Lisa kasutajaid.

   2. Otsige rakenduse registreerimise nime, valige see otsingutulemitest ja valige Salvesta.

Näidispäringud

API-dega töötamiseks vajalike OData näidispäringute lühikese loendi leiate teemast OData päringu näited.

Customer Insightsi klienditeegid

Alustage API-de jaoks Customer Insights - Data saadaolevate klienditeekide kasutamist. Kõik raamatukogu lähtekoodid ja näidisrakendused leiate GitHubi repost.

C# NuGet

Kasutage C# klienditeeke saidilt.org NuGet. Praegu on pakett suunatud netstandard2.0 ja netcoreapp2.0 raamistikele. Lisateavet paketi kohta NuGet leiate aadressilt Microsoft.Dynamics.CustomerInsights.Api.

C# klienditeegi lisamine C# projekti

1. Avage Visual Studio oma projekti paketihaldur NuGet .

2. Otsige märksõna Microsoft.Dynamics.CustomerInsights.Api.

3. Valige Installi , et lisada pakett projekti.

   Teise võimalusena käivitage see käsk paketihalduri konsoolis NuGet : Install-Package -Id Microsoft.Dynamics.CustomerInsights.Api -Source nuget.org -ProjectName <project name> [-Version <version>]

C# klienditeegi kasutamine

1. Microsofti autentimisteegi (MSAL) abil saate hankida olemasoleva Azure’i rakenduse registreerimise AccessToken.

2. Pärast tõendi edukat autentimist ja omandamist koostage uus või kasutage olemasolevat HttpClient , mille DefaultRequestHeaders "Autoriseerimine" on seatud kandjale "juurdepääsumärk" ja Ocp-Apim-Subscription-Key , mis on seatud teie keskkonnast tellimisvõtmele Customer Insights - Data .

   Lähtestage vajaduse korral päis Autoriseerimine . Näiteks kui luba on aegunud.

3. Edastage see HttpClient kliendi ehitamiseks. CustomerInsights

4. Helistage kliendiga näiteks "laiendusmeetoditele" GetAllInstancesAsync. Kui eelistatakse juurdepääsu alusvarale Microsoft.Rest.HttpOperationResponse , kasutage näiteks GetAllInstancesWithHttpMessagesAsync "http-sõnumi meetodeid".

5. Vastus on tõenäoliselt object tüüpi, IList<InstanceInfo> kuna meetod võib tagastada mitut tüüpi (nt ja ApiErrorResult). Tagastuse tüübi kontrollimiseks kasutage objekte vastusetüüpides, mis on määratud selle toimingu jaoks API üksikasjade lehel .

   Kui päringu kohta on vaja lisateavet, kasutage toorvastuse objektile juurdepääsemiseks http-sõnumi meetodeid .

NodeJS-i pakett

Kasutage NPM-i kaudu saadaolevaid NodeJS-i klienditeeke: https://www.npmjs.com/package/@microsoft/customerinsights

Pythoni pakett

Kasutage PyPi kaudu saadaolevaid Pythoni klienditeeke: https://pypi.org/project/customerinsights/