Рад са Customer Insights - Data API-јима

Dynamics 365 Customer Insights - Data обезбеђује АПИ-је за израду сопствених апликација на основу ваших података у увидима клијената. Детаљи ових АПИ-ја су наведени у АПИ референци. Садрже додатне информације о операцијама, параметрима и одговорима.

Први кораци у покушају АПИ-ја

Администратор мора да омогући АПИ приступ вашим подацима. Када се омогући приступ, сваки корисник може да користи АПИ са кључем за претплату.

1. пријавите се или Customer Insights - Data се пријавите за пробну верзију корисничких увида.

2. Идите на дозволе > за поставке и изаберите картицу АПИ.

3. Ако АПИ приступ окружењу није подешен, изаберите опцију Омогући .

   Омогућавањем АПИ-ја креира се примарни и секундарни претплатни кључ за ваше окружење који се користи у АПИ захтевима. Да бисте поново генерисали кључеве, на картици "АПИС" изаберите ставку"Регенериши примарну или регенериши секундарну" .

4. Изаберите ставку Истражите наше АПИ-је да бисте испробали АПИ-је.

5. Потражите и изаберите АПИ операцију и изаберите покушајте .

   

6. У бочном окну поставите вредност у падајућем менију Ауторизације на имплицитну. Заглавље Authorization се додаје са ознаком носиоца. Кључ за претплату се аутоматски попуњава.

7. По жељи додајте све потребне параметре упита.

8. Померите се на дно бочног окна и изаберите пошаљи .

   ХТТП одговор се приказује на дну окна.

Направите нову регистрацију апликације на Azure порталу

Креирајте нову регистрацију апликације да бисте користили АПИ-је у Азуре апликацији користећи делегиране дозволе.

1. Довршите одељак Први кораци.

2. пријавите се на Азуре портал са налогом који може да приступи подацима"Увиди купаца".

3. Потражите, а затим изаберите ставке Регистрације апликација.

4. Изаберите нову регистрацију , наведите име апликације и одаберите врсту налога.

   Опционално додајте URL преусмеравања. http://localhost је довољно за развој апликације на локалном рачунару.

5. Изаберите Регистрација:

6. При новој регистрацији апликације идите на АПИ дозволе.

7. У бочном окну изаберите ставку Додај дозволу и изаберите Дyнамицс 365 АИ за увиде клијената.

8. За тип дозволе изаберите делегиране дозволе , а затим изаберите усер_имперсонатион дозволу .

9. Изаберите ставку Додајте дозволе.

10. Изаберите сагласност администратора гранта за... да бисте довршили регистрацију апликације.

11. Да бисте приступили АПИ-у без пријављивања корисника, идите на поставку дозвола апликације сервера на сервер.

ИД апликације/клијента можете да користите за регистрацију ове апликације помоћу Мицрософт библиотеке за потврду идентитета (МСАЛ) да бисте добили ознаку носиоца коју ћете послати АПИ-у.

За информације о коришћењу АПИ-ја у нашим библиотекама клијената погледајте библиотеке клијената "Увид у клијенте".

Постављање дозвола за апликације сервера на сервер

Креирајте регистрацију апликације за коју није потребна интеракција корисника и може се покренути на серверу.

1. На регистрацији апликације на Азуре порталу идите на АПИ дозволе.

2. Изаберите додај дозволу.

3. Изаберите АПИ -је које моја организација користи и са листе одаберите Дyнамицс 365 АИ за увиде клијената.

4. За тип дозволе изаберите дозволе апликације, а затим изаберите дозволу апи.аццесс .

5. Изаберите ставку Додајте дозволе.

6. Вратите се на АПИ дозволе за регистрацију апликације.

7. Изаберите сагласност администратора гранта за... да бисте довршили регистрацију апликације.

8. Додајте име регистрације апликације као корисника у програму Customer Insights - Data.

   1. Отворите Customer Insights - Data, идите на дозволе за > поставке и изаберите ставку Додај кориснике.

   2. Потражите име регистрације апликације, изаберите је из резултата претраге и изаберите ставку Сачувај .

Пробни упити

Да би кратка листа пробних упита ОДата радила са АПИ-јем, погледајте примере упита ОДата.

Customer Insights клијентске библиотеке

Први кораци у коришћењу библиотека клијената доступних за Customer Insights - Data АПИ-је. Сви изворни кôд библиотеке и пробне апликације могу се пронаћи на ГитХуб репо.

C# NuGet

Користите Ц# библиотеке клијената са.орг NuGet. Тренутно је на мети пакета netstandard2.0 и netcoreapp2.0 фрамеwоркс. Више информација о пакету потражите NuGet у чланку Мицрософт.Дyнамицс.ЦустомерИнсигхтс.Апи.

Додајте C# клијентску библиотеку у C# пројекат

1. У Visual Studio програму отворите NuGet управљач пакетима за свој пројекат.

2. Потражите мицрософт.Дyнамицс.ЦустомерИнсигхтс.Апи.

3. Кликните на дугме "Инсталирај" да бисте додали пакет пројекту.

   Друга могућност је да покренете ову команду у конзоли NuGet управљача пакетима : Install-Package -Id Microsoft.Dynamics.CustomerInsights.Api -Source nuget.org -ProjectName <project name> [-Version <version>]

Користите C# клијентску библиотеку

1. Користите Мицрософт библиотеку за потврду идентитета (МСАЛ) да бисте добили AccessToken регистрацију постојеће Азуре апликације.

2. Након успешног потврде идентитета и прибављања симбола, HttpClient направите нови или користите постојећи са подразумеваним индиректним овлашћењима"Ауторизација" постављеним на Носиоца "< ДИЦТ__токен за приступ > аццесс токен " и Оцп-Апим-Претплатнички кључ постављен на претплатни кључ из вашег окружења Customer Insights - Data .

   Успоставите почетне вредности заглавља ауторизације када је то потребно. На пример, када је токен истекао.

3. Пренеси HttpClient ово у конструкцију клијента CustomerInsights .

4. Обавите позиве са клијентом на"методе проширења", на пример, GetAllInstancesAsync. Ако је жељени приступ основној, Microsoft.Rest.HttpOperationResponse користите"хттп методе поруке", на пример, GetAllInstancesWithHttpMessagesAsync.

5. Одговор је вероватно откуцан object зато што метод може да врати више типова (на пример, IList<InstanceInfo> и ApiErrorResult). Да бисте проверили тип повраћаја, користите објекте у типовима одговора наведеним на страници АПИ детаља за ту операцију.

   Ако је потребно више информација о захтеву, користите хттп методе поруке да бисте приступили објекту за сиров одговор.

NodeJS пакет

Користите библиотеке клијента НодеЈС-а доступне путем НПМ-а: https://www.npmjs.com/package/@microsoft/customerinsights

Python пакет

Користите Пyтхон библиотеке клијената доступне преко ПyПи: https://pypi.org/project/customerinsights/