Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Espace de noms: microsoft.graph
Récupérez les propriétés et les relations d’un objet sectionGroup .
Disponibilité de l’API
Cette API est disponible dans les déploiements cloud nationaux suivants.
| Service global | Gouvernement américain L4 | Gouvernement américain L5 (DOD) | Chine exploitée par 21Vianet |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
Autorisations
Choisissez l’autorisation ou les autorisations marquées comme étant les moins privilégiées pour cette API. Utilisez une ou plusieurs autorisations privilégiées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, voir Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez la référence des autorisations.
| Type d’autorisation | Autorisations les moins privilégiées | Autorisations à privilèges plus élevés |
|---|---|---|
| Déléguée (compte professionnel ou scolaire) | Notes.Create | Notes.Read, Notes.Read.All, Notes.ReadWrite, Notes.ReadWrite.All |
| Déléguée (compte Microsoft personnel) | Notes.Create | Notes.Read, Notes.ReadWrite |
| Application | Notes.Read.All | Notes.ReadWrite.All |
Requête HTTP
GET /me/onenote/sectionGroups/{id}
GET /users/{id | userPrincipalName}/onenote/sectionGroups/{id}
GET /groups/{id}/onenote/sectionGroups/{id}
GET /sites/{id}/onenote/sectionGroups/{id}
Paramètres facultatifs de la requête
Cette méthode prend en charge les paramètres de requête OData pour vous aider à personnaliser la réponse.
La requête par parentNotebook défaut développe et sélectionne ses idpropriétés , nameet .self Les valeurs valides expand pour les groupes de sections sont parentNotebook et parentSectionGroup.
En-têtes de demande
| Nom | Type | Description |
|---|---|---|
| Autorisation | string | Porteur {token}. Obligatoire. En savoir plus sur l’authentification et les autorisations. |
| Accepter | string | application/json |
Corps de la demande
N’indiquez pas le corps de la demande pour cette méthode.
Réponse
Si elle réussit, cette méthode renvoie un code de réponse 200 OK et un objet sectionGroup dans le corps de la réponse.
Exemple
Demande
L’exemple suivant illustre une demande.
GET https://graph.microsoft.com/v1.0/me/onenote/sectionGroups/1-0b13154b-d92d-46c3-b18b-838c4c9fb88d
Réponse
L’exemple suivant illustre la réponse. Remarque : l’objet de réponse affiché ici est tronqué pour plus de concision. Toutes les propriétés sont renvoyées à partir d’un appel réel.
HTTP/1.1 200 OK
Content-type: application/json
{
"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"
}
}
}