Compartilhar via


agenda: partilhar

Namespace: microsoft.graph

Partilhe um intervalo de tempo de agenda com os membros da agenda.

Esta ação torna as coleções de itens shift, openshift e timeOff no intervalo de tempo especificado da agenda visualizável pelos membros da equipa especificados, incluindo funcionários e gestores.

Cada turno, openshift e instância timeOff numa agenda suporta uma versão de rascunho e uma versão partilhada do item. A versão de rascunho é visível apenas por gestores e a versão partilhada é visível por funcionários e gestores. Para cada turno, openshift e instância timeOff no intervalo de tempo especificado, a ação de partilha atualiza a versão partilhada a partir da versão de rascunho, para que além dos gestores, os funcionários também possam ver as informações mais recentes sobre o item. O parâmetro notifyTeam especifica ainda quais os funcionários que podem ver o item.

Nota: Para simplificar a experiência do utilizador, atualize todos os sites de rascunho e, em seguida, partilhe todas as alterações pendentes num intervalo de datas como uma única ação. As versões de rascunho das propriedades têm de estar vazias antes de poder atualizar as versões partilhadas dos itens.

Esta API está disponível nas seguintes implementações de cloud nacionais.

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

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

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

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 equipa deve receber uma notificação visível desta ação ou apenas os funcionários que tenham um turno atribuído aos mesmos que tenha sido partilhado. Obrigatório.
startDateTime DateTimeOffset A hora de início para partilhar turnos na agenda. Obrigatório.
endDateTime DateTimeOffset A hora de fim para partilhar turnos na agenda até.

Resposta

Se tiver êxito, este método retornará um código de resposta 200 OK. Não devolve nada no corpo da resposta.

Exemplo

Solicitação

Eis um exemplo do pedido.

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