共用方式為

使用 Customer Insights - Data API

Dynamics 365 Customer Insights - Data 提供 API，可根據您在 Customer Insights 中的資料建置您自己的應用程式。 這些 API 的詳細資料列在 API 參考中。 它們包含有關操作、參數和響應的其他信息。

備註

Customer Insights - 資料表也可以使用 Dataverse API 存取。 我們建議您使用 Dataverse API 來查詢 Customer Insights 資料，因為它們提供更廣泛的篩選、更高的輸送量和更低的延遲。 如需詳細資訊，請參閱適用於 Customer Insights 的 Dataverse API。

開始試用 API

管理員必須啟用對資料的 API 存取。 啟用存取權之後，任何使用者都可以將 API 與訂閱金鑰搭配使用。

  1. 登入 Customer Insights - Data 或 註冊 Customer Insights 試用版。

  2. 移至 設定>許可權 並選取 API 索引標籤。

  3. 如果尚未設定環境的 API 存取權， 請選取 啟用。

    啟用 API 會為您的環境建立主要和次要訂閱金鑰，以用於 API 要求。 若要重新生成金鑰，請在API頁籤中選擇重新生成主要金鑰或重新生成次要金鑰。

  4. 選取 [探索我們的 API] 以試用 API。

  5. 搜尋並選取 API 作業，然後選取 [試用]。

    如何測試 API。

  6. 在側窗格中，將 [授權] 下拉式功能表中的值設定為 [隱含]。 Authorization 標頭會以持有人權杖的方式新增。 您的訂閱金鑰會自動填入。

  7. 或者，新增所有必要的查詢參數。

  8. 捲動至側邊窗格底部，然後選取 [ 傳送]。

    HTTP 回應會顯示在窗格底部。

在 Azure 入口網站中建立新的應用程式註冊

建立新的 應用程式註冊 ，以使用委派的許可權在 Azure 應用程式中使用 API。

  1. 完成 [開始使用] 區段。

  2. 使用可存取 Customer Insights 資料的帳戶登入 Azure 入口網站 。

  3. 搜尋並選取應用程式註冊。

  4. 選取 [ 新增註冊]，提供應用程式名稱，然後選擇帳戶類型。

    可選地，新增重新導向 URL。 http://localhost 足以在本機電腦上開發應用程式。

  5. 選取註冊。

  6. 在新的應用程式註冊中，移至 API 權限。

  7. 選取 新增權限 ，然後在側窗格中選取 Dynamics 365 AI for Customer Insights 。

  8. 針對 [許可類型]，選取 [ 委派的許可權 ]，然後選取 user_impersonation 許可權。

  9. 選取新增權限。

  10. 選取 [授與系統管理員同意... ] 以完成應用程式註冊。

  11. 如要在使用者不登入的情況下存取 API，請移至 設定伺服器對伺服器應用程式權限。

您可以使用應用程式/用戶端識別碼來向 Microsoft 驗證程式庫 （MSAL） 註冊此應用程式，以取得持有人權杖，以隨您的要求傳送至 API。

如需在用戶端程式庫中使用 API 的資訊，請參閱 Customer Insights 用戶端程式庫。

設定伺服器對伺服器應用程式權限

建立不需要使用者互動且可在伺服器上執行的應用程式註冊。

  1. 在 Azure 入口網站 中的應用程式註冊上，移至 [API 許可權]。

  2. 選取新增權限。

  3. 選取 我的組織使用的 API 索引標籤，然後從清單中選擇 Dynamics 365 AI for Customer Insights 。

  4. 針對 [許可類型]，選取 [ 應用程式許可權 ]，然後選取 api.access 許可權。

  5. 選取新增權限。

  6. 返回應用程式註冊的 API 權限 。

  7. 選取 [授與系統管理員同意... ] 以完成應用程式註冊。

  8. 將應用程式註冊名稱新增為 Customer Insights - Data 中的使用者。

    1. 開啟 Customer Insights - Data，移至 設定>權限， 然後選取 新增使用者。

    2. 搜尋您的應用程式註冊名稱，從搜尋結果中選取它，然後選取 [儲存]。

範例查詢

如需使用 API 的 OData 範例查詢簡短清單，請參閱 OData 查詢範例。

Customer Insights 用戶端程式庫

開始使用 Customer Insights - Data API 可用的用戶端程式庫。 所有程式庫原始程式碼和範例應用程式都可以在 GitHub 存放庫中找到。

C# NuGet

使用 NuGet.org 中的 C# 用戶端程式庫。目前，該套件以 netstandard2.0 和 netcoreapp2.0 架構為目標。 如需 NuGet 套件的詳細資訊，請參閱 Microsoft.Dynamics.CustomerInsights.Api。

將 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>]

使用 C# 用戶端程式庫

  1. 使用 Microsoft 驗證程式庫 (MSAL) 取得 AccessToken 使用現有的 Azure 應用程式註冊。

  2. 成功驗證並獲取權杖後，建構新的或使用現有的 HttpClient，在其中將 DefaultRequestHeaders "Authorization" 設定為 Bearer "access token"，並將 Ocp-Apim-Subscription-Key 設定為您在 Customer Insights - Data 環境中的訂閱金鑰。

    適當時重設 授權 標頭。 例如，當權杖過期時。

  3. 將此 HttpClient 傳遞至 CustomerInsights 客戶端的構建中。

  4. 使用客戶端來呼叫「擴充方法」，例如 GetAllInstancesAsync。 如果偏好存取基礎 Microsoft.Rest.HttpOperationResponse ，請使用「http 訊息方法」，例如 GetAllInstancesWithHttpMessagesAsync。

  5. 回應可能是 object 類型，因為方法可以傳回多個類型 （例如 和 IList<InstanceInfo>ApiErrorResult）。 若要檢查傳回類型，請使用該作業的 API 詳細資料頁面 上指定的回應類型中的物件。

    如果需要要求的詳細資訊，請使用 http 訊息方法 來存取原始回應物件。

NodeJS 套件

使用透過 NPM 提供的 NodeJS 用戶端程式庫： https://www.npmjs.com/package/@microsoft/customerinsights

Python 套件

使用透過 PyPi 提供的 Python 用戶端程式庫： https://pypi.org/project/customerinsights/

  • Last updated on