Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .
Attention
L’API tâches Outlook est déconseillée et cessera de renvoyer les données le 20 août 2022. Veuillez utiliser la nouvelle API To Do. Pour de plus amples informations, consultez API To Do dans l’affichage public.
Créez une tâche Outlook dans le groupe de tâches par défaut (My Tasks) et le dossier de tâches par défaut (Tasks) dans la boîte aux lettres de l’utilisateur.
La méthode POST ignore toujours la partie heure de startDateTime et dueDateTime dans le corps de la requête, et suppose que l’heure est toujours minuit dans le fuseau horaire spécifié.
Par défaut, cette opération (ainsi que les opérations GET, PATCH et tâche complète ) retourne les propriétés liées à la date au format UTC.
Vous pouvez utiliser l’en-tête Prefer: outlook.timezone pour que toutes les propriétés de date dans la réponse soient représentées dans un fuseau horaire autre que UTC.
Spécifie le fuseau horaire des propriétés d’heure dans la réponse, qui serait au format UTC si cet en-tête n’est pas spécifié. Facultatif.
Corps de la demande
Dans le corps de la demande, fournissez une représentation JSON de l’objet outlookTask .
Réponse
Si elle réussit, cette méthode renvoie 201 Created le code de réponse et l’objet outlookTask dans le corps de la réponse.
Exemple
Demande
L’exemple suivant montre l’utilisation de l’en-tête Prefer: outlook.timezone . Il crée une tâche, exprime startDateTime et dueDateTime dans l’est de l’heure standard (EST), et inclut un Prefer en-tête d’heure standard du Pacifique (PST).
POST https://graph.microsoft.com/beta/me/outlook/tasks
Prefer: outlook.timezone="Pacific Standard Time"
Content-type: application/json
{
"subject": "Shop for children's weekend",
"startDateTime": {
"dateTime": "2016-05-03T09:00:00",
"timeZone": "Eastern Standard Time"
},
"dueDateTime": {
"dateTime": "2016-05-05T16:00:00",
"timeZone": "Eastern Standard Time"
}
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Beta.Models;
var requestBody = new OutlookTask
{
Subject = "Shop for children's weekend",
StartDateTime = new DateTimeTimeZone
{
DateTime = "2016-05-03T09:00:00",
TimeZone = "Eastern Standard Time",
},
DueDateTime = new DateTimeTimeZone
{
DateTime = "2016-05-05T16:00:00",
TimeZone = "Eastern Standard Time",
},
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Me.Outlook.Tasks.PostAsync(requestBody, (requestConfiguration) =>
{
requestConfiguration.Headers.Add("Prefer", "outlook.timezone=\"Pacific Standard Time\"");
});
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
OutlookTask outlookTask = new OutlookTask();
outlookTask.setSubject("Shop for children's weekend");
DateTimeTimeZone startDateTime = new DateTimeTimeZone();
startDateTime.setDateTime("2016-05-03T09:00:00");
startDateTime.setTimeZone("Eastern Standard Time");
outlookTask.setStartDateTime(startDateTime);
DateTimeTimeZone dueDateTime = new DateTimeTimeZone();
dueDateTime.setDateTime("2016-05-05T16:00:00");
dueDateTime.setTimeZone("Eastern Standard Time");
outlookTask.setDueDateTime(dueDateTime);
OutlookTask result = graphClient.me().outlook().tasks().post(outlookTask, requestConfiguration -> {
requestConfiguration.headers.add("Prefer", "outlook.timezone=\"Pacific Standard Time\"");
});
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Users\Item\Outlook\Tasks\TasksRequestBuilderPostRequestConfiguration;
use Microsoft\Graph\Beta\Generated\Models\OutlookTask;
use Microsoft\Graph\Beta\Generated\Models\DateTimeTimeZone;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new OutlookTask();
$requestBody->setSubject('Shop for children\'s weekend');
$startDateTime = new DateTimeTimeZone();
$startDateTime->setDateTime('2016-05-03T09:00:00');
$startDateTime->setTimeZone('Eastern Standard Time');
$requestBody->setStartDateTime($startDateTime);
$dueDateTime = new DateTimeTimeZone();
$dueDateTime->setDateTime('2016-05-05T16:00:00');
$dueDateTime->setTimeZone('Eastern Standard Time');
$requestBody->setDueDateTime($dueDateTime);
$requestConfiguration = new TasksRequestBuilderPostRequestConfiguration();
$headers = [
'Prefer' => 'outlook.timezone="Pacific Standard Time"',
];
$requestConfiguration->headers = $headers;
$result = $graphServiceClient->me()->outlook()->tasks()->post($requestBody, $requestConfiguration)->wait();
Dans le corps de la demande, fournissez une représentation JSON de l’objet outlookTask .
Réponse
La méthode POST ignore la partie heure de startDateTime et dueDateTime dans le corps de la demande et suppose que l’heure doit toujours être minuit dans le fuseau horaire spécifié (EST).
Étant donné que l’en-tête Prefer spécifie PST, la méthode POST exprime toutes les propriétés relatives à la date dans la réponse dans PST.
En particulier, pour les propriétés startDateTime et dueDateTime , la méthode POST convertit minuit en EST en PST et les retourne en PST dans la réponse.
Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.