Darbs ar Customer Insights - Data API

Dynamics 365 Customer Insights - Data nodrošina API, lai izveidotu savas lietojumprogrammas, pamatojoties uz jūsu datiem programmā Customer Insights. Sīkāka informācija par šiem API ir norādīta API atsaucē. Tajos ir iekļauta papildinformācija par operācijām, parametriem un atbildēm.

Sāciet izmēģināt API

Administratoram ir jāiespējo API piekļuve jūsu datiem. Kad piekļuve ir iespējota, jebkurš lietotājs var izmantot API ar abonementa atslēgu.

1. Piesakieties Customer Insights - Data Customer Insights izmēģinājuma versijā vai reģistrējieties tai.

2. Dodieties uz Iestatījumu>atļaujas un atlasiet cilni API.

3. Ja API piekļuve videi nav iestatīta, atlasiet Iespējot.

   Iespējojot API, jūsu videi tiek izveidota primārā un sekundārā abonementa atslēga, kas tiek izmantota API pieprasījumos. Lai atkārtoti ģenerētu atslēgas, cilnē API atlasiet Atjaunot primāro vai Atkārtoti ģenerēt sekundāro .

4. Atlasiet Izpētīt mūsu API, lai izmēģinātu API.

5. Meklējiet un atlasiet API darbību un atlasiet Izmēģināt.

   

6. Sānu rūtī iestatiet nolaižamās izvēlnes Autorizācija vērtību kā implicit. Galvene Authorization tiek pievienota ar uzrādītāja marķieri. Jūsu abonementa atslēga tiek aizpildīta automātiski.

7. Ja vēlaties, pievienojiet visus nepieciešamos vaicājuma parametrus.

8. Ritiniet līdz sānu rūts apakšai un atlasiet Sūtīt.

   HTTP atbilde tiek rādīta rūts apakšdaļā.

Jaunas programmas reģistrēšanas izveide Azure portālā

Izveidojiet jaunu programmas reģistrāciju , lai izmantotu API Azure lietojumprogrammā, izmantojot deleģētās atļaujas.

1. Aizpildiet sadaļu Darba sākšana.

2. Piesakieties Azure portālā ar kontu, kas var piekļūt Customer Insights datiem.

3. Meklējiet un pēc tam atlasiet Lietotņu reģistrācijas.

4. Atlasiet Jauna reģistrācija, norādiet lietojumprogrammas nosaukumu un izvēlieties konta tipu.

   Ja nepieciešams, pievienojiet novirzīšanas URL. http://localhost ir pietiekams, lai izstrādātu lietojumprogrammu lokālajā datorā.

5. Atlasiet Reģistrēt.

6. Reģistrējoties jaunajai lietotnei, dodieties uz API atļaujām.

7. Atlasiet Pievienot atļauju un sānu rūtī atlasiet Dynamics 365 AI for Customer Insights .

8. Sadaļā Atļaujas tips atlasiet Pilnvarotās atļaujas un pēc tam atlasiet user_impersonation atļauju.

9. Atlasiet Pievienot atļaujas.

10. Atlasiet Piešķirt administratora piekrišanu... , lai pabeigtu lietotnes reģistrāciju.

11. Lai piekļūtu API, lietotājam nepiesakoties, dodieties uz Servera-servera lietojumprogrammu atļauju iestatīšana.

Varat izmantot lietojumprogrammu/klienta ID šīs programmas reģistrācijai Microsoft autentifikācijas bibliotēkā (MSAL), lai iegūtu uzrādītāja pilnvaru, ko nosūtīt kopā ar pieprasījumu API.

Informāciju par API izmantošanu mūsu klientu bibliotēkās skatiet Customer Insights klientu bibliotēkās.

Starpserveru lietojumprogrammu atļauju iestatīšana

Izveidojiet programmas reģistrāciju, kurai nav nepieciešama lietotāja mijiedarbība un kuru var palaist serverī.

1. Reģistrējoties programmai Azure portālā, dodieties uz API atļaujām.

2. Atlasiet Pievienot atļauju.

3. Atlasiet cilni API, ko izmanto mana organizācija, un sarakstā izvēlieties Dynamics 365 AI for Customer Insights .

