bloc-notes: getNotebookFromWebUrlnotebook: getNotebookFromWebUrl

Récupérez les propriétés et les relations d’un objet de bloc-notes à l’aide de son chemin d’URL.Retrieve the properties and relationships of a notebook object by using its URL path.

L’emplacement peut être des blocs-notes utilisateur sur Office 365, des blocs-notes de groupe ou des blocs-notes d’équipe hébergés sur un site SharePoint sur Office 365.The location can be user notebooks on Office 365, group notebooks, or SharePoint site-hosted team notebooks on Office 365.

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
ApplicationApplication Notes.Read.All, Notes.ReadWrite.AllNotes.Read.All, Notes.ReadWrite.All

Requête HTTPHTTP request

POST /me/onenote/notebooks/GetNotebookFromWebUrl
POST /users/{id | userPrincipalName}/onenote/notebooks/GetNotebookFromWebUrl
POST /groups/{id}/onenote/notebooks/GetNotebookFromWebUrl
POST /sites/{id}/onenote/notebooks/GetNotebookFromWebUrl

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

Dans le corps de la demande, fournissez une représentation JSON de l’URL complète vers le bloc-notes que vous souhaitez récupérer.In the request body, supply a JSON representation of the full URL path to the notebook you want to retrieve.

PropriétéProperty TypeType DescriptionDescription
webUrl String Chemin d’accès de l’URL du bloc-notes à récupérer.The URL path of the notebook to retrieve. Il peut également contenir un préfixe «OneNote:».It can also contain a "onenote:" prefix.

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.

POST https://graph.microsoft.com/v1.0/me/onenote/notebooks/GetNotebookFromWebUrl
Content-type: application/json

{"webUrl":"webUrl value"}
RéponseResponse

Voici un exemple de réponse.Here is an example of the response.

Remarque : l’objet de réponse illustré ici peut être tronqué à des fins de lisibilité. Toutes les propriétés sont renvoyées à partir d’un appel réel.Note: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.

HTTP/1.1 200 OK
Content-Type: application/json; odata.metadata=minimal
Content-Length: 544

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