Visão geral da API de impressão em nuvem da Impressão UniversalUniversal Print cloud printing API overview

Importante

A Microsoft está oferecendo temporariamente o uso das APIs de impressão em nuvem para gerenciar o Universal Print gratuitamente.Microsoft is temporarily offering usage of the cloud printing APIs to manage Universal Print at no charge. A Microsoft espera cobrar pelo uso de algumas ou todas essas APIs no futuro.Microsoft expects to charge for the use of some or all of these APIs in the future. A Microsoft fornecerá um aviso prévio sobre alterações de preçosMicrosoft will provide advanced notice of pricing changes.

A Impressão Universal é uma solução moderna que as organizações podem usar para gerir a infraestrutura de impressão através de serviços de nuvem da Microsoft.Universal Print is a modern print solution that organizations can use to manage their print infrastructure through cloud services from Microsoft.

Captura de tela da página inicial do portal da Impressão Universal do Azure

Por que usar a Impressão Universal?Why use Universal Print?

A Impressão Universal move a funcionalidade de impressão do Windows Server para a nuvem do Microsoft 365, para que as organizações não precisem mais de servidores de impressão locais e não precisem instalar drivers de impressora em dispositivos.Universal Print moves key Windows Server print functionality to the Microsoft 365 cloud, so organizations no longer need on-premises print servers and do not need to install printer drivers on devices. Além disso, a Impressão Universal adiciona funcionalidades fundamentais, como grupos de segurança para acesso à impressora, descoberta de impressora baseada no local e uma experiência de administrador avançada.In addition, Universal Print adds key functionality like security groups for printer access, location-based printer discovery, and a rich administrator experience.

Como as organizações adotam a Impressão Universal, as organizações e os fornecedores independentes de software (ISVs) podem usar a API de Impressão Universal no Microsoft Graph para criar e ampliar aplicativos para suportar novos cenários.As organizations adopt Universal Print, organizations and independent software vendors (ISVs) can use the Universal Print API in Microsoft Graph to build and extend applications to support new scenarios.

Mover a infraestrutura de impressão para a nuvem permite imprimir documentos diretamente de aplicativos da Web e móveis.Moving print infrastructure to the cloud enables printing documents directly from web and mobile applications.

  • Os usuários podem enviar trabalhos de impressão para o printerShare.Users can submit print jobs to printerShare.
  • Os administradores da impressora também podem enviar trabalhos de impressão, para fazer testes preliminares antes de compartilhar a impressora com a organização.Printer admins can also submit print jobs to a printer, for doing preliminary testing before sharing the printer with the organization.

Siga estas etapas para enviar trabalhos de impressão para o printerShare:Follow these steps to submit print jobs to printerShare:

  1. Crie um trabalho de impressão e armazene a ID do documento resultante.Create a print job and store the resulting document ID.
  2. Crie uma uploadSession para o documento.Create an uploadSession for the document.
  3. Bytes de upload para a sessão de upload criada.Upload bytes to the created upload session.
  4. Iniciar o trabalho de impressão.Start the print job.

Gerenciar impressorasManage printers

É uma tarefa complexa acompanhar as impressoras de uma organização, suas configurações e uso.Keeping track of an organization's printers, printer configurations, and printer usage is a complex task. A API de Impressão Universal permite a integração em todas as três áreas.The Universal Print API enables integration in all three areas.

Substituir ou atualizar o hardware da impressora sem problemasSeamlessly replace or update printer hardware

As impressoras não estarão visíveis para os usuários até que sejam compartilhadas, proporcionando aos administradores um controle detalhado sobre qual hardware de impressora estará disponível em um determinado momento.Printers are not visible to users until they are shared, providing administrators fine-grained control over which printer hardware is available at a given time.

O compartilhamento de uma impressora cria um recurso printerShare que pode ser atualizado a qualquer momento para indicar uma impressora diferente, facilitando a substituição de hardware de uma impressora quebrada ou a desativação de impressoras para manutenção.Sharing a printer creates a printerShare resource that can be updated at any time to point to a different printer, making it easy to replace broken printer hardware or take printers offline for maintenance.

Para usá-lo em seu aplicativo, use Update printerShare para atualizar a referência printer de printerShare.To use this in your application, use Update printerShare to update the printerShare's printer reference.

Extensão da Impressão Universal para suporte à impressão seguraExtending Universal Print to support pull printing

