使用 Microsoft Graph API
所有這些不同服務的 API 透過一個名為 Microsoft Graph 的工具連線起來。它提供了一種使用多個 API 的單一方法,使用者只需登入一次即可訪問所有服務 API。如果您想直接訪問一些核心 API,則需要分別為每個 API 註冊。Microsoft Graph 有效地促進了開發者對 API 的使用。
使用 Microsoft Graph API,我們可以訪問多個相關實體,例如 Microsoft 365 組、Teams 團隊以及 SharePoint 文件庫中的文件。例如,Microsoft 365 組和 SharePoint 團隊站點共享主文件庫。當您透過其站點物件檢索有關文件庫的資訊時,您還會發現該組的 ID。實體資訊可以透過多種方法檢索,可以透過直接查詢它們或使用相關實體來訪問它們。例如,這兩個 URL 將提供有關同一團隊的資訊;第二個 URL 檢索底層的 Microsoft 365 組,然後是其連結的團隊,而第一個 URL 使用團隊物件的 ID 作為直接引用(相關組和團隊具有相同的 ID)。
學習 Microsoft Graph API 的好處
Office 365 是 Microsoft Office 產品,在全球範圍內使用最為廣泛。Microsoft Graph API 有益於商業版本的 Microsoft Office 365 套件,或者其一個或多個元件,如 Outlook、OneNote 等,被數百萬使用者使用。
在任何辦公室中,使用者通常會花費 2 到 3 個小時在各種 Office 套件應用程式(如 Outlook、Excel、Project 等)上工作。Outlook 每天都會建立數百萬封全新的電子郵件、事件和其他專案,而 OneDrive 則託管著數百萬個檔案。如果您希望訪問儲存在 Office 365 或 Azure 中的資料,則需要 MS Graph API。
Graph 資源管理器
提供了一個名為 Graph 資源管理器的基於瀏覽器的應用程式,以幫助使用者瞭解有關 Graph 的更多資訊。使用此工具,您可以使用示例租戶或登入到您的租戶以簡單地對 Graph 進行呼叫。您可以快速建立必要的 HTTP 查詢,並在瀏覽器中直接檢視結果。您可以使用它來快速檢查您的查詢是否格式正確,檢視您期望獲取的資料是否存在,上面提到的 beta 和 v1.0 端點是否以相同的方式執行,或者版本之間是否存在更改。
在使用 Graph 資源管理器之前,租戶管理員必須批准應用程式在租戶內部的使用,並且通常還必須批准使用該工具執行必要任務所需的許可權。只有管理員或所有使用者才能提供他們使用任何內容的許可權。
呼叫 Microsoft Graph API
您可以透過以下方式在您的應用程式中整合 Graph:
在您的程式碼中建立一個 HTTP 請求,然後立即呼叫 Graph。在您的應用程式之前放置一個 SDK 到 Graph 前面。SDK 的目的是進一步簡化已經簡單的 API 訪問過程。以下系統和語言目前提供 SDK:Android、Angular、ASP.NET、iOS、Javascript、Node.js、Java、PHP、PowerShell、Python 和 Ruby。
此外,具有內建 Microsoft Graph 整合的 UI 元素可以在名為 Microsoft Graph Toolkit 的軟體包中找到。
可以使用 MS Graph API 訪問的元件
以下是可以使用 API 訪問的關鍵 Microsoft Graph 部分:
Exchange 伺服器和郵件(Outlook 帳戶)。
用於計劃和組織事件的日曆。
Office365 文件管理系統,用於文字處理器、電子表格和其他型別的文件。
Office 365 Planner API 允許您構建任務、新增將參與任務的個人,然後在利益相關者之間執行工作流。
您可以使用 Microsoft One Drive 儲存或 Sharepoint 文件庫以各種格式共享檔案和媒體。
個人或網路組之間的對話和訊息。
快速訪問 Microsoft One Notes。
使用 Sharepoint 訪問資料。
如果沒有任何內建格式適合您的需求,Microsoft Graph 使您可以自由建立自己的資料格式。
Microsoft Graph API 可用於推送通知。
身份驗證
目標是從 Azure AD 獲取訪問令牌,然後必須將其放在傳送到 Microsoft Graph 的每個 HTTP 請求的 Authorization 標頭中。您可以在訪問令牌中找到您被允許使用 Microsoft Graph 執行的操作。
在應用程式註冊設定中建立許可權時,我們應該始終堅持最小許可權原則,這意味著我們應該只同意基本許可權。因此,當您從 Graph 說明中檢查所需的範圍時,首選始終提供最少的許可權。
在我們根據我們選擇使用的 OAuth 流程的要求配置應用程式註冊後,現在該向應用程式新增一些與身份驗證相關的邏輯了。對於更簡單的過程,您可以使用提供身份驗證技術的庫,或者可以使用直接的 REST 請求進行身份驗證。
結論
新的面向服務的架構,即 Microsoft Graph(由 Microsoft 擁有),以前稱為 Office 365 統一 API,使開發人員能夠訪問來自 Microsoft 雲平臺的大量資料。最後,您應該知道,根據目前的統計資料,81% 的財富 500 強企業在其系統中使用 Microsoft Graph。這是 Microsoft Graph 是一項在未來幾年具有巨大潛力的技術的可靠證據。