Радите са Customer Insights API-јем

Dynamics 365 Customer Insights пружа API-је за изградњу властитих апликација заснованих на подацима у услузи Customer Insights.

Важно

Детаљи ових API-ја наведени су у чланку Референца Customer Insights API-ја. Садрже додатне информације о операцијама, параметрима и одговорима.

Овај чланак вас води кроз приступ Customer Insights API-јима, креирање регистрације Azure апликације и помаже вам да започнете са доступним клијентским библиотекама.

Започните уз испробавање Customer Insights API-ја

  1. Пријавите се у Customer Insights. Ако још увек немате претплату, пријавите се за пробну верзију услуге Customer Insights.

  2. Да бисте омогућили API-је у вашем Customer Insights окружењу, идите на Администратор > Дозволе. За то ће вам требати дозволе администратора.

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

    Омогућавање Customer Insights API-ја

  4. Изаберите Истражите наше API-је да испробате API-је.

  5. Изаберите операцију API-ја и изаберите Испробајте.

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

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

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

HTTP одговор ће се ускоро појавити испод.

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

Ови кораци помажу вам да започнете са коришћењем Customer Insights API-ја у Azure апликацији користећи делегиране дозволе. Обавезно прво завршите одељак Започните.

  1. Пријавите се на Azure портал помоћу налога који може приступити Customer Insights подацима.

  2. С леве стране изаберите Регистрације апликација.

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

  4. На новој регистрацији апликације идите на Дозволе за API-је.

  5. Изаберите Додајте дозволу и изаберите Customer Insights у бочном окну.

  6. За Тип дозволе, изаберите Делегиране дозволе и изаберите дозволу user_impersonation.

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

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

Можете да користите ID апликације/клијента за регистрацију ове апликације у Microsoft Authentication Library (MSAL) да бисте добили токен носиоца који ћете са захтевом послати у API.

За више информација о MSAL-у, погледајте Преглед Microsoft Authentication Library (MSAL).

За више информација о регистрацији апликација у услузи Azure погледајте Ново искуство регистрације апликација за Azure портал.

За информације о коришћењу API-ја и наших клијентских библиотека, погледајте Customer Insights клијентске библиотеке.

Дозволе за апликације са сервера на сервер

Одељак за регистрацију апликација описује како се региструје апликација која захтева да се корисник пријави ради потврде идентитета. Сазнајте како да креирате регистрацију апликације која не захтева интеракцију корисника и која се може покренути на серверу.

  1. При регистрацији апликације на Azure порталу идите на Дозволе за API-је.

  2. Изаберите Додајте дозволу и изаберите Customer Insights у бочном окну.

  3. За Тип дозволе, изаберите Дозволе за апликације и изаберите дозволу CustomerInsights.Api.All.

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

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

    1. Инсталирајте Azure Active Directory (AD) PowerShell модул: Install-Module -Name AzureAD -AllowClobber -Scope AllUsers
    2. Повежите се на AD налог: Connect-AzureAD -TenantId <your tenant id>. Можете пронаћи свој ID закупца Преглед > Azure Active Directory.
    3. Покрените следећу команду да бисте додали Azure AD принципал услуге: New-AzureADServicePrincipal -AppId "38c77d00-5fcb-4cce-9d93-af4738258e3c" -DisplayName "Microsoft Dynamics 365 Customer Insights" Параметар AppId односи се на апликацију Customer Insights API.

    Узорак принципала услуге

  6. На новој регистрацији апликације вратите се на Дозволе за API-је.

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

  8. Да закључимо, морамо да додамо име регистрације апликације као корисника у Customer Insights.
    Отворите Customer Insights, идите на Администратор > Дозволе и изаберите Додај корисника.

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

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

Овај одељак вам помаже да започнете коришћење клијентских библиотека доступних за Customer Insights API-је.

C# NuGet

Сазнајте како да започнете коришћење C# клијентских библиотека са NuGet.org. За више информација о NuGet пакету, видите Microsoft.Dynamics.CustomerInsights.Api. Тренутно овај пакет циља оквире netstandard2.0 и netcoreapp2.0.

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

  1. У програму Visual Studio, отворите NuGet менаџер пакета за пројекат.

  2. Потражите Microsoft.Dynamics.CustomerInsights.Api.

  3. Изаберите Инсталирај за додавање пакета у пројекат. Алтернативно, покрените ову команду у NuGet конзоли менаџера пакета:Install-Package -Id Microsoft.Dynamics.CustomerInsights.Api -Source nuget.org -ProjectName <project name> [-Version <version>]

    Додајте NuGet пакет у Visual Studio пројекат

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

  1. Користите Microsoft Authentication Library (MSAL) да бисте добили AccessToken користећи своје постојећу регистрацију Azure апликације.

  2. Након успешне потврде идентитета и прибављања токена, направите нови или користите постојећи HttpClient са додатним DefaultRequestHeaders "Authorization" подешеним на Носилац и Ocp-Apim-Subscription-Key подешеним на кључ претплате из вашег Customer Insights окружења.
    Ресетујте заглавље Овлашћење по потреби. На пример, када је токен истекао.

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

    Узорак httpclient-а

  4. Позивајте са клијентом за „методе продужења“, на пример, GetAllInstancesAsync. Ако је потребан приступ основном Microsoft.Rest.HttpOperationResponse, користите „http методе порука“, на пример, GetAllInstancesWithHttpMessagesAsync.

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