プリンターの printJobs の一覧表示

名前空間: microsoft.graph

プリンターに関連付けられている印刷ジョブの一覧を 取得します

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

ユニバーサル 印刷サービスを使用するには、ユーザーまたはアプリのテナントに、アクティブなユニバーサル印刷サブスクリプション、プリンターアクセス権の取得を許可するアクセス許可、および次の表に示すアクセス許可の 1 つが必要です。 サインインしているユーザーはプリンター管理者 である必要があります

別のユーザーから印刷ジョブを読み取る場合は、サインインしているユーザーが印刷管理者であり、PrintJob.ReadBasic.All、PrintJob.Read.All、PrintJob.ReadWriteBasic.All、または PrintJob.ReadWrite.All 権限を持っている必要があります。

アクセス許可の種類 アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント) PrintJob.ReadBasic, PrintJob.Read, PrintJob.ReadBasic.All, PrintJob.Read.All, PrintJob.ReadWriteBasic, PrintJob.ReadWrite, PrintJob.ReadWriteBasic.All, PrintJob.ReadWrite.All
委任 (個人用 Microsoft アカウント) サポートされていません。
アプリケーション PrintJob.ReadBasic.All, PrintJob.Read.All, PrintJob.ReadWriteBasic.All, PrintJob.ReadWrite.All 

HTTP 要求

GET /print/printers/{printerId}/jobs

省略可能なクエリ パラメーター

また、このメソッドは応答をカスタマイズするための一部の OData クエリ パラメーターをサポートします。 一般的な情報については、「OData クエリ パラメーター」を参照してください。

  • documents プロパティ は、既定では応答から省略されます。 各印刷ジョブの printDocuments の一覧 も返す場合は、 を使用します $expand=documents
  • このメソッドは、印刷ジョブを作成したユーザーによる印刷ジョブのフィルター処理をサポートします。 Use $filter=createdBy/userPrincipalName eq '{upn}' , where {upn} は 、関連 付けられたユーザー のユーザー プリンシパル名です。

例外

一部の演算子はサポートされていません $count$search

要求ヘッダー

名前 説明
Authorization ベアラー {token}。必須。

要求本文

このメソッドには、要求本文を指定しません。

応答

成功した場合、このメソッドは応答コードと、応答本文の 200 OK printJob オブジェクトのコレクションを返します。

要求

GET https://graph.microsoft.com/v1.0/print/printers/{printerId}/jobs

応答

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#print/printers('2f3453b7-4686-4b5b-9575-4f1e5b909ba7')/jobs",
  "value": [
    {
      "id": "103",
      "createdDateTime": "2020-02-04T00:00:00.0000000Z",
      "createdBy": {        
      },
      "status": {
        "state": "completed",
        "description": "The print job has completed successfully and no further processing will take place.",
        "details": [          
        ],
        "isAcquiredByPrinter": true
      },
      "configuration": {        
      },
      "redirectedTo": null,
      "redirectedFrom": null,
      "isFetchable": false     
    }
  ]
}