Obter cronogramaGet schedule

Namespace: microsoft.graphNamespace: microsoft.graph

Recupere as propriedades e os relacionamentos de um objeto Schedule .Retrieve the properties and relationships of a schedule object.

O processo de criação de agendamento está em conformidade com a diretriz de uma API para operações de longa duração com base em recursos (relo).The schedule creation process conforms to the One API guideline for resource based long running operations (RELO). Quando os clientes usam o método Put, se a agenda for provisionada, a operação atualizará a agenda; caso contrário, a operação iniciará o processo de provisionamento de agendamento em segundo plano.When clients use the PUT method, if the schedule is provisioned, the operation updates the schedule; otherwise, the operation starts the schedule provisioning process in the background.

Durante o provisionamento de agendamento, os clientes podem usar o método GET para obter o agendamento e observar a provisionStatus propriedade para o estado atual do provisionamento.During schedule provisioning, clients can use the GET method to get the schedule and look at the provisionStatus property for the current state of the provisioning. Se o provisionamento falhar, os clientes poderão obter informações adicionais da provisionStatusCode propriedade.If the provisioning failed, clients can get additional information from the provisionStatusCode property.

Os clientes também podem inspecionar a configuração do cronograma.Clients can also inspect the configuration of the schedule.

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.

Tipo de permissãoPermission type Permissões (da com menos para a com mais privilégios)Permissions (from least to most privileged)
Delegada (conta corporativa ou de estudante)Delegated (work or school account) Schedule. Read. All, Group. Read. All, Schedule. ReadWrite. All, Group. ReadWrite. AllSchedule.Read.All, Group.Read.All, Schedule.ReadWrite.All, Group.ReadWrite.All
Delegada (conta pessoal da Microsoft)Delegated (personal Microsoft account) Sem suporte.Not supported.
AplicativoApplication Schedule. Read. All, Schedule. ReadWrite. AllSchedule.Read.All, Schedule.ReadWrite.All

Solicitação HTTPHTTP request

GET /teams/{teamId}/schedule

Parâmetros de consulta opcionaisOptional query parameters

Este método não oferece suporte a parâmetros de consulta OData para personalizar a resposta.This method does not support OData query parameters to customize the response.

Cabeçalhos de solicitaçãoRequest headers

CabeçalhoHeader ValorValue
AutorizaçãoAuthorization {token} de portador. Obrigatório.Bearer {token}. Required.
Content-TypeContent-Type application/json. Obrigatório.application/json. Required.

Corpo da solicitaçãoRequest body

Não forneça um corpo de solicitação para esse método.Do not supply a request body for this method.

RespostaResponse

Se tiver êxito, este método retornará um 200 OK código de resposta e um objeto Schedule no corpo da resposta.If successful, this method returns a 200 OK response code and a schedule object in the response body.

ExemploExample

SolicitaçãoRequest

Este é um exemplo de solicitação.The following is an example of the request.

GET https://graph.microsoft.com/v1.0/teams/{teamId}/schedule

RespostaResponse

Este é um exemplo de resposta.The following is an example of the response.

Observação: o objeto response mostrado aqui pode ser encurtado para legibilidade. Todas as propriedades serão retornadas de uma chamada real.Note: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.

HTTP/1.1 200 OK
Content-type: application/json
Content-length: 401

{
  "id": "833fc4df-c88b-4398-992f-d8afcfe41df2",
  "enabled": true,
  "timeZone": "America/Chicago",
  "provisionStatus": "Completed",
  "provisionStatusCode": null,
  "timeClockEnabled": true,
  "openShiftsEnabled": true,
  "swapShiftsRequestsEnabled": true,
  "offerShiftRequestsEnabled": true,
  "timeOffRequestsEnabled": true
}