TodoTaskList erstellenCreate todoTaskList

15.01.2021
2 Minuten Lesedauer

Namespace: microsoft.graphNamespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert 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. Verwenden Sie die Versionsauswahl, um zu ermitteln, ob eine API in Version 1.0 verfügbar ist.To determine whether an API is available in v1.0, use the Version selector.

Erstellen Sie ein neues Listenobjekt.Create a new lists object.

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
AnwendungApplication	Nicht unterstütztNot supported

HTTP-AnforderungHTTP request

POST /me/todo/lists
POST /users/{id|userPrincipalName}/todo/lists

AnforderungsheaderRequest headers

NameName	BeschreibungDescription
AuthorizationAuthorization	Bearer {token}. Erforderlich.Bearer {token}. Required.
Content-TypeContent-Type	application/json. Erforderlich. application/json. Required.

AnforderungstextRequest body

Stellen Sie im Anforderungstext eine JSON-Darstellung des todoTaskList-Objekts zur Verfügung.In the request body, supply a JSON representation of the todoTaskList object.

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die zum Erstellen der todoTaskList erforderlich sind.The following table shows the properties that are required when you create the todoTaskList.

EigenschaftProperty	TypType	BeschreibungDescription
displayNamedisplayName	ZeichenfolgeString	Feld, das den Titel der Aufgabenliste angibt.Field indicating title of the task list.

AntwortResponse

Wenn die Methode erfolgreich ist, werden der Antwortcode und 201 Created ein TodoTaskList -Objekt im Antworttext zurückgegeben.If successful, this method returns a 201 Created response code and a todoTaskList object in the response body.

BeispieleExamples

AnforderungRequest

POST https://graph.microsoft.com/beta/me/todo/lists
Content-Type: application/json
Content-length: 60

{
  "displayName": "Travel items"
}


const options = {
    authProvider,
};

const client = Client.init(options);

const todoTaskList = {
  displayName: "Travel items"
};

let res = await client.api('/me/todo/lists')
    .version('beta')
    .post(todoTaskList);

Wichtig

Microsoft Graph-SDKs verwenden standardmäßig die Version v 1.0 der API und unterstützen nicht alle Typen, Eigenschaften und APIs, die in der Beta Version verfügbar sind.Microsoft Graph SDKs use the v1.0 version of the API by default, and do not support all the types, properties, and APIs available in the beta version. Ausführliche Informationen zum Zugriff auf die Beta-API mit dem SDK finden Sie unter Verwenden der Microsoft Graph-SDKs mit der Beta-API.For details about accessing the beta API with the SDK, see Use the Microsoft Graph SDKs with the beta API.

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 about how to add the SDK to your project and create an authProvider instance.


GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var todoTaskList = new TodoTaskList
{
    DisplayName = "Travel items"
};

await graphClient.Me.Todo.Lists
    .Request()
    .AddAsync(todoTaskList);

Wichtig


MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];

NSString *MSGraphBaseURL = @"https://graph.microsoft.com/beta/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/me/todo/lists"]]];
[urlRequest setHTTPMethod:@"POST"];
[urlRequest setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];

MSGraphTodoTaskList *todoTaskList = [[MSGraphTodoTaskList alloc] init];
[todoTaskList setDisplayName:@"Travel items"];

NSError *error;
NSData *todoTaskListData = [todoTaskList getSerializedDataWithError:&error];
[urlRequest setHTTPBody:todoTaskListData];

MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest 
    completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {

        //Request Completed

}];

[meDataTask execute];

Wichtig


IGraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

TodoTaskList todoTaskList = new TodoTaskList();
todoTaskList.displayName = "Travel items";

graphClient.me().todo().lists()
    .buildRequest()
    .post(todoTaskList);

Wichtig

AntwortResponse

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.Note: The response object shown here might be shortened for readability.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.todoTaskList",
  "id": "AAMkADIyAAAhrbPWAAA=",
  "displayName": "Travel items",
  "isOwner": true,
  "isShared": false,
  "wellknownListName": "none"
}

TodoTaskList erstellenCreate todoTaskList

BerechtigungenPermissions

HTTP-AnforderungHTTP request

AnforderungsheaderRequest headers

AnforderungstextRequest body

AntwortResponse

BeispieleExamples

AnforderungRequest

AntwortResponse

Ist diese Seite hilfreich?

Ist diese Seite hilfreich?