教育版 API 概述Education API overview

Microsoft Graph 中的教育版 API 可增强 Office 365 资源和与教育情景相关的信息,其中包括有关学校、课程、用户(学生和教师)、作业以及订阅信息。The education API in Microsoft Graph enhances Office 365 resources with information that is relevant for education scenarios, including information about schools, classes, users (students and teachers), assignments, and submissions. 这使你能够轻松构建与各种学校和课堂情景的教育资源集成的解决方案。This makes it easy for you to build solutions that integrate with educational resources for various school and classroom scenarios.

Microsoft Graph 中的教育版 API 提供对课程、学校、用户、作业、提交等的访问。The education API in Microsoft Graph provides access to classes, schools, users, assignments, submissions and more.

EDU Graph 概述

为什么与教育情景集成?Why integrate with education scenarios?

构建了解班级名册的应用程序Build applications that are aware of class roster

大多数教育软件开发人员在早期便了解到,此班级名册是运行其应用程序所需的关键信息之一,而且它通常被锁定在学校的学生信息系统 (SIS) 中。Most education software developers learn early on that class roster is one of the key pieces of information they need to run their application, and it's typically locked away inside a school Student Information System (SIS). 只要教师将新应用程序引入其课堂,他们就需要花时间手动将名单数据导入到该应用。Any time teachers bring a new application into their classroom, they spend time manually importing roster data into the app. 许多 ISV 通过连接 SIS 导入名单数据来解决此问题。Many ISVs address this by connecting with a SIS to import roster data. 在具备专有格式的数百个学生信息系统中,这将成为一个挑战。With hundreds of Student Information Systems with proprietary formats, this can become a challenge. Microsoft 学校数据同步与名单 API 结合使用,可为应用程序开发人员以及学校解决这一难题。Microsoft School Data Sync, combined with roster APIs, addresses this challenge for application developers and schools.

以下是名单 API 启用的一些情况:The following are some of the scenarios that the roster APIs enable:

使用 Microsoft Teams 在“作业”选项卡中创建课程作业Use Microsoft Teams to create class assignments in an assignments tab

可使用作业 API 创建 Web 应用来管理课程作业,然后在新自定义选项卡上将应用集成到 Microsoft Teams。You can use the assignments API to create a web app that manages class assignments and then integrate your app into Microsoft Teams on a new custom tab.

Office 365 中的 Microsoft Teams 是一个数字中心,它可将对话、内容和应用整合到教室这一个位置中。Microsoft Teams in Office 365 is a digital hub that brings conversations, content, and apps together in one place for classrooms. Microsoft Teams 提供了一组丰富的扩展点,包括创建选项卡、连接器和自动程序。Microsoft Teams provides a rich set of extensibility points, including creating Tabs, Connectors, and Bots. 这些扩展点可以在 Microsoft Graph 中调用教育版 API 以处理作业和提交。These extensibility points can call education APIs in Microsoft Graph to work with assignments and submissions. 通过启用具备任何其他 Microsoft Graph API 以及作业和提交 API 的扩展点来构建更全面的体验。Build a more comprehensive experience by enabling your extension point with any other Microsoft Graph API along with assignment and submission APIs.

对于教育版,Microsoft Teams 自定义选项卡应用在教育课堂(团队)上下文中打开,在此环境中,管理端到端作业流(从创建和分发到评分和反馈)别具意义。For education, Microsoft Teams custom tab apps are opened in an education class (a team) context, where it makes sense to manage the end-to-end assignment flow, from creation and distribution to grading and feedback. 这只是有关 Microsoft Teams 如何节省时间和简化日常后勤的一个示例,以便教育工作者可以更多地将重心放在他们的学生身上。This is just one example of how Microsoft Teams saves time and simplifies everyday logistics, leaving educators free to dedicate themselves to their students.

下图显示了科学-生物学科 1课程“作业”自定义选项卡中用于管理作业的 Web 应用。The following image shows a web app for managing assignments in an Assignments custom Tab for a Science - Biology 1 class.

Microsoft Teams 中面向“科学-生物学科”课程的“作业”选项卡屏幕截图

通过作业 API,你的应用可以与 Microsoft Teams 之外的作业服务进行交互。With the assignment API, your app can interact with the assignment service outside of Microsoft Teams. Microsoft Teams 将处理分发、截止日期和评分,而系统可以为学生提供丰富的学习体验。Microsoft Teams will handle distribution, due dates, and grading while your system can provide a rich learning experience to students. 以下是由作业 API 启用的几个方案示例:The following are examples of a few scenarios enabled by the assignments API:

使学校管理员能够使用学校数据同步管理(预览版)管理标识和名单同步Enable school admins to manage identity and roster sync using School Data Sync Management (preview)

学校数据同步可帮助自动执行从使用 Azure Active Directory (Azure AD) 和 Office 365 的学生信息系统中导入和同步学生标识及名单数据的过程。School Data Sync helps to automate the process of importing and synchronizing student identity and roster data from student information systems with Azure Active Directory (Azure AD) and Office 365. 当同步信息时,可以使用名单 API 将名单信息读入应用程序。When the information is synchronized, you can use the roster APIs to read the roster information into the applications. 如果你是建立学校学生信息系统和学校数据同步整合关系的系统集成者,则可以使用 Microsoft Graph 中的 SDS 管理 API 从 CSV 文件或受支持的 SIS API 连接器设置同步。If you're a system integrator setting up integration of a school's Student Information System with School Data Sync, you can use the SDS management APIs in Microsoft Graph to set up synchronization from either a CSV file or a supported SIS API connector.

学校数据同步管理 API 支持用于管理同步的端到端方案;例如:School Data Sync management APIs support end-to-end scenarios for managing sync; for example:

API 参考API reference

在查找此服务的 API 参考?Looking for the API reference for this service?

后续步骤Next Steps