Obtenir un bloc-notesGet notebook

Récupérez les propriétés et les relations d’un objet bloc-notes .Retrieve the properties and relationships of a notebook object.

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}
GET /users/{id | userPrincipalName}/onenote/notebooks/{id}
GET /groups/{id}/onenote/notebooks/{id}
GET /sites/{id}/onenote/notebooks/{id}

Paramètres facultatifs de la requêteOptional query parameters

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

Les valeurs expand valides pour les blocs-notes sont sections et sectionGroups.Valid expand values for notebooks are sections and sectionGroups.

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 un objet bloc-notes dans le corps de la réponse.If successful, this method returns a 200 OK response code and a notebook object 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}
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: 284

{
  "isDefault": true,
  "userRole": {
  },
  "isShared": true,
  "sectionsUrl": "sectionsUrl-value",
  "sectionGroupsUrl": "sectionGroupsUrl-value",
  "links": {
    "oneNoteClientUrl": {
      "href": "href-value"
    },
    "oneNoteWebUrl": {
      "href": "href-value"
    }
  }
}