Agendamento: Compartilhar

Namespace: microsoft.graph

Compartilhe um intervalo de tempo de agendamento com os membros da agenda.

Essa ação faz com que as coleções de itens shift, openshift e timeOff no intervalo de tempo especificado da agenda possam ser exibidas pelos membros da equipe especificados, incluindo funcionários e gerentes.

Cada instância shift, openshift e timeOff em uma agenda suporta uma versão de rascunho e uma versão compartilhada do item. A versão de rascunho pode ser visualizada apenas por gerentes, e a versão compartilhada pode ser visualizada por funcionários e gerentes. Para cada instância shift, 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.

Observação: Para simplificar a experiência do usuário, atualize todas as propriedades de rascunho e, em seguida, compartilhe todas as alterações pendentes dentro de um intervalo de datas como uma única ação. As versões de rascunho das propriedades devem estar vazias antes que você possa atualizar as versões compartilhadas dos itens.

Essa API está disponível nas seguintes implantações de nuvem nacional.

Serviço global Governo dos EUA L4 US Government L5 (DOD) China operada pela 21Vianet

Permissões

Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos 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 com privilégios mais elevados
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

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 (preterido) Uma ID de usuário (GUID). Necessário somente se o token de autorização for um token de aplicativo; caso contrário, opcional. O MS-APP-ACTS-AS cabeçalho foi preterido e não é mais necessário com tokens de aplicativo.

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 os funcionários que têm um turno atribuído a eles que foi compartilhado. Obrigatório.
startDateTime DateTimeOffset A hora de início para compartilhar turnos na agenda de. Obrigatório.
endDateTime DateTimeOffset A hora de término para compartilhar os turnos na agenda até.

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

Veja um exemplo da solicitação.

POST https://graph.microsoft.com/v1.0/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

Limites de limitação específicos do serviço do Microsoft Graph