Reemplazar timeOff
Espacio de nombres: microsoft.graph
Reemplace un objeto timeOff existente.
Si el objeto timeOff especificado no existe, este método devuelve 404 Not found.
Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.
| Tipo de permiso | Permisos con privilegios mínimos | Permisos con privilegios más altos |
|---|---|---|
| Delegado (cuenta profesional o educativa) | Group.Read.All | Schedule.ReadWrite.All, Group.ReadWrite.All |
| Delegado (cuenta personal de Microsoft) | No admitida. | No admitida. |
| Aplicación | Schedule.ReadWrite.All | No disponible. |
Nota: esta API admite permisos de administrador. Los usuarios con roles de administrador pueden acceder a grupos de los que no son miembros.
PUT /teams/{teamId}/schedule/timesOff/{timeOffId}
| Encabezado | Valor |
|---|---|
| Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
| Content-Type | application/json. Obligatorio. |
| MS-APP-ACTS-AS | Un identificador de usuario (GUID). Solo se requiere si el token de autorización es un token de aplicación; De lo contrario, es opcional. |
En el cuerpo de la solicitud, proporcione solo los valores de las propiedades que se van a actualizar. Las propiedades existentes que no se incluyen en el cuerpo de la solicitud mantienen sus valores anteriores o se recalculan en función de los cambios realizados en otros valores de propiedad.
En la tabla siguiente se especifican las propiedades que se pueden actualizar.
| Propiedad | Tipo | Descripción |
|---|---|---|
| draftTimeOff | timeOffItem | Versión de borrador de este elemento timeOff que pueden ver los administradores. Debe compartirse antes de que sea visible para los miembros del equipo.
DraftOpenShift o sharedOpenShift deben ser null. |
| isStagedForDeletion | Booleano | TimeOff se marca para su eliminación, un proceso que se finaliza cuando se comparte la programación. Opcional |
| sharedTimeOff | timeOffItem | La versión compartida de este timeOff que pueden ver tanto los empleados como los administradores. Novedades a la propiedad sharedTimeOff, envíe notificaciones a los usuarios del cliente de Teams.
DraftOpenShift o sharedOpenShift deben ser null. |
| userId | Cadena | Identificador del usuario asignado a timeOff. Obligatorio. |
Si se ejecuta correctamente, este método devuelve un código de 204 No Content respuesta y contenido vacío. Si la solicitud especifica el Prefer encabezado con return=representation preferencia, este método devuelve un 200 OK código de respuesta y un objeto timeOff en el cuerpo de la respuesta.
En el ejemplo siguiente se muestra la solicitud.
PUT https://graph.microsoft.com/v1.0/teams/{teamId}/schedule/timesOff/{timeOffId}
Content-type: application/json
{
"userId": "aa162a04-bec6-4b81-ba99-96caa7b2b24d",
"sharedTimeOff": {
"timeOffReasonId": "TOR_29a5ba96-c7ef-4e76-bec6-055323746314",
"startDateTime": "2024-10-10T19:00:00Z",
"endDateTime": "2024-10-10T20:00:00Z",
"theme": "blue"
},
"draftTimeOff": null
}
En el ejemplo siguiente se muestra la respuesta.
HTTP/1.1 204 No Content