Espacio de nombres: microsoft.graph
Importante
Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.
Cree una nueva timeOffReason.
Esta API está disponible en las siguientes implementaciones nacionales de nube.
| Servicio global |
Gobierno de EE. UU. L4 |
Us Government L5 (DOD) |
China operada por 21Vianet |
| ✅ |
❌ |
❌ |
❌ |
Permisos
Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.
Esta API admite permisos de administrador. Los usuarios con roles de administrador pueden acceder a los equipos de los que no son miembros.
| Tipo de permiso |
Permisos (de menos a más privilegiados) |
| Delegado (cuenta profesional o educativa) |
Group.ReadWrite.All |
| Delegado (cuenta personal de Microsoft) |
No admitida. |
| Aplicación |
Schedule.ReadWrite.All* |
Solicitud HTTP
POST /teams/{teamId}/schedule/timeOffReasons
| 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 (en desuso) |
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. El MS-APP-ACTS-AS encabezado está en desuso y ya no es necesario con tokens de aplicación. |
Respuesta
Si se ejecuta correctamente, este método devuelve un 201 Created código de respuesta y un objeto timeOffReason en el cuerpo de la respuesta.
Ejemplo
Solicitud
En el ejemplo siguiente se muestra la solicitud.
POST https://graph.microsoft.com/beta/teams/{teamId}/schedule/timeOffReasons
Content-type: application/json
{
"displayName": "Vacation",
"code": "VacationCode",
"iconType": "plane",
"isActive": true
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Beta.Models;
var requestBody = new TimeOffReason
{
DisplayName = "Vacation",
Code = "VacationCode",
IconType = TimeOffReasonIconType.Plane,
IsActive = true,
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Teams["{team-id}"].Schedule.TimeOffReasons.PostAsync(requestBody);
// Code snippets are only available for the latest major version. Current major version is $v0.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
graphmodels "github.com/microsoftgraph/msgraph-beta-sdk-go/models"
//other-imports
)
requestBody := graphmodels.NewTimeOffReason()
displayName := "Vacation"
requestBody.SetDisplayName(&displayName)
code := "VacationCode"
requestBody.SetCode(&code)
iconType := graphmodels.PLANE_TIMEOFFREASONICONTYPE
requestBody.SetIconType(&iconType)
isActive := true
requestBody.SetIsActive(&isActive)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
timeOffReasons, err := graphClient.Teams().ByTeamId("team-id").Schedule().TimeOffReasons().Post(context.Background(), requestBody, nil)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
TimeOffReason timeOffReason = new TimeOffReason();
timeOffReason.setDisplayName("Vacation");
timeOffReason.setCode("VacationCode");
timeOffReason.setIconType(TimeOffReasonIconType.Plane);
timeOffReason.setIsActive(true);
TimeOffReason result = graphClient.teams().byTeamId("{team-id}").schedule().timeOffReasons().post(timeOffReason);
const options = {
authProvider,
};
const client = Client.init(options);
const timeOffReason = {
displayName: 'Vacation',
code: 'VacationCode',
iconType: 'plane',
isActive: true
};
await client.api('/teams/{teamId}/schedule/timeOffReasons')
.version('beta')
.post(timeOffReason);
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Models\TimeOffReason;
use Microsoft\Graph\Beta\Generated\Models\TimeOffReasonIconType;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new TimeOffReason();
$requestBody->setDisplayName('Vacation');
$requestBody->setCode('VacationCode');
$requestBody->setIconType(new TimeOffReasonIconType('plane'));
$requestBody->setIsActive(true);
$result = $graphServiceClient->teams()->byTeamId('team-id')->schedule()->timeOffReasons()->post($requestBody)->wait();
Import-Module Microsoft.Graph.Beta.Teams
$params = @{
displayName = "Vacation"
code = "VacationCode"
iconType = "plane"
isActive = $true
}
New-MgBetaTeamScheduleTimeOffReason -TeamId $teamId -BodyParameter $params
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.models.time_off_reason import TimeOffReason
from msgraph_beta.generated.models.time_off_reason_icon_type import TimeOffReasonIconType
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = TimeOffReason(
display_name = "Vacation",
code = "VacationCode",
icon_type = TimeOffReasonIconType.Plane,
is_active = True,
)
result = await graph_client.teams.by_team_id('team-id').schedule.time_off_reasons.post(request_body)
Respuesta
En el ejemplo siguiente se muestra la respuesta.
Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.
HTTP/1.1 201 Created
Content-type: application/json
{
"id": "TOR_891045ca-b5d2-406b-aa06-a3c8921245d7",
"createdDateTime": "2019-03-12T22:10:38.242Z",
"lastModifiedDateTime": "2019-03-12T22:10:38.242Z",
"displayName": "Vacation",
"code": "VacationCode",
"iconType": "plane",
"isActive": true,
"lastModifiedBy": {
"application": null,
"device": null,
"conversation": null,
"user": {
"id": "366c0b19-49b1-41b5-a03f-9f3887bd0ed8",
"displayName": "John Doe"
}
}
}