A API de Impressão Universal do Microsoft Graph permite que o seu aplicativo suporte a impressão segura.The Microsoft Graph Universal Print API enables your application to support pull printing. Para configurar a impressão segura, você registrará acionadores que notificarão o seu aplicativo (via comunicação serviço a serviço) quando determinados eventos de impressão acontecem, como um trabalho de impressão sendo iniciado.To set up pull printing, you will register triggers that notify your application (via service-to-service communication) when certain print events happen, such as a print job being started.

Esses acionadores permitem que o seu aplicativo interrompa o fluxo de trabalho de impressão para fazer coisas como redirecionar os trabalhos para diferentes impressoras e modificar o conteúdo do documento.These triggers enable your application to interrupt the print workflow to do things such as redirecting jobs to different printers and modifying the document payload.

Siga estes passos para habilitar a impressão segura:Follow these steps to enable pull printing:

  1. Crie uma Definição de Tarefa de impressão usando as permissões do aplicativo.Create a printTaskDefinition using application permissions. Esta definição de tarefa abstrata será usada para criar a tarefa que irá realizar o trabalho para o seu aplicativo.This abstract task definition will be used to create task that will hold the job for your application. É necessário estabelecer pelo menos uma definição de tarefa por inquilino, que pode ser associada a qualquer número de impressoras, usando acionadores de tarefa (ver etapa 4).You need to define at least one task definition per tenant, which can be associated with any number of printers in the tenant using task triggers (see step 4).

  2. Registre uma ou mais impressoras virtuais usando um token de autenticação de administrador e um null Dispositivo físico.Register one or more virtual printers using an administrator authentication token and a null physicalDeviceId. Sem um dispositivo físico acoplado, uma "impressora virtual" é apenas um objeto de impressora na Impressão Universal.A "virtual printer" is just a printer object in Universal Print without a physical device attached. Normalmente, os usuários imprimem em impressoras virtuais e depois pegam seus trabalhos de impressão em um dispositivo físico de impressão.Usually, users will print to virtual printers and later pick up their print jobs at a physical print device. Veja o passo 6.See step 6.

  3. Atualize os atributos de sua impressora virtual usando as permissões do aplicativo e um application/ipp tipo de mídia (veja exemplos).Update the attributes of your virtual printer by using application permissions and an application/ipp media type (see examples).

  4. Crie um acionador de tarefas para sua impressora virtual usando um token de autenticação de administrador que irá associar a definição da sua tarefa com a impressora virtual.Create a task trigger for your virtual printer using an administrator authentication token that will associate your task definition with virtual printer.

  5. Quando um trabalho de impressão é enviado para a impressora virtual, ele será pausado devido ao Acionador de Tarefas de impressão.When a print job is submitted to the virtual printer, it will be paused due to the printTaskTrigger. Uma Tarefa de impressão com processingestado será criada com base na Definição da Tarefa de impressão associada.A printTask with processing state will be created based on the associated printTaskDefinition.

  6. Quando o usuário passar um crachá em um dispositivo físico de impressão, a impressora notificará o seu aplicativo.When the user swipes a badge at a physical printer device, the printer will notify your application. Nessa altura, o seu aplicativo pode buscar os trabalhos da impressora virtual associada e filtrar a lista de trabalhos criados pelo usuário atual.At that time, your application can fetch the jobs of the associated virtual printer and filter the list to jobs created by the current user.

  7. Quando o usuário seleciona um ou mais trabalhos para imprimir, seu aplicativo pode redirecionar o(s) trabalho(s) de impressão para a impressora física e o trabalho começará a imprimir!When the user selects one or more jobs to print, your application can redirect the print job(s) to the physical printer and the job will start printing! A chamada de redirecionamento só terá sucesso se houver uma Tarefa de impressão em processing estado na impressora associada iniciada por um acionador que este aplicativo criou no passo 4.The redirect call will only succeed if there is a printTask in processing state on the associated printer started by a trigger that this app created in step 4. A tarefa será automaticamente definida para o completed estado após o redirecionamento.The task will automatically be set to completed state after redirecting it.

Referência da APIAPI reference

Está procurando a referência de API para esse serviço?Looking for the API reference for this service?

Faça comentáriosProvide feedback

Gostaríamos de ouvir seus comentários sobre as APIs de Impressão Universal.We'd love to hear your feedback about the Universal Print APIs. Forneça suas sugestões sobre oUserVoice.Provide your suggestions on UserVoice.

Confira tambémSee also