Skip to content

Commit dcaef6a

Browse files
mnorman-msLauragra
andauthored
Apply suggestions from code review
Co-authored-by: Laura Graham <Lauragra@users.noreply.github.com>
1 parent 67e0056 commit dcaef6a

File tree

1 file changed

+20
-17
lines changed

1 file changed

+20
-17
lines changed
Lines changed: 20 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,51 +1,54 @@
11
---
2-
title: "Use the Microsoft Graph Cloud printing API"
3-
description: "Cloud printing lets organizations simplify and secure the management of their print infrastructure with Microsoft Universal Print."
2+
title: "Use the Universal Print REST API"
3+
description: "Learn how you can use the Universal Print API to simplify and secure the Universal Print infrastructure in your organization"
44
ms.localizationpriority: high
55
author: "mnorman-ms"
66
doc_type: conceptualPageType
77
ms.subservice: "universal-print"
88
---
99

10-
# Use the Microsoft Graph Universal Print API
10+
# Use the Universal Print API
1111

1212
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
1313

14-
Microsoft Universal Print is a modern print solution that organizations can use to manage their print infrastructure through cloud services from Microsoft. Organizations use Universal Print to move key Windows Server print functionality to the Microsoft 365 cloud, simplifying and securing their print infrastructure, streamlining printer management, enabling users to discover printers by location, and more. For more information, see [Universal Print cloud printing API overview](/graph/universal-print-concept-overview). The cloud printing API provides access to Universal Print. Use the cloud printing API to:
14+
Universal Print is a modern print solution that organizations can use to manage their print infrastructure through Microsoft cloud services. Organizations use Universal Print to move key Windows Server print functionality to the Microsoft 365 cloud. This helps to simplify and secure their print infrastructure, streamline printer management, enable users to discover printers by location, and more.
15+
16+
Use the Universal Print API to:
1517

1618
- Manage printers and shares.
1719
- Configure cloud-enabled and legacy printer capabilities, settings, and defaults.
18-
- Manage print jobs, print tasks and operations, and Pull Printing.
20+
- Manage print jobs, print tasks and operations, and pull printing.
1921
- Manage printer access through users and groups.
2022
- Report print activity and usage by printer or user.
2123

22-
The cloud printing API provides key features that are described in the following sections.
24+
The cloud printing API provides the following key features.
2325

2426
## Print devices
2527

26-
The [printerShare](./printershare.md) and [printer](./printer.md) resources define the public view and the actual printer, respectively, for physical printers that are discoverable by users and applications. The printer share is a logical view to a printer resource that represents a physical printer. The underlying physical printer can be changed without changing the printer share, enabling organizations to maintain high printer availability. The printer share contains properties and methods that let you manage which users and groups can perform operations on this printer, such as creating or deleting print jobs. You can use the **printer** property of the printer share to access information about the physical printer, see its status, list and reset its settings, and more.
28+
The [printerShare](./printershare.md) and [printer](./printer.md) resources define the public view and the actual printer for physical printers that are discoverable by users and applications. The printer share is a logical view of a printer resource that represents a physical printer. The underlying physical printer can be changed without changing the printer share, which enables organizations to maintain high printer availability.
29+
30+
The **printerShare** resource contains properties and methods that let you manage which users and groups can perform operations on that printer, such as creating or deleting print jobs. You can use the **printer** property to access information about the physical printer, see its status, list and reset its settings, and more.
2731

28-
Cloud-enabled printers can connect directly to Universal print, but legacy printers require a [print connector](./printconnector.md) to connect and enable discovery. For more information about print connectors for legacy print devices, see [The Universal Print connector](/universal-print/fundamentals/universal-print-connector-overview).
32+
Cloud-enabled printers can connect directly to Universal Print, but legacy printers require a [print connector](./printconnector.md) to connect and enable discovery. For more information about print connectors for legacy print devices, see [What is the Universal Print connector?](/universal-print/fundamentals/universal-print-connector-overview).
2933

30-
### User and group printing permissions
34+
## Manage user and group printing permissions
3135

32-
You manage user and group print permissions with cloud printing APIs that operate on printer share resources. You can add, remove, and list authorized users and groups to a printer share. The permissions applied to the printer share apply to all the physical printers that the share contains. In addition, printer shares have the **allowedUsers** and **allowedGroups** navigation properties, which contain the users and groups, respectively, that are authorized to use the printers that the printer share contains.
36+
You can manage user and group print permissions with Universal Print APIs that operate on **printerShare** resources. You can add, remove, and list authorized users and groups to a printer share. The permissions applied to the printer share apply to all the physical printers that the share contains. In addition, the **printerShare** resource includes **allowedUsers** and **allowedGroups** navigation properties that contain the users and groups that are authorized to use the printers that the printer share contains.
3337

3438

35-
## Print jobs, tasks, and operations
39+
## Manage print jobs, tasks and operations
3640

3741
[printJob](./printjob.md) objects are the basic unit of work for printing. They have a list of documents to print and another list of [printTask](./printtask.md) objects that describe the print operation to complete. Resources that derive from the [printOperation](./printoperation.md) base resource type, such as [printerCreateOperation](./printercreateoperation.md), represent long-running operations such as creating a new printer.
3842

39-
To print a document, create a print job and pass its unique identifier to [printDocument: createUploadSession](../api/printdocument-createuploadsession.md) after the print task for the print job enters the **processing** state. Then use the session identifier that you received when you created the upload session to send the document to the **document** property of the print job. After this operation completes, you can start the print job to print your document. For more information on uploading documents, see [Upload documents using the Microsoft Graph Universal Print API](/graph/upload-data-to-upload-session).
43+
To print a document, create a print job and pass its unique identifier to [printDocument: createUploadSession](../api/printdocument-createuploadsession.md) after the print task for the print job enters the **processing** state. Then use the session identifier that you received when you created the upload session to send the document to the **document** property of the print job. After this operation completes, you can start the print job to print your document. For more information about uploading documents, see [Upload documents using the Microsoft Graph Universal Print API](/graph/upload-data-to-upload-session).
4044

41-
### Pull printing
45+
## Implement pull printing
4246

4347
In pull printing, the user swipes their badge at a physical printer, which notifies your application via a [printTaskTrigger](./printtasktrigger.md). When your application receives this notification, it can fetch the jobs from the virtual printer and the user can then select which jobs to print. This workflow increases security by reducing the number of unattended documents at the physical printer.
4448

45-
## Print usage and reports
49+
## Get print usage data and reports
4650

47-
Use the [printUsageByUser](./printusagebyuser.md) and [printUsageByPrinter](./printusagebyprinter.md) resources report information about the daily or monthly number and type of print jobs for a user or printer. These reports are valuable for understanding your organization's usage of print resources and where there might be problems with your print infrastructure. The APIs that return [archivedPrintJob](./archivedprintjob.md) resources contain detailed information about the historical jobs from a printer, user, or group.
51+
Use the [printUsageByUser](./printusagebyuser.md) and [printUsageByPrinter](./printusagebyprinter.md) resources to report information about the daily or monthly number and type of print jobs for a user or printer. These reports are valuable for understanding your organization's usage of print resources and where there might be problems with your print infrastructure. The APIs that return [archivedPrintJob](./archivedprintjob.md) resources contain detailed information about the historical jobs from a printer, user, or group.
4852

4953
## Related content
50-
- [Universal Print cloud printing API overview](/graph/universal-print-concept-overview)
51-
- [Install Universal Print connector on Windows](/universal-print/fundamentals/universal-print-connector-installation)
54+
[Universal Print cloud printing API overview](/graph/universal-print-concept-overview)

0 commit comments

Comments
 (0)