Motimate：如何整合 Motimate Public API 到 PowerBI？

您希望您的 Motimate 資料總是有即時更新的儀表板和分析嗎？不用再找了 - 使用我們的公開 API，您可以將所有 API 資料直接導入 Microsoft 的 PowerBI 等工具。在此我們將教您如何設定！ ✨

在繼續之前，請確認您的 MotiSpace 已啟用 Public API。如果沒有，請這裡.

在 Postman 中產生存取權限

• 開啟 Postman並對驗證端點進行 POST API 呼叫以取得標記。
   
• 複製已產生的權標，供 PowerBI 暫時使用。

現在使用存取權限在 PowerBI 中擷取資料

• 開啟 Power BI 並按一下Get Data--> SelectWeb--> 按一下Connect。
  
  
   
• 在 Web 連線視窗中，選取進階。
   
• 貼上資料來源的 API URL
  即https://motimateapp.com/public_api/my_organization
   
• 在標頭部分，新增：
  • 鑰匙：授權
  • 值："Bearer <<Token generated from Postman>>"
    
    
     
• 按一下「確定」繼續。

Power Query Editor 將會開啟，顯示擷取的資料。

建立查詢以動態產生代號

由於 Motimate Public API 令牌會在 24 小時後過期，PowerBI 必須在每次 API 呼叫前動態產生新的令牌，以確保令牌永遠有效。可以按照以下步驟進行設定：

• 在 Power Query Editor 中，按一下New Source--> Blank Query。
  
  
  
  
• 開啟空白查詢後，進入Advanced Editor。
  
  
  
  
• 輸入下列 Power Query M 查詢，並以您自己的憑證取代 粗體文字：
  
  

  let
  url ="https://motimateapp.com/public_api/oauth/token",
  headers = [#"Content-Type" = "application/json"],
  postData = Json.FromValue([
  
  client_id="<<your client ID>>",
  client_secret="<<your client secret>>",
  grant_type="client_credentials"
  
  ]),
  response = Web.Contents(
  url,
  [
  Headers = headers,
  Content = postData
  ]
  ),
  Data = Json.Document(response),
  access_token = Data[access_token]
  in
  access_token
  
  

• 點選 完成。
  
   
• 驗證所應用的步驟，以確認正在產生一個令牌：
  
  

將查詢轉換為函式

• 現在將查詢重新命名為 "GetToken"。
  
  
   
• 在 GetToken 上按一下滑鼠右鍵，開啟進階編輯器
  
  
  
   
• 修改查詢，在開頭加入 "() => 「( 在 」let" 之前)。這會將查詢轉換為函式。
  
  
   
• 點選 完成。

以功能取代硬體編碼的存取權限

• 在Advanced Editor（進階編輯器）中開啟主資料集查詢。
  
  
   
• 在 "Headers "部分找到硬編碼的令牌，並使用 GetToken() 函式取代令牌本身。現在應該是這樣的：
  
  Authorization = "Bearer "&GetToken()
  (確保在字詞 Bearer 與尾部引號之間留有空格，如上所示)
  
  
   
• 點選 完成。
• 最後，按一下關閉 & Apply。
  
  

恭喜你您在 PowerBI 中設定了一個具有動態符號邏輯的報告🎉。

現在，PowerBI 會在每次 API 呼叫之前動態產生一個 token，確保資料更新無縫進行，無需手動介入。此方法可簡化資料檢索並提高自動化程度。