Megosztás a következőn keresztül:

Customer Insights - Data API-k használata

  • Cikk

Dynamics 365 Customer Insights - Data API-kat biztosít saját alkalmazások létrehozásához a Customer Insights adatai alapján. Az API-k részletei az API-referenciában vannak felsorolva. További információkat tartalmaznak a műveletekről, a paraméterekről és a válaszokról.

Feljegyzés

Customer Insights - Data A táblák API-k használatával Dataverse is elérhetők. Javasoljuk, hogy API-kat használjon Dataverse a Customer Insights-adatok lekérdezéséhez, mivel ezek kiterjedtebb szűrést, nagyobb átviteli sebességet és alacsonyabb késést kínálnak. További információ: Dataverse API-k a Customer Insightshoz.

Az API-k kipróbálásának első lépései

A rendszergazdának engedélyeznie kell az API-hozzáférést az adatokhoz. A hozzáférés engedélyezése után bármely felhasználó használhatja az API-t az előfizetői kulccsal.

  1. jelentkezzen be a Customer Insights próbaverziójába Customer Insights - Data , vagy regisztráljon rá.

  2. Lépjen a Beállítások>Engedélyek elemre, és válassza az API-k lapot.

  3. Ha a környezethez való API-hozzáférés nincs beállítva, válassza az Engedélyezés lehetőséget.

    Az API-k engedélyezése létrehoz egy elsődleges és másodlagos előfizetői kulcsot a környezethez, amely az API-kérelmekben lesz használva. A kulcsok újragenerálásához válassza az Elsődleges újragenerálása vagy a Másodlagos újragenerálása lehetőséget az API-k lapon.

  4. Válassza az API-k felfedezése lehetőséget az API-k kipróbálásához.

  5. Keressen és válasszon ki egy API-műveletet, majd válassza a Kipróbálom lehetőséget .

    Az API-k tesztelése.

  6. Az oldalsó ablaktáblán állítsa az Engedélyezés legördülő menü értékét implicit értékre. A Authorization fejléc egy tulajdonosi jogkivonattal lesz hozzáadva. A rendszer automatikusan kitölti az előfizetői kulcsot.

  7. Tetszés szerint hozzáadhatja az összes szükséges lekérdezési paramétert.

  8. Görgessen az oldalsó panel aljára, és válassza a Küldés lehetőséget.

    A HTTP-válasz a panel alján jelenik meg.

Hozzon létre egy új alkalmazásregisztrációt az Azure Portalon

Hozzon létre egy új alkalmazásregisztrációt , amely delegált engedélyekkel használja az API-kat egy Azure-alkalmazásban.

  1. Töltse ki az Első lépések szakaszt.

  2. Jelentkezzen be az Azure Portalra azzal a fiókkal, amely hozzáfér a Customer Insights-adatokhoz.

  3. Keresse meg, majd válassza Alkalmazásregisztrációk .

  4. Válassza az Új regisztráció lehetőséget, adja meg az alkalmazás nevét, és válassza ki a fiók típusát.

    Ha szeretne, megadhat egy átirányítási URL-címet. http://localhost elegendő egy alkalmazás fejlesztéséhez a helyi számítógépen.

  5. Válassza a Regisztrálás lehetőséget.

  6. Az új Alkalmazásregisztrációban lépjen az API-engedélyek elemre.

  7. Válassza az Engedély hozzáadása lehetőséget , majd válassza a Dynamics 365 AI for Customer Insights lehetőséget az oldalsó ablaktáblán.

  8. Az Engedély típusa beállításnál válassza a Delegált engedélyeklehetőséget , majd válassza ki a user_impersonation engedélyt.

  9. Jelölje be az Engedélyek hozzáadása lehetőséget.

  10. Válassza a Rendszergazdai jóváhagyás megadása a... az alkalmazásregisztráció befejezéséhez.

  11. Ha felhasználó bejelentkezése nélkül szeretné elérni az API-t, lépjen a kiszolgálók közötti alkalmazásengedélyek beállítása részre.

Az alkalmazásregisztrációhoz tartozó alkalmazás-/ügyfél-azonosítóval a Microsoft Authentication Libraryben (MSAL) beszerezhet egy tulajdonosi jogkivonatot, amely elküldhető az API-nak küldött kéréssel.

Az API-k ügyfélkódtárakban való használatával kapcsolatos információkért lásd: Customer Insights ügyfélkódtárak.

