Deli putem

Rad sa Customer Insights - Data API-jima

  • Članak

Dynamics 365 Customer Insights - Data obezbeđuje API-je za izradu sopstvenih aplikacija na osnovu vaših podataka u uvidima klijenata. Detalji ovih API-ja su navedeni u API referenci. Sadrže dodatne informacije o operacijama, parametrima i odgovorima.

Belešku

Customer Insights - Data tabelama se takođe može pristupiti pomoću Dataverse API-ja. Preporučujemo da koristite Dataverse API-je za upit podataka "Uvid u korisnike" jer nude opsežnije filtriranje, veću protok i manju kašnjenje. Više informacija potražite u članku Dataverse API-ja za uvide klijenata.

Prvi koraci u pokušaju API-ja

Administrator mora da omogući API pristup vašim podacima. Kada se omogući pristup, svaki korisnik može da koristi API sa ključem za pretplatu.

  1. prijavite se ili Customer Insights - Data se prijavite za probnu verziju korisničkih uvida.

  2. Idite na dozvole>za postavke i izaberite karticu API.

  3. Ako API pristup okruženju nije podešen, izaberite opciju Omogući .

    Omogućavanjem API-ja kreira se primarni i sekundarni pretplatni ključ za vaše okruženje koji se koristi u API zahtevima. Da biste ponovo generisali ključeve, na kartici "APIS" izaberite stavku "Regeneriši primarnu ili regeneriši sekundarnu" .

  4. Izaberite stavku Istražite naše API-je da biste isprobali API-je.

  5. Potražite i izaberite API operaciju i izaberite pokušajte .

    Kako testirati API.

  6. U bočnom oknu postavite vrednost u padajućem meniju Autorizacije na implicitnu. Zaglavlje Authorization se dodaje sa oznakom nosioca. Ključ za pretplatu se automatski popunjava.

  7. Po želji dodajte sve potrebne parametre upita.

  8. Pomerite se na dno bočnog okna i izaberite pošalji .

    HTTP odgovor se prikazuje na dnu okna.

Napravite novu registraciju aplikacije na Azure portalu

Kreirajte novu registraciju aplikacije da biste koristili API-je u Azure aplikaciji koristeći delegirane dozvole.

  1. Dovršite odeljak Prvi koraci.

  2. Prijavite se na Azure portal sa nalogom koji može da pristupi podacima "Uvidi kupaca".

  3. Potražite, a zatim izaberite stavke Registracije aplikacija.

  4. Izaberite novu registraciju, navedite ime aplikacije i odaberite vrstu naloga.

    Opcionalno dodajte URL preusmeravanja. http://localhost je dovoljno za razvoj aplikacije na lokalnom računaru.

  5. Izaberite Registracija.

  6. Pri novoj registraciji aplikacije idite na API dozvole.

  7. U bočnom oknu izaberite stavku Dodaj dozvolu i izaberite Dynamics 365 AI za uvide klijenata.

  8. Za tip dozvole izaberite delegirane dozvole , a zatim izaberite user_impersonation dozvolu .

  9. Izaberite stavku Dodajte dozvole.

  10. Izaberite saglasnost administratora granta za... da biste dovršili registraciju aplikacije.

  11. Da biste pristupili API-u bez prijavljivanja korisnika, idite na postavku dozvola aplikacije servera na server.

ID aplikacije/klijenta možete da koristite za registraciju ove aplikacije pomoću Microsoft biblioteke za potvrdu identiteta (MSAL) da biste dobili oznaku nosioca koju ćete poslati API-u.

Za informacije o korišćenju API-ja u našim bibliotekama klijenata pogledajte biblioteke klijenata "Uvid u klijente".

Postavljanje dozvola za aplikacije servera na server

Kreirajte registraciju aplikacije za koju nije potrebna interakcija korisnika i može se pokrenuti na serveru.

  1. Na registraciji aplikacije na Azure portalu idite na API dozvole.

  2. Izaberite dodaj dozvolu.

  3. Izaberite API-je koje moja organizacija koristi i sa liste odaberite Dynamics 365 AI za uvide klijenata.

  4. Za tip dozvole izaberite dozvole aplikacije, a zatim izaberite dozvolu api.access .

  5. Izaberite stavku Dodajte dozvole.

  6. Vratite se na API dozvole za registraciju aplikacije.

  7. Izaberite saglasnost administratora granta za... da biste dovršili registraciju aplikacije.

  8. Dodajte ime registracije aplikacije kao korisnika u programu Customer Insights - Data.

    1. Otvorite Customer Insights - Data, idite na dozvole za>postavke i izaberite stavku Dodaj korisnike.

    2. Potražite ime registracije aplikacije, izaberite je iz rezultata pretrage i izaberite stavku Sačuvaj .

Probni upiti

Da bi kratka lista probnih upita OData radila sa API-jem, pogledajte primere upita OData.

Customer Insights klijentske biblioteke

Prvi koraci u korišćenju biblioteka klijenata dostupnih za Customer Insights - Data API-je. Svi izvorni kôd biblioteke i probne aplikacije mogu se pronaći na GitHub repo.

C# NuGet

Koristite C# biblioteke klijenata sa.org NuGet. Trenutno je na meti paketa netstandard2.0 i netcoreapp2.0 frameworks. Više informacija o paketu potražite NuGet u članku Microsoft.Dynamics.CustomerInsights.Api.

Dodajte C# klijentsku biblioteku u C# projekat

  1. U Visual Studio programu otvorite NuGet upravljač paketima za svoj projekat.

  2. Potražite microsoft.Dynamics.CustomerInsights.Api.

  3. Kliknite na dugme "Instaliraj" da biste dodali paket projektu.

    Druga mogućnost je da pokrenete ovu komandu u konzoli NuGet upravljača paketima: Install-Package -Id Microsoft.Dynamics.CustomerInsights.Api -Source nuget.org -ProjectName <project name> [-Version <version>]

Koristite C# klijentsku biblioteku

  1. Koristite Microsoft biblioteku za potvrdu identiteta (MSAL) da biste dobili AccessToken registraciju postojeće Azure aplikacije.

  2. Nakon uspešnog potvrde identiteta i pribavljanja simbola, HttpClient napravite novi ili koristite postojeći sa "DefaultRequestHeaders" "Autorizacija" postavljenim na "Bearer " token za pristup" i Ocp-Apim-Subscription-Key postavljen na pretplatnički ključ iz vašeg okruženja Customer Insights - Data .

    Uspostavite početne vrednosti zaglavlja autorizacije kada je to potrebno. Na primer, kada je token istekao.

  3. Prenesi HttpClient ovo u konstrukciju klijenta CustomerInsights .

  4. Obavite pozive sa klijentom na "metode proširenja", na primer, GetAllInstancesAsync. Ako je željeni pristup osnovnoj, Microsoft.Rest.HttpOperationResponse koristite "http metode poruke", na primer, GetAllInstancesWithHttpMessagesAsync.

  5. Odgovor je verovatno otkucan object zato što metod može da vrati više tipova (na primer, IList<InstanceInfo> i ApiErrorResult). Da biste proverili tip povraćaja, koristite objekte u tipovima odgovora navedenim na stranici API detalja za tu operaciju.

    Ako je potrebno više informacija o zahtevu, koristite http metode poruke da biste pristupili objektu za sirov odgovor.

NodeJS paket

Koristite biblioteke klijenta NodeJS-a dostupne putem NPM-a: https://www.npmjs.com/package/@microsoft/customerinsights

Python paket

Koristite Python biblioteke klijenata dostupne preko PyPi: https://pypi.org/project/customerinsights/