Substituir shift
Namespace: microsoft.graph
Substitua um turno existente.
Se o turno especificado não existir, este método devolve 404 Not found
.
A duração de um turno não pode ser inferior a 1 minuto ou mais do que 24 horas.
Permissões
Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.
Tipo de permissão | Permissões com menos privilégios | Permissões com privilégios superiores |
---|---|---|
Delegado (conta corporativa ou de estudante) | Schedule.ReadWrite.All | Group.ReadWrite.All |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Application | Schedule.ReadWrite.All | Indisponível. |
Solicitação HTTP
PUT /teams/{teamId}/schedule/shifts/{shiftId}
Cabeçalhos de solicitação
Cabeçalho | Valor |
---|---|
Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
Content-Type | application/json. Obrigatório. |
MS-APP-ACTS-AS | Um ID de utilizador (GUID). Necessário apenas se o token de autorização for um token de aplicação; caso contrário, opcional. |
Corpo da solicitação
No corpo do pedido, forneça apenas os valores das propriedades a atualizar. As propriedades existentes que não estão incluídas no corpo do pedido mantêm os valores anteriores ou são recalculadas com base em alterações a outros valores de propriedade.
A tabela a seguir especifica as propriedades que podem ser atualizadas.
Propriedade | Tipo | Descrição |
---|---|---|
draftShift | shiftItem | Redigir alterações no turno. As alterações de rascunho só são visíveis para os gestores. As alterações são visíveis para os funcionários quando são partilhados, o que copia as alterações do draftShift para a propriedade sharedShift .
DraftOpenShift ou sharedOpenShift deve ser null . |
isStagedForDeletion | Booliano | O turno é marcado para eliminação, um processo que é finalizado quando a agenda é partilhada. Opcional. |
schedulingGroupId | Cadeia de caracteres | ID do grupo de agendamento do qual o turno faz parte. Obrigatório. |
sharedShift | shiftItem | A versão partilhada deste turno que é visível tanto pelos colaboradores como pelos gestores. Atualizações para a propriedade sharedShift, envie notificações aos utilizadores no cliente do Teams.
DraftOpenShift ou sharedOpenShift deve ser null . |
userId | Cadeia de caracteres | ID do utilizador atribuído ao turno. Obrigatório. |
Resposta
Se for bem-sucedido, este método devolve um 204 No Content
código de resposta e conteúdo vazio. Se o pedido especificar o Prefer
cabeçalho com return=representation
preferência, este método devolve um 200 OK
código de resposta e um objeto shift no corpo da resposta.
Exemplo
Solicitação
O exemplo a seguir mostra uma solicitação.
PUT https://graph.microsoft.com/v1.0/teams/{teamId}/schedule/shifts/{shiftId}
Content-type: application/json
{
"userId": "5ca83ce7-291d-43b7-bf53-af79eef4bc1d",
"draftShift": {
"displayName": null,
"startDateTime": "2024-10-08T15:00:00Z",
"endDateTime": "2024-10-09T00:00:00Z",
"theme": "blue",
"notes": null,
"activities": []
},
"sharedShift": null,
"isStagedForDeletion": false
}
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 204 No Content