Kiszolgálók közötti alkalmazásengedélyek beállítása

Hozzon létre egy alkalmazásregisztrációt, amely nem igényel felhasználói beavatkozást, és futtatható egy kiszolgálón.

  1. A Azure Portal alkalmazásregisztrációjában lépjen az API-engedélyek elemre.

  2. Válassza az Engedély hozzáadása lehetőséget.

  3. Válassza ki a szervezetem által használt API-k lapot, és válassza a Dynamics 365 AI for Customer Insights lehetőséget a listából.

  4. Az Engedély típusa beállításnálválassza az Alkalmazásengedélyek lehetőséget , majd válassza ki a api.access engedélyt.

  5. Jelölje be az Engedélyek hozzáadása lehetőséget.

  6. Térjen vissza az alkalmazásregisztráció API-engedélyeihez .

  7. Válassza a Rendszergazdai jóváhagyás megadása a... az alkalmazásregisztráció befejezéséhez.

  8. Adja hozzá az alkalmazásregisztráció nevét felhasználóként Customer Insights - Data.

    1. Nyissa meg Customer Insights - Data, lépjen a Beállítások>Engedélyek elemre, és válassza a Felhasználók hozzáadása lehetőséget .

    2. Keresse meg az alkalmazásregisztráció nevét, válassza ki a keresési eredmények közül, majd válassza a Mentés lehetőséget .

Minta lekérdezések

Az API-kkal való munkához szükséges OData-mintalekérdezések rövid listájáért lásd : OData-lekérdezési példák.

Customer Insights ügyféloldali tárak

Első lépések az Customer Insights - Data API-khoz elérhető ügyfélkódtárak használatával. Az összes kódtárforráskód és mintaalkalmazás megtalálható egy GitHub-adattárban.

C# NuGet

Használja a C# ügyfélkódtárakat from.org NuGet. A csomag jelenleg a netstandard2.0 és a netcoreapp2.0 keretrendszert célozza meg. További információ a NuGet csomagról: Microsoft.Dynamics.CustomerInsights.Api.

C# ügyféloldali függvénytár hozzáadása C#-projekthez

  1. Nyissa Visual Studio meg a NuGet projekt Csomagkezelőjét .

  2. Keressen rá a Microsoft.Dynamics.CustomerInsights.API kifejezésre.

  3. Válassza a Telepítés lehetőséget a csomag projekthez való hozzáadásához.

    Másik lehetőségként futtassa ezt a parancsot a NuGet Csomagkezelő konzolon: Install-Package -Id Microsoft.Dynamics.CustomerInsights.Api -Source nuget.org -ProjectName <project name> [-Version <version>]

A C# ügyféloldali függvénytár használata

  1. A Microsoft Authentication Library (MSAL) használatával lekért egy AccessTokenmeglévő Azure-alkalmazásregisztrációt.

  2. A jogkivonat sikeres hitelesítése és beszerzése után hozzon létre egy újat, vagy használjon egy meglévőt HttpClient a DefaultRequestHeaders "Authorization" beállítással Bearer "hozzáférési token" , és Ocp-Apim-Subscription-Key a környezet előfizetői kulcsára Customer Insights - Data van állítva.

    Ha szükséges, állítsa alaphelyzetbe az Authorization fejlécet. Ha például a token lejárt.

  3. Adja át ezt HttpClient az CustomerInsights ügyfél építésébe.

  4. Kezdeményezzen hívásokat az ügyféllel például a "kiterjesztési módszerekhez GetAllInstancesAsync". Ha előnyben részesíti az alapul szolgáló eszközhöz Microsoft.Rest.HttpOperationResponse való hozzáférést, használja például a "http message metódusokat". GetAllInstancesWithHttpMessagesAsync

  5. A válasz valószínűleg object típusú, mert a metódus több típust is visszaadhat (például és IList<InstanceInfo> ). ApiErrorResult A visszatérési típus ellenőrzéséhez használja az adott művelet API-részletek lapján megadott választípusok objektumait.

    Ha további információra van szükség a kéréssel kapcsolatban, használja a http message metódusokat a nyers válasz objektum eléréséhez.

NodeJS-csomag

Használja az NPM-en keresztül elérhető NodeJS-ügyfélkódtárakat: https://www.npmjs.com/package/@microsoft/customerinsights

Python-csomag

Használja a PyPi-n keresztül elérhető Python-ügyfélkódtárakat: https://pypi.org/project/customerinsights/