Type de ressource OneNote
Espace de noms: microsoft.graph
Représente le point d’entrée des ressources OneNote.
Tous les appels au service OneNote via l’API Microsoft Graph utilisent cette URL racine du service :
https://graph.microsoft.com/{version}/{location}/onenote/
L’emplacement peut être un bloc-notes utilisateur dans Microsoft 365 ou OneDrive grand public, un bloc-notes de groupe ou un bloc-notes d’équipe hébergé sur un site SharePoint dans Microsoft 365.
Blocs-notes utilisateur Pour accéder aux blocs-notes personnels pour OneDrive grand public ou OneDrive Entreprise, utilisez l’une des URL suivantes :
https://graph.microsoft.com/{version}/me/onenote/{notebooks | sections | sectionGroups | pages}
https://graph.microsoft.com/{version}/users/{userPrincipalName}/onenote/{notebooks | sections | sectionGroups | pages}
https://graph.microsoft.com/{version}/users/{id}/onenote/{notebooks | sections | sectionGroups | pages}
Blocs-notes de groupe Pour accéder aux blocs-notes appartenant à un groupe, utilisez l’URL racine de service suivante :
https://graph.microsoft.com/{version}/groups/{id}/onenote/{notebooks | sections | sectionGroups | pages}
Blocs-notes de site SharePoint Pour accéder aux blocs-notes appartenant à un site d’équipe SharePoint, utilisez l’URL racine de service suivante :
https://graph.microsoft.com/{version}/sites/{id}/onenote/{notebooks | sections | sectionGroups | pages}
Autorisation
Pour plus d’informations sur les autorisations nécessaires pour utiliser les API OneNote, consultez la page relative aux autorisations pour les notes.
Méthodes
| Méthode | Type renvoyé | Description |
|---|---|---|
| Créer un bloc-notes | bloc-notes | Créez un bloc-notes en le publiant dans la collection de blocs-notes. |
| Répertorier les blocs-notes | Collection de blocs-notes | Obtenez une collection de blocs-notes. |
| Créer une page | Page | Créez une page en la publiant dans la collection de pages. |
| Répertorier les pages | collection de pages | Obtenez une collection de pages. |
| Répertorier les groupes de sections | Collection SectionGroup | Obtenez une collection de groupes de sections. |
| Répertorier les sections | collection onenoteSection | Obtenez une collection de sections. |
Relations
| Relation | Type | Description |
|---|---|---|
| Blocs-notes | collecte de blocs-notes | Collection des blocs-notes OneNote appartenant à l’utilisateur ou groupe. En lecture seule. Peut avoir la valeur Null. |
| operations | Collection onenoteOperation | État des opérations OneNote. L’obtention d’une collection d’opérations n’est pas prise en charge, mais vous pouvez obtenir la status d’opérations de longue durée si l’en-tête Operation-Location est retourné dans la réponse. En lecture seule. Peut avoir la valeur Null. |
| pages | collection onenotePage | Pages dans tous les blocs-notes OneNote appartenant à l’utilisateur ou au groupe. En lecture seule. Peut avoir la valeur Null. |
| resources | collection onenoteResource | Image et autres ressources de fichier contenues dans les pages OneNote. L’obtention d’une collection de ressources n’est pas prise en charge, mais vous pouvez obtenir le contenu binaire d’une ressource spécifique. En lecture seule. Peut avoir la valeur Null. |
| sectionGroups | Collection SectionGroup | Groupes de sections dans tous les blocs-notes OneNote appartenant à l’utilisateur ou au groupe. En lecture seule. Peut avoir la valeur Null. |
| sections | collection onenoteSection | Sections de tous les blocs-notes OneNote appartenant à l’utilisateur ou au groupe. En lecture seule. Pouvant accepter la valeur Null. |
Représentation JSON
La représentation JSON suivante montre le type de ressource.
{
"notebooks": [{ "@odata.type": "microsoft.graph.notebook" }],
"operations": [{ "@odata.type": "microsoft.graph.onenoteOperation" }],
"pages": [{ "@odata.type": "microsoft.graph.onenotePage" }],
"resources": [ { "@odata.type": "microsoft.graph.onenoteResource" } ],
"sectionGroups": [ { "@odata.type": "microsoft.graph.sectionGroup" } ],
"sections": [ { "@odata.type": "microsoft.graph.onenoteSection" } ]
}