Partager via

Type de ressource OneNote

  • Article

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" } ]
}