重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
通用打印是一种新式打印解决方案，组织可以使用它通过Microsoft云服务来管理其打印基础结构。 组织使用通用打印将密钥Windows Server打印功能移动到 Microsoft 365 云。 使用通用打印可帮助组织简化和保护其打印基础结构，简化打印机管理，使用户能够按位置发现打印机等。
使用通用打印 API：
- 管理打印机和共享。
- 配置已启用云和旧式打印机的功能、设置和默认值。
- 管理打印作业、打印任务和操作以及拉取打印。
- 通过用户和组管理打印机访问。
- 按打印机或用户报告打印活动和使用情况。
云打印 API 提供以下关键功能。
访问打印设备
printerShare 和打印机资源定义用户和应用程序可发现的物理打印机的公共视图和实际打印机。 printerShare 是表示物理打印机的打印机资源的逻辑视图。 无需更改打印机共享即可更改基础物理打印机，这使组织能够保持打印机的高可用性。
printerShare 资源包含属性和方法，可用于管理哪些用户和组可以对该打印机执行操作，例如创建或删除打印作业。 可以使用 打印机 属性访问有关物理打印机的信息、查看其状态、列出和重置其设置等。
已启用云的打印机可以直接连接到通用打印，但旧式打印机需要 打印连接器 才能连接和启用发现。 有关旧版打印设备的打印连接器的详细信息，请参阅 什么是通用打印连接器？。
管理用户和组打印权限
可以使用在 printerShare 资源上运行的通用打印 API 管理用户和组打印权限。 可以向打印机共享添加、删除和列出授权用户和组。 应用于打印机共享的权限适用于共享包含的所有物理打印机。 此外， printerShare 资源包括 allowedUsers 和 allowedGroups 导航属性，这些属性包含有权使用打印机共享包含的打印机的用户和组。
管理打印作业、任务和操作
printJob 对象是打印的基本工作单元。 它们具有要打印的文档列表，以及描述要完成的打印操作的另一个 printTask 对象列表。 派生自 printOperation 基资源类型的资源（如 printerCreateOperation）表示长时间运行的操作，例如创建新打印机。
若要打印文档，请在打印作业的打印任务进入处理状态后，创建 printJob 并将其唯一标识符传递给 printDocument： createUploadSession。 然后使用创建上传会话时收到的会话标识符将文档发送到 printJob的文档属性。 此操作完成后，可以启动 printJob 以打印文档。 有关上传文档的详细信息，请参阅 使用 Microsoft Graph 通用打印 API 上传文档。
实现拉取打印
在拉取打印中，用户在物理打印机上轻扫其锁屏提醒以启用打印。 若要实现拉取打印，请先创建一个虚拟打印机，然后在该打印机上创建 printTaskTrigger 。 提交作业时，作业会暂停，应用程序可能会收到通知。 当用户在物理打印机上轻扫其锁屏提醒时，应用程序可以将作业从虚拟打印机重定向到物理打印机。 此工作流通过减少物理打印机上无人参与的文档数来提高安全性。
获取打印使用情况数据和报告
使用 printUsageByUser 和 printUsageByPrinter 资源可报告有关用户或打印机打印作业的每日或每月数量和类型的信息。 这些报告对于了解组织的打印资源的使用情况以及打印基础结构可能存在问题的位置非常有用。 返回 archivedPrintJob 资源的 API 包含有关打印机、用户或组的历史作业的详细信息。