Microsoft Graph API - Bạn đã biết gì về nó chưa?

Bài đăng này đã không được cập nhật trong 3 năm

1. Giới thiệu về Microsoft Graph

Microsoft Graph là một cổng dữ liệu trong Microsoft 365. Nó cung cấp một mô hình lập trình thống nhất mà chúng ta có thể sử dụng để truy cập vào kho dữ liệu nằm trong MicroSoft 365, Window 10 và Enterprise Mobility + Security. Một cách đơn giản chúng ta có thể hiểu được đây như là một kho lưu trữ dữ liệu mà chúng ta có thể upload, download file từ đó, giống với Aws s3 hoặc google drive.

Tuy nhiên điểm mạnh của Microsoft Graph là nó được tích hợp thêm những tính năng của Microsoft 365 cho phép chúng ta có thể làm thao tác trực tiếp với file trên kho lưu trữ dễ dàng, đặc biệt là với những file tài liệu như word, pdf, excel, ...

Microsoft Graph API cung cấp endpoint https://graph.microsoft.com để cung cấp quyền truy cập vào kho lưu trữ và sử dụng các dịch vụ của Microsoft 365. Chúng ta có thể sử dụng Rest APIs hoặc SDK để truy cập endpoint và xây dựng ứng dụng. Microsoft Graph cũng bao gồm những services mạnh mẽ giúp quản lý người dùng và thiết bi, quyền truy cập, bảo mật để bảo vệ dữ liệu.

Nhìn qua có thể thấy Microsoft Graph cung cấp rất nhiều services, tuy nhiên trong bài viết này mình sẽ chỉ giới thiêu cách sử dụng Microsoft Graph API thông qua vài API đơn giản về quản lý file qua microsoft 365

2. Sử dụng Microsoft Graph API

Tạo một ứng dụng trên Micrososft Azure

Trước hết chúng ta cần tài khoản để đăng nhập vào trang web https://portal.azure.com/#home, ai chưa có tài khoản thì tạo 1 tài khoản bằng email của mình nhé

Sau khi tạo tài khoản xong chúng ta tìm phần Manage Azure Active Directory -> View

Tại đây ta cần phải đăng ký 1 app: App registrations -> Register an application.

Nhập thông tin app cần đăng ký rồi ấn register

Sau khi đăng ký xong, chúng ta đã có thông tin app bao gồm Application (client) ID, Directory (tenant) ID
Để có thể sử dụng đc API truy cập vào tenant, ta cần có thêm secret key nữa, cách lấy secret_key như sau:

Từ menu chọn Certificates & secrets -> New client secret -> điền description + chọn Expires -> Add. Secret key sẽ hiện ra bên dưới.
Chúng ta cần add tài khoản vào tenant vừa tạo để có thể thao tác với nó, User -> New User, điền thông tin và tạo tài khoản

sau khi đã tạo xong tài khoản, ta add tài khoản vào app:

vào Owners -> add owners chọn user mới thêm

Về cơ bản từ đây chúng ta đã có thể thao tác cơ bản với Microsoft Graph APi rồi, thử 1 vài API nhé

config enviroment cho Postman, khởi tạo giá trị cho từng trường ứng với thông tin app vừa đăng ký nhé

Lấy access token nào: link end_point https://login.microsoftonline.com/{{TenantID}}/oauth2/v2.0/token

Như vậy là chúng ta đã lấy được access token của Graph API, sau này chúng ta có thể sử dụng những tính năng khác như microsoft 365 nhưng yêu cầu trả phí, bạn nào muốn thử có thể sử dụng thử khi microsoft 365 cho phép sử dụng thử.

Nếu muốn sử dụng các tính năng của microsoft 365 thì chúng ta cần có licenses 365 E3, chúng ta có thể kích hoạt dùng thử trên trang chủ https://www.office.com/

Sau khi có licenses ta có thể sử dụng một số API khác như get root, upload file, convert file. Mọi người có thể đọc thêm tại đây https://docs.microsoft.com/en-us/graph/api/overview?toc=./ref/toc.json&view=graph-rest-1.0