agendamento: compartilhar
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.
Compartilhe um intervalo de tempo de agendamento com os membros da agenda.
Essa ação torna as coleções de itens shift, openshift e timeOff no intervalo de tempo especificado do agendamento acessível pelos membros da equipe especificados, incluindo funcionários e gerentes.
Cada instância de turno, openshift e timeOff em um agendamento dá suporte a uma versão de rascunho e uma versão compartilhada do item. A versão de rascunho só pode ser visualizada pelos gerentes e a versão compartilhada é acessível por funcionários e gerentes. Para cada turno, instância openshift e timeOff no intervalo de tempo especificado, a ação de compartilhamento atualiza a versão compartilhada da versão de rascunho, para que, além dos gerentes, os funcionários também possam exibir as informações mais atuais sobre o item. O parâmetro notifyTeam especifica ainda quais funcionários podem exibir o item.
Nota: Para simplificar a experiência do usuário, atualize todos os requisitos de rascunho e compartilhe todas as alterações pendentes em um intervalo de datas como uma única ação. As versões de rascunho das propriedades devem estar vazias para que você possa atualizar as versões compartilhadas dos itens.
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 |
---|---|---|
Delegado (conta corporativa ou de estudante) | Schedule.ReadWrite.All | Group.ReadWrite.All |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Aplicativo | Schedule.ReadWrite.All | Indisponível. |
Solicitação HTTP
POST /teams/{teamId}/schedule/share
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 | Uma ID de usuário (GUID). Necessário somente se o token de autorização for um token de aplicativo; caso contrário, opcional. |
Corpo da solicitação
Forneça um objeto JSON com os seguintes parâmetros no corpo da solicitação.
Parâmetro | Tipo | Descrição |
---|---|---|
notifyTeam | Boolean |
Indica se toda a equipe deve receber uma notificação visível dessa ação ou apenas funcionários que têm um turno atribuído a eles que foi compartilhado. Obrigatório. |
startDateTime | DateTimeOffset |
A hora de início da qual compartilhar turnos na agenda. Obrigatório. |
endDateTime | DateTimeOffset |
O tempo de término até o qual compartilhar turnos na agenda. |
Resposta
Se tiver êxito, este método retornará um código de resposta 200 OK
. Ele não retorna nada no corpo da resposta.
Exemplo
Solicitação
Aqui está um exemplo da solicitação.
POST https://graph.microsoft.com/beta/teams/{teamId}/schedule/share
Content-type: application/json
{
"notifyTeam": true,
"startDateTime": "2018-10-08T00:00:00.000Z",
"endDateTime": "2018-10-15T00:00:00.000Z"
}
Resposta
Veja um exemplo de resposta.
HTTP/1.1 200 OK
Conteúdo relacionado
Limites de limitação específicos do serviço do Microsoft Graph
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de