Auflisten von sectionGroupList sectionGroups
Namespace: microsoft.graphNamespace: microsoft.graph
Dient zum Abrufen einer Liste von sectionGroup -Objekten.Retrieve a list of sectionGroup objects.
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) | Notes.Create, Notes.Read, Notes.ReadWrite, Notes.Read.All, Notes.ReadWrite.AllNotes.Create, Notes.Read, Notes.ReadWrite, Notes.Read.All, Notes.ReadWrite.All |
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) | Notes.Create, Notes.Read, Notes.ReadWriteNotes.Create, Notes.Read, Notes.ReadWrite |
AnwendungApplication | Notes.Read.All, Notes.ReadWrite.AllNotes.Read.All, Notes.ReadWrite.All |
HTTP-AnforderungHTTP request
GET /me/onenote/sectionGroups
GET /users/{id | userPrincipalName}/onenote/sectionGroups
GET /groups/{id}/onenote/sectionGroups
GET /sites/{id}/onenote/sectionGroups
Optionale AbfrageparameterOptional query parameters
Diese Methode unterstützt die OData-Abfrageparameter zur Anpassung der Antwort.This method supports the OData Query Parameters to help customize the response.
Die Standardsortierreihenfolge ist name asc
.The default sort order is name asc
.
Die Standardabfrage parentNotebook
wird erweitert und wählt die Eigenschaften its, and aus id
displayName
self
.The default query expands parentNotebook
and selects its id
, displayName
, and self
properties. Gültige expand
Werte für Abschnittsgruppen sind sections
, sectionGroups
, parentNotebook
und parentSectionGroup
.Valid expand
values for section groups are sections
, sectionGroups
, parentNotebook
, and parentSectionGroup
.
AnforderungsheaderRequest headers
NameName | TypType | BeschreibungDescription |
---|---|---|
AuthorizationAuthorization | stringstring | Bearer {token}. Erforderlich.Bearer {token}. Required. |
AnnehmenAccept | stringstring | application/json |
AnforderungstextRequest body
Geben Sie für diese Methode keinen Anforderungstext an.Do not supply a request body for this method.
AntwortResponse
Wenn die Methode erfolgreich verläuft, werden der 200 OK
Antwortcode und eine Sammlung von sectionGroup -Objekten im Antworttext zurückgegeben.If successful, this method returns a 200 OK
response code and collection of sectionGroup objects in the response body.
BeispielExample
AnforderungRequest
Nachfolgend sehen Sie ein Beispiel der Anforderung.Here is an example of the request.
GET https://graph.microsoft.com/v1.0/me/onenote/sectionGroups
AntwortResponse
Nachfolgend sehen Sie ein Beispiel der Antwort. Hinweis: Das hier gezeigte Antwortobjekt ist aus Platzgründen abgeschnitten. Von einem tatsächlichen Aufruf werden alle Eigenschaften zurückgegeben.Here is an example of the response. Note: The response object shown here is truncated for brevity. All of the properties will be returned from an actual call.
HTTP/1.1 200 OK
Content-type: application/json
Content-length: 378
{
"value": [
{
"sectionsUrl": "sectionsUrl-value",
"sectionGroupsUrl": "sectionGroupsUrl-value",
"displayName": "name-value",
"createdBy": {
"user": {
"id": "id-value",
"displayName": "displayName-value"
}
},
"lastModifiedBy": {
"user": {
"id": "id-value",
"displayName": "displayName-value"
}
}
}
]
}