outlookTask abrufenCreate outlookTask

Namespace: microsoft.graphNamespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported.

Erstellen Sie eine Outlook-Aufgabe in der StandardaufgabenMy TasksGruppe () und im StandardTasksAufgabenordner () im Postfach des Benutzers.Create an Outlook task in the default task group (My Tasks) and default task folder (Tasks) in the user's mailbox.

Die Post-Methode ignoriert immer den Zeitbereich von StartDateTime und dueDateTime im Anforderungs Text und nimmt an, dass die Zeit immer Mitternacht in der angegebenen Zeitzone liegt.The POST method always ignores the time portion of startDateTime and dueDateTime in the request body, and assumes the time to be always midnight in the specified time zone.

Standardmäßig werden durch diesen Vorgang (und die Vorgangs Vorgänge Get, Patch und Complete ) datumsbezogene Eigenschaften in UTC zurückgegeben.By default, this operation (and the GET, PATCH, and complete task operations) returns date-related properties in UTC. Sie können mit dem Prefer: outlook.timezone-Header alle datumsbezogenen Eigenschaften in der Antwort in einer anderen Zeitzone als UTC darstellen.You can use the Prefer: outlook.timezone header to have all the date-related properties in the response represented in a time zone different than UTC.

BerechtigungenPermissions

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

BerechtigungstypPermission type Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)Permissions (from least to most privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) Tasks.ReadWriteTasks.ReadWrite
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Tasks.ReadWriteTasks.ReadWrite
ApplicationApplication Nicht unterstütztNot supported.

HTTP-AnforderungHTTP request

POST /me/outlook/tasks
POST /users/{id|userPrincipalName}/outlook/tasks

AnforderungsheaderRequest headers

NameName BeschreibungDescription
AuthorizationAuthorization Bearer {token}. Erforderlich.Bearer {token}. Required.
Prefer: outlook.timezonePrefer: outlook.timezone Gibt die Zeitzone für Zeit Eigenschaften in der Antwort an, die sich in UTC befinden würde, wenn diese Kopfzeile nicht angegeben ist.Specifies the time zone for time properties in the response, which would be in UTC if this header is not specified. Optional.Optional.

AnforderungstextRequest body

Geben Sie im Anforderungstext eine JSON-Darstellung des Outlook Task -Objekts an.In the request body, supply a JSON representation of outlookTask object.

AntwortResponse

Wenn die Methode erfolgreich verläuft 201 Created , werden der Antwortcode und das Outlook Task -Objekt im Antworttext zurückgegeben.If successful, this method returns 201 Created response code and outlookTask object in the response body.

BeispielExample

AnforderungRequest

Im folgenden Beispiel wird die Verwendung der Prefer: outlook.timezone Kopfzeile veranschaulicht.The following example shows the use of the Prefer: outlook.timezone header. Es erstellt eine Aufgabe, drückt StartDateTime und dueDateTime in Eastern Standard Time (EST) aus und enthält eine Prefer Kopfzeile von Pacific Standard Time (PST).It creates a task, expresses startDateTime and dueDateTime in Eastern Standard Time (EST), and includes a Prefer header of Pacific Standard Time (PST).

POST https://graph.microsoft.com/beta/me/outlook/tasks
Prefer: outlook.timezone="Pacific Standard Time"
Content-type: application/json
Content-length: 276

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

GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var outlookTask = 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"
    }
};

await graphClient.Me.Outlook.Tasks
    .Request()
    .Header("Prefer","outlook.timezone=\"Pacific Standard Time\"")
    .AddAsync(outlookTask);

In der SDK-Dokumentation finden Sie Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider -Instanz.Read the SDK documentation for details on how to add the SDK to your project and create an authProvider instance.

Geben Sie im Anforderungstext eine JSON-Darstellung des Outlook Task -Objekts an.In the request body, supply a JSON representation of outlookTask object.

AntwortResponse

Die Post-Methode ignoriert den Zeitbereich von StartDateTime und dueDateTime im Anforderungs Text und nimmt an, dass die Zeit immer Mitternacht in der angegebenen Zeitzone (EST) liegt.The POST method ignores the time portion of startDateTime and dueDateTime in the request body and assumes the time to be always midnight in the specified time zone (EST).

Da der Prefer-Header PST angibt, drückt die POST-Methode alle datumsbezogenen Eigenschaften in der Antwort in PST aus.Since the Prefer header specifies PST, the POST method expresses all the date-related properties in the response in PST. Insbesondere für die Eigenschaften StartDateTime und dueDateTime konvertiert die Post-Methode Mitternacht in EST in PST und gibt Sie in PST in der Antwort zurück.In particular, for the startDateTime and dueDateTime properties, the POST method converts midnight in EST to PST and returns them in PST in the response.

Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten. Von einem tatsächlichen Aufruf werden alle Eigenschaften zurückgegeben.Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

HTTP/1.1 201 Created
Content-type: application/json
Content-length: 576

{
  "id": "AAMkADA1MHgwAAA=",
  "createdDateTime": "2016-04-22T15:19:18.9526004-07:00",
  "lastModifiedDateTime": "2016-04-22T15:19:19.015101-07:00",
  "changeKey": "1/KC9Vmu40G3DwB6Lgs7MAAAIW9XXA==",
  "categories": [ ],
  "assignedTo": null,
  "body": {
    "contentType": "Text",
    "content": ""
  },
  "completedDateTime": null,
  "dueDateTime": {
    "dateTime": "2016-05-04T021:00:00.0000000",
    "timeZone": "Pacific Standard Time"
  },
  "hasAttachments":false,
  "importance": "normal",
  "isReminderOn": false,
  "owner": "Administrator",
  "parentFolderId": "AQMkADA1MTEgAAAA==",
  "recurrence": null,
  "reminderDateTime": null,
  "sensitivity": "Normal",
  "startDateTime": {
    "dateTime": "2016-05-02T21:00:00.0000000",
    "timeZone": "Pacific Standard Time"
  },
  "status": "notStarted",
  "subject": "Shop for children's weekend"
}