Répertorier sectionGroupsList sectionGroups

Récupérez la liste des groupes de sections dans le bloc-notes spécifié.Retrieve a list of section groups from the specified notebook.

AutorisationsPermissions

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Type d’autorisationPermission type Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)Permissions (from least to most privileged)
Déléguée (compte professionnel ou scolaire)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
Déléguée (compte Microsoft personnel)Delegated (personal Microsoft account) Notes.Create, Notes.Read, Notes.ReadWriteNotes.Create, Notes.Read, Notes.ReadWrite
ApplicationApplication Notes.Read.All, Notes.ReadWrite.AllNotes.Read.All, Notes.ReadWrite.All

Requête HTTPHTTP request

GET /me/onenote/notebooks/{id}/sectionGroups
GET /users/{id | userPrincipalName}/onenote/notebooks/{id}/sectionGroups
GET /groups/{id}/onenote/notebooks/{id}/sectionGroups
GET /sites/{id}/onenote/notebooks/{id}/sectionGroups

Paramètres facultatifs de la requêteOptional query parameters

Cette méthode prend en charge les paramètres de requête OData pour vous aider à personnaliser la réponse.This method supports the OData Query Parameters to help customize the response.

L’ordre de tri par défaut est name asc.The default sort order is name asc.

La requête par défaut se parentNotebook développe et sélectionne idses displayNamepropriétés, self et.The default query expands parentNotebook and selects its id, displayName, and self properties. Les expand valeurs valides pour les sectionsgroupes sectionGroupsde parentNotebooksections sont parentSectionGroup,, et.Valid expand values for section groups are sections, sectionGroups, parentNotebook, and parentSectionGroup.

En-têtes de demandeRequest headers

NomName TypeType DescriptionDescription
AutorisationAuthorization stringstring Porteur {token}. Obligatoire.Bearer {token}. Required.
AccepterAccept stringstring application/json

Corps de la demandeRequest body

N’indiquez pas le corps de la demande pour cette méthode.Do not supply a request body for this method.

RéponseResponse

Si elle réussit, cette méthode 200 OK renvoie un code de réponse et une collection d’objets sectionGroup dans le corps de la réponse.If successful, this method returns a 200 OK response code and collection of sectionGroup objects in the response body.

ExempleExample

DemandeRequest

Voici un exemple de demande.Here is an example of the request.

GET https://graph.microsoft.com/v1.0/me/onenote/notebooks/{id}/sectionGroups
RéponseResponse

Voici un exemple de réponse. Remarque : l’objet de réponse illustré ici est tronqué à des fins de concision. Toutes les propriétés sont renvoyées à partir d’un appel réel.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"
        }
       }
     }
  ]
}