4. Laukā Atļaujas tips atlasiet Lietojumprogrammas atļaujas un pēc tam atlasiet atļauju api.access .

5. Atlasiet Pievienot atļaujas.

6. Atgriezieties sadaļā API atļaujas lietotnes reģistrācijai .

7. Atlasiet Piešķirt administratora piekrišanu... , lai pabeigtu lietotnes reģistrāciju.

8. Pievienojiet lietotnes reģistrācijas nosaukumu kā lietotājs Customer Insights - Data.

   1. Atveriet Customer Insights - Data, dodieties uz Iestatījumu>atļaujas un atlasiet Pievienot lietotājus .

   2. Meklējiet savas lietotnes reģistrācijas nosaukumu, atlasiet to meklēšanas rezultātos un atlasiet Saglabāt.

Vaicājumu paraugi

Īsu sarakstu ar OData vaicājumu paraugiem darbam ar API skatiet rakstā OData vaicājumu piemēri.

Customer Insights klientu bibliotēkas

Sāciet darbu, izmantojot API pieejamās Customer Insights - Data klientu bibliotēkas. Visu bibliotēkas pirmkodu un lietojumprogrammu paraugus var atrast GitHub repo.

C# NuGet

Izmantojiet C# klientu bibliotēkas from.org NuGet. Pašlaik pakete ir vērsta uz netstandard2.0 un netcoreapp2.0 ietvariem. Papildinformāciju NuGet par pakotni skatiet rakstā Microsoft.Dynamics.CustomerInsights.Api.

Pievienot C# klienta bibliotēku C# projektam

1. Iekšā Visual Studio atveriet NuGet sava projekta pakotņu pārvaldnieku .

2. Meklējiet Microsoft.Dynamics.CustomerInsights.Api.

3. Atlasiet Instalēt , lai pievienotu pakotni projektam.

   Vai arī palaidiet šo komandu pakotņu pārvaldnieka NuGet konsolē: Install-Package -Id Microsoft.Dynamics.CustomerInsights.Api -Source nuget.org -ProjectName <project name> [-Version <version>]

Izmantojiet C# klienta bibliotēku

1. Izmantojiet Microsoft autentifikācijas bibliotēku (MSAL), lai iegūtu AccessToken esošo Azure programmas reģistrāciju.

2. Pēc veiksmīgas autentifikācijas un pilnvaras iegūšanas izveidojiet jaunu vai izmantojiet esošu HttpClient ar DefaultRequestHeaders "Authorization" , kas iestatīts uz Bearer "piekļuves pilnvara"un Ocp-Apim-Subscription-Key , kas iestatīts uz abonēšanas atslēgu no jūsu Customer Insights - Data vides.

   Ja nepieciešams, atiestatiet autorizācijas galveni. Piemēram, ja ir izbeidzies marķieris.

3. Nododiet to HttpClient klienta būvniecībā CustomerInsights .

4. Piemēram, veiciet zvanus ar klientu uz "paplašināšanas metodēm" GetAllInstancesAsync. Ja priekšroka tiek dota piekļuvei pamatā esošajam instrumentam Microsoft.Rest.HttpOperationResponse , izmantojiet, piemēram, "http ziņojumu metodes" GetAllInstancesWithHttpMessagesAsync.

5. Atbilde, visticamāk object , ir ierakstīta, jo metode var atgriezt vairākus tipus (piemēram, IList<InstanceInfo> un ApiErrorResult). Lai pārbaudītu atgriešanas veidu, izmantojiet objektus atbilžu tipos, kas norādīti attiecīgās operācijas API detalizētās informācijas lapā .

   Ja ir nepieciešama papildinformācija par pieprasījumu, izmantojiet http ziņojuma metodes , lai piekļūtu neapstrādātam atbildes objektam.

NodeJS pakotne

Izmantojiet NodeJS klientu bibliotēkas, kas pieejamas, izmantojot NPM: https://www.npmjs.com/package/@microsoft/customerinsights

Python pakotne

Izmantojiet PyPi pieejamās Python klientu bibliotēkas: https://pypi.org/project/customerinsights/