Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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.
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 só é visível pelos 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 a partir da qual partilhar turnos na agenda. Obrigatório. |
| endDateTime | DateTimeOffset |
A hora de fim até à qual pretende partilhar turnos na agenda. |
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/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