Cung cấp Class Notebook và Site trên quy mô lớn bằng cách sử dụng API Microsoft Graph

Khi Microsoft tăng cường tình trạng bảo mật trên tất cả các sản phẩm và dịch vụ, kể từ tháng 3 năm 2025, đã có những thay đổi đối với chức năng API có thể ảnh hưởng đến những khách hàng trước đây dựa vào quyền chỉ dành cho ứng dụng để cung cấp Class Notebook bằng API.

Bạn vẫn có thể cung cấp site và sổ tay trên quy mô sử dụng Microsoft Graph API bằng cách làm theo phương pháp thay thế được hỗ trợ. Bài viết này trình bày sơ thảo các bước và cung cấp liên kết đến tài liệu liên quan.

Tổng quan

Để tiếp tục cung cấp Class Notebook và site SharePoint trên quy mô lớn:

  1. Sử dụng API CreateEducationClass khi tạo các site mới (một nhóm/site cho mỗi lớp học)
  2. Đối với các site đã có từ trước, hãy sử dụng API CreatePermission SharePoint để cấp quyền AppId cho OneNote Class Notebook đối với site đó.
  3. Sau khi hoàn tất các bước ở trên, chức năng Class Notebook hiện có sẽ được khôi phục và các cuộc gọi API OneNote Class Notebook như GetClassNotebooks, AddTeacher và addStudent sẽ hoạt động như mong đợi. Các cuộc gọi này là một phần của API OneNote Class Notebook, không phải Microsoft Graph.

Hướng dẫn từng bước

1. Tạo các trang web mới với CreateEducationClass

Sử dụng API CreateEducationClass để tạo Nhóm Microsoft 365 mới và trang web SharePoint liên kết cho mỗi lớp học.

  • API này cung cấp Nhóm, Site và các tài nguyên liên quan trong một cuộc gọi.
  • Sau khi site được tạo, bạn có thể sử dụng API hiện có để quản lý sổ ghi chép và quyền.

Tham khảo: Tài liệu API CreateEducationClass

2. Cấp quyền cho các site hiện có

Đối với Nhóm hoặc Site hiện có, bạn phải cấp một cách rõ ràng quyền truy nhập ứng dụng Class Notebook bằng cách sử dụng kiểu quyền Sites.Selected .

Quyền được yêu cầu

  • Truy nhập chỉ trong ứng dụng bằng cách sử dụng phạm vi Sites.Selected.
  • Cấp cho ứng dụng EDU OneNote toàn quyền kiểm soát site.

Yêu cầu Mẫu

POST https://graph.microsoft.com/v1.0/sites/{sitesId}/permissions Content-Type: application/json { "roles": ["fullcontrol"], "grantedToIdentities": [{ "application": { "id": "13291f5a-59ac-4c59-b0fa-d1632e8f3292", //id máy khách của ứng dụng đích "displayName": "EDU OneNote" //Tên hiển thị của ứng dụng đích } }] }

Tham khảo:

Tạo API Quyền

Phát triển các Ứng dụng sử dụng Sites.Các quyền được chọn cho các site SPO

Blog Nhà phát triển Microsoft 365: Kiểm soát quyền truy nhập ứng dụng trên các tuyển tập site SharePoint cụ thể hiện đã có trong Microsoft Graph

3. Sử dụng API hiện có để quản lý sổ tay

Sau khi các quyền được cấu hình đúng, chức năng Class Notebook hiện có, chẳng hạn như các cuộc gọi API OneNote Class Notebook sau đây, sẽ tiếp tục hoạt động như trước đây:

  • GetClassNotebooks

  • AddTeacher

  • Thêm Học viên

  • CreateClassNotebook

    • Lưu ý: như đã mô tả ở trên, đối với các Nhóm/Site mới, hãy sử dụng CreateEducationClass thay vào đó