agendamento: shareschedule: share

Namespace: microsoft.graphNamespace: microsoft.graph

Compartilhar um intervalo de tempo de agendamento com membros de agendamento.Share a schedule time range with schedule members. Faça as coleções de itens Shift, openshift e timeOff no intervalo de tempo especificado da agenda exibida pelos membros da equipe especificados, incluindo funcionários e gerentes.Make the collections of shift, openshift and timeOff items in the specified time range of the schedule viewable by the specified team members, including employees and managers. Cada mudança, openshift e timeOff instância em um cronograma suporta uma versão de rascunho e uma versão compartilhada do item.Each shift, openshift and timeOff instance in a schedule supports a draft version and a shared version of the item. A versão de rascunho é visível apenas por gerentes e a versão compartilhada é visível por funcionários e gerentes.The draft version is viewable by only managers, and the shared version is viewable by employees and managers. Para cada mudança, openshift e timeOff instância 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 recentes sobre o item.For each shift, openshift and timeOff instance in the specified time range, the share action updates the shared version from the draft version, so that in addition to managers, employees can also view the most current information about the item. O parâmetro notifyTeam especifica ainda mais quais funcionários podem exibir o item.The notifyTeam parameter further specifies which employees can view the item.

PermissõesPermissions

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permissãoPermission type Permissões (da com menos para a com mais privilégios)Permissions (from least to most privileged)
Delegada (conta corporativa ou de estudante)Delegated (work or school account) Schedule. ReadWrite. All, Group. ReadWrite. AllSchedule.ReadWrite.All, Group.ReadWrite.All
Delegada (conta pessoal da Microsoft)Delegated (personal Microsoft account) Sem suporte.Not supported.
AplicativoApplication Schedule.ReadWrite.AllSchedule.ReadWrite.All

Solicitação HTTPHTTP request

POST /teams/{teamId}/schedule/share

Cabeçalhos de solicitaçãoRequest headers

CabeçalhoHeader ValorValue
AutorizaçãoAuthorization {token} de portador. Obrigatório.Bearer {token}. Required.
Content-TypeContent-Type application/json. Obrigatório.application/json. Required.

Corpo da solicitaçãoRequest body

Forneça um objeto JSON com os seguintes parâmetros no corpo da solicitação.In the request body, provide a JSON object with the following parameters.

ParâmetroParameter TipoType DescriçãoDescription
notifyTeamnotifyTeam Boolean Indica se a equipe inteira deve receber uma notificação visível desta ação ou apenas os funcionários que têm uma alteração atribuída a elas que foram compartilhadas.Indicates whether the entire team should get a visible notification of this action, or only employees that have a shift assigned to them that was shared. Obrigatório.Required.
startDateTimestartDateTime DateTimeOffset O horário de início para compartilhar as mudanças no cronograma.The start time to share shifts on the schedule from. Obrigatório.Required.
endDateTimeendDateTime DateTimeOffset O horário de término para compartilhar turnos no cronograma até.The end time to share shifts on the schedule until.

RespostaResponse

Se bem-sucedido, este método retorna um código de resposta 204 No Content. Não retorna nada no corpo da resposta.If successful, this method returns a 204 No Content response code. It does not return anything in the response body.

ExemploExample

SolicitaçãoRequest

Este é um exemplo de solicitação.The following is an example of the request.

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"
}

RespostaResponse

Este é um exemplo de resposta.The following is an example of the response.

HTTP/1.1 204 No content