printDocument: uploadDataprintDocument: uploadData

名前空間: microsoft.graphNamespace: microsoft.graph

重要

/betaMicrosoft Graph のバージョンの api は変更される可能性があります。APIs under the /beta version in Microsoft Graph are subject to change. 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。Use of these APIs in production applications is not supported. API が v2.0 で利用できるかどうかを確認するには、 バージョン セレクターを使用します。To determine whether an API is available in v1.0, use the Version selector.

PrintDocumentの1つのバイナリセグメントをアップロードします。Upload a single binary segment of the printDocument.

ファイル全体をアップロードするか、または 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.

ファイルのセグメントは、任意の順序でアップロードでき、同時に最大4つの要求を並行してアップロードできます。The segments of the file can be uploaded in any order and can be uploaded in parallel, with up to four concurrent requests. ドキュメントのすべてのバイナリセグメントがアップロードされると、バイナリファイルは printJobにリンクされます。When all the binary segments of document are uploaded, the binary file is linked to the printJob.

アクセス許可Permissions

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

次のアクセス許可に加えて、ユーザーまたはアプリのテナントにはアクティブなユニバーサル印刷のサブスクリプションがあり、 プリンター へのアクセスを許可するアクセス許可を持っている必要があります。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.

アクセス許可の種類Permission type アクセス許可 (特権の小さいものから大きいものへ)Permissions (from least to most privileged)
委任 (職場または学校のアカウント)Delegated (work or school account) PrintJob、PrintJob、およびすべてPrintJob.ReadWrite, PrintJob.ReadWrite.All
委任 (個人用 Microsoft アカウント)Delegated (personal Microsoft account) サポートされません。Not Supported.
アプリケーションApplication サポートされません。Not Supported.

HTTP 要求HTTP request

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

要求ヘッダーRequest headers

名前Name 説明Description
AuthorizationAuthorization ベアラー {トークン}。必須。Bearer {token}. Required.
範囲Range バイト = {startByteIndex}-{endByteIndex}bytes={startByteIndex}-{endByteIndex}‬
コンテンツの長さContent-Length {contentLength}‬{contentLength}‬
Content-typeContent-type application/json. Required.application/json. Required.

要求本文Request body

要求本文は、ヘッダー内の包括バイト範囲として指定されたドキュメントのバイトを含むバイナリ blob です RangeThe request body is a binary blob containing the bytes of the document that are specified as an inclusive byte range in the Range header.

応答Response

成功した場合、このメソッドは次のいずれかの応答を返します。If successful, this method returns one of the following responses. 応答本文には何も返されません。It does not return anything in the response body.

ConditionCondition 応答コードResponse code
1つ以上のバイナリセグメントをまだアップロードする必要があるOne or more binary segments still need to be uploaded 202 Accepted
すべてのバイナリセグメントが正常にアップロードされましたAll binary segments have been uploaded successfully 201 Created

Example

次の例は、ドキュメントの最初の72797バイトをアップロードするために、この API を呼び出す方法を示しています。The following example shows how to call this API to upload the first 72797 bytes of a document.

要求Request
POST https://graph.microsoft.com/beta/print/printers/{id}/jobs/{id}/documents/{id}/uploadData
Range: bytes=0-72796
Content-Length: 72797
応答Response

1つまたは複数のセグメントがありません:One or more segments missing:

HTTP/1.1 202 Accepted

受信したすべてのセグメント:All segments received:

HTTP/1.1 201 Created