relatórios: getUserArchivedPrintJobs
Namespace: microsoft.graph
Importante
As APIs na versão /beta
no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Obtenha uma lista de trabalhos de impressão arquivados para um determinado usuário.
Essa API está disponível nas seguintes implantações nacionais de nuvem.
Serviço global | Governo dos EUA L4 | GOVERNO DOS EUA L5 (DOD) | China operada pela 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ❌ |
Permissões
Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
Tipo de permissão | Permissões menos privilegiadas | Permissões privilegiadas mais altas |
---|---|---|
Delegada (conta corporativa ou de estudante) | Reports.Read.All | Indisponível. |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Aplicativo | Sem suporte. | Sem suporte. |
Solicitação HTTP
GET /print/reports/getUserArchivedPrintJobs(userId='{userId}',startDateTime='{startDateTime}',endDateTime='{endDateTime}')
GET /reports/getUserArchivedPrintJobs(userId='{userId}',startDateTime='{startDateTime}',endDateTime='{endDateTime}')
Cabeçalhos de solicitação
Nome | Descrição |
---|---|
Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
Parâmetros de função
Na URL de solicitação, forneça os seguintes parâmetros de função com valores:
Parâmetro | Tipo | Obrigatório? | Descrição |
---|---|---|---|
userId |
Edm.String |
Sim | A ID do usuário para o qual retornar dados. |
startDateTime |
Edm.DateTimeOffset |
Não | A data de início (inclusiva) para o período de tempo para incluir dados. |
endDateTime |
Edm.DateTimeOffset |
Não | A data de término (inclusiva) para o período de tempo para incluir dados. |
Nota: Se um valor não for necessário, passe o parâmetro com valor nulo.
Resposta
Se for bem-sucedido, esse método retornará um 200 OK
código de resposta e uma coleção de objetos archivedPrintJob no corpo da resposta.
Exemplo
O exemplo a seguir mostra como chamar essa API.
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/beta/reports/getUserArchivedPrintJobs(userId='016b5565-3bbf-4067-b9ff-4d68167eb1a6',startDateTime=2021-05-24,endDateTime=2021-05-25)
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 200 OK
Content-type: application/json
{
"value": [
{
"id": "016b5565-3bbf-4067-b9ff-4d68167eb1a6",
"printerId": "016b5565-3bbf-4067-b9ff-4d68167eb1a6",
"printerName": "printerName1",
"processingState": "completed",
"createdDateTime": "2023-06-29T00:00:00.0000000Z",
"acquiredDateTime": "2023-06-29T00:00:01.0000000Z",
"completionDateTime": "2023-06-29T00:00:02.0000000Z",
"acquiredByPrinter": true,
"copiesPrinted": 1,
"pageCount": 1,
"blackAndWhitePageCount": 1,
"colorPageCount": 0,
"simplexPageCount": 0,
"duplexPageCount": 1,
"createdBy": {
"displayName": "username",
"userPrincipalName": "username@contoso.com",
}
}
]
}