|
1 | 1 | ---
|
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" |
4 | 4 | ms.localizationpriority: high
|
5 | 5 | author: "mnorman-ms"
|
6 | 6 | doc_type: conceptualPageType
|
7 | 7 | ms.subservice: "universal-print"
|
8 | 8 | ---
|
9 | 9 |
|
10 |
| -# Use the Microsoft Graph Universal Print API |
| 10 | +# Use the Universal Print API |
11 | 11 |
|
12 | 12 | [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
|
13 | 13 |
|
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: |
15 | 17 |
|
16 | 18 | - Manage printers and shares.
|
17 | 19 | - 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. |
19 | 21 | - Manage printer access through users and groups.
|
20 | 22 | - Report print activity and usage by printer or user.
|
21 | 23 |
|
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. |
23 | 25 |
|
24 | 26 | ## Print devices
|
25 | 27 |
|
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. |
27 | 31 |
|
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). |
29 | 33 |
|
30 |
| -### User and group printing permissions |
| 34 | +## Manage user and group printing permissions |
31 | 35 |
|
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. |
33 | 37 |
|
34 | 38 |
|
35 |
| -## Print jobs, tasks, and operations |
| 39 | +## Manage print jobs, tasks and operations |
36 | 40 |
|
37 | 41 | [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.
|
38 | 42 |
|
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). |
40 | 44 |
|
41 |
| -### Pull printing |
| 45 | +## Implement pull printing |
42 | 46 |
|
43 | 47 | 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.
|
44 | 48 |
|
45 |
| -## Print usage and reports |
| 49 | +## Get print usage data and reports |
46 | 50 |
|
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. |
48 | 52 |
|
49 | 53 | ## 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