Type de ressource OneNote
Espace de noms: microsoft.graph
Importante
Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .
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.
Notebooks utilisateur Pour accéder aux blocs-notes personnels sur oneDrive consommateur, onedrive professionnel ou scolaire, 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 | onenotePage | Créez une page en la publiant dans la collection de pages. |
| Répertorier les pages | collection onenotePage | 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. |
Propriétés
Aucune.
Relations
| Relation | Type | Description |
|---|---|---|
| Blocs-notes | collecte de blocs-notes | Collection de blocs-notes OneNote dont l’utilisateur ou le groupe est propriétaire. 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 de tous les blocs-notes OneNote dont l’utilisateur ou le groupe est propriétaire. 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 dont l’utilisateur ou le groupe est propriétaire. En lecture seule. Peut avoir la valeur Null. |
| sections | collection onenoteSection | Sections de tous les blocs-notes OneNote dont l’utilisateur ou le groupe est propriétaire. En lecture seule. Pouvant accepter la valeur Null. |
{
"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" } ]
}