Documento de documentos: uploadDataprintDocument: uploadData

Namespace: microsoft.graphNamespace: microsoft.graph

Importante

As APIs sob /beta a versão do Microsoft Graph estão sujeitas a alterações.APIs under the /beta version in Microsoft Graph are subject to change. Não há suporte para o uso dessas APIs em aplicativos de produção.Use of these APIs in production applications is not supported. Para determinar se uma API está disponível na versão 1.0, use o seletor de versão.To determine whether an API is available in v1.0, use the Version selector.

Carregar um único segmento binário do documento.Upload a single binary segment of the printDocument.

É possível carregar o arquivo inteiro ou dividir o arquivo em vários intervalos de bytes, desde que nenhuma solicitação seja maior do que 1 MB.You can upload the entire file, or split the file into multiple byte ranges, as long as no request is larger than 1 MB.

É possível fazer o upload dos segmentos do arquivo em qualquer ordem e o upload pode ser feito em paralelo, com até quatro solicitações simultâneas.The segments of the file can be uploaded in any order and can be uploaded in parallel, with up to four concurrent requests. Quando todos os segmentos binários do documento são carregados, o arquivo binário é vinculado ao printJob.When all the binary segments of document are uploaded, the binary file is linked to the printJob.

PermissõesPermissions

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Além das permissões a seguir, o locatário do usuário ou do aplicativo deve ter uma assinatura universal de impressão ativa e ter uma permissão que conceda obter acesso à impressora .In addition to the following permissions, the user or app's tenant must have an active Universal Print subscription and have a permission that grants Get printer access.

Tipo de permissãoPermission type Permissões (da com menos para a com mais privilégios)Permissions (from least to most privileged)
Delegado (conta corporativa ou de estudante)Delegated (work or school account) PrintJob. ReadWrite, PrintJob. ReadWrite. AllPrintJob.ReadWrite, PrintJob.ReadWrite.All
Delegado (conta pessoal da Microsoft)Delegated (personal Microsoft account) Sem suporte.Not Supported.
ApplicationApplication Sem suporte.Not Supported.

Solicitação HTTPHTTP request

POST /print/printers/{id}/jobs/{id}/documents/{id}/uploadData

Cabeçalhos de solicitaçãoRequest headers

NomeName DescriçãoDescription
AutorizaçãoAuthorization {token} de portador. Obrigatório.Bearer {token}. Required.
RangeRange bytes = {startByteIndex}-{endByteIndex}bytes={startByteIndex}-{endByteIndex}‬
Comprimento do ConteúdoContent-Length ContentLength{contentLength}‬
Content-typeContent-type application/json. Obrigatório.application/json. Required.

Corpo da solicitaçãoRequest body

O corpo da solicitação é um blob binário que contém os bytes do documento que são especificados como um intervalo de bytes inclusivo no cabeçalho Range.The request body is a binary blob containing the bytes of the document that are specified as an inclusive byte range in the Range header.

RespostaResponse

Se tiver êxito, este método retornará uma das seguintes respostas.If successful, this method returns one of the following responses. Não retorna nada no corpo da resposta.It does not return anything in the response body.

CondiçãoCondition Código da respostaResponse code
Um ou mais segmentos binários ainda precisam ser carregadosOne or more binary segments still need to be uploaded 202 Accepted
Todos os segmentos binários foram carregados com êxitoAll binary segments have been uploaded successfully 201 Created

ExemploExample

O exemplo a seguir mostra como chamar essa API para carregar os primeiros 72797 bytes de um documento.The following example shows how to call this API to upload the first 72797 bytes of a document.

SolicitaçãoRequest
POST https://graph.microsoft.com/beta/print/printers/{id}/jobs/{id}/documents/{id}/uploadData
Range: bytes=0-72796
Content-Length: 72797
RespostaResponse

Um ou mais segmentos ausentes:One or more segments missing:

HTTP/1.1 202 Accepted

Todos os segmentos recebidos:All segments received:

HTTP/1.1 201 Created