Table of contents
TOC
Réduire la table des matières
Développer la table des matières
Dernière mise à jour: 20/06/2018

Travailler avec les blocs-notes du personnel

S'applique aux : bloc-notes d'Entreprise sur Office 365

Les écoles, les facultés et les universités du monde entier utilisent les blocs-notes du personnel pour contribuer à promouvoir la productivité, l'engagement et la collaboration.

Vous pouvez utiliser le point de terminaison staffNotebooks pour effectuer des tâches courantes pour les bloc-notes du personnel, tels que la création des bloc-notes du personnel et l'ajout ou la suppression d'organisateurs ou de membres.

L'API OneNote assiste le point de terminaison staffNotebooks pour les opérations spécifiques aux bloc-notes du personnel.

Construction de l'URI de requête

Pour construire l'URI de requête, commencez par l'URL racine du service pour votre plateforme :

Blocs-notes sur OneDrive Entreprise
https://www.onenote.com/api/v1.0/me/notes/
https://www.onenote.com/api/v1.0/users/{id}/notes/

Blocs-notes de site SharePoint
https://www.onenote.com/api/v1.0/myOrganization/siteCollections/{id}/sites/{id}/notes/

Blocs-notes de groupe unifiés
https://www.onenote.com/api/v1.0/myOrganization/groups/{id}/notes/


Ajoutez ensuite le point de terminaison classNotebooks, suivi d'un chemin d'accès aux ressources si nécessaire :

Créez des bloc-notes du personnel

../staffNotebooks[?omkt,sendemail]

Mettez à jour un bloc-note du personnel

../staffNotebooks/{notebook-id}

Obtenez un ou plusieurs bloc-notes du personnel

../staffNotebooks

../staffNotebooks/{notebook-id}

Supprimez un bloc-note du personnel

../staffNotebooks/{notebook-id}

Ajoutez des membres ou des organisateurs

../staffNotebooks/{notebook-id}/members

../staffNotebooks/{notebook-id}/leaders

Supprimez des membres ou des organisateurs

../staffNotebooks/{notebook-id}/members/{member-id}

../staffNotebooks/{notebook-id}/leaders/{leader-id}

Insérez des sections

../staffNotebooks/{notebook-id}/copySectionsToContentLibrary


Votre requête URI complète ressemblera à ces exemples :

https://www.onenote.com/api/v1.0/me/notes/staffNotebooks/{id}/leaders/{id}

https://www.onenote.com/api/v1.0/users/{id}/notes/staffNotebooks/{id}/members

https://www.onenote.com/api/v1.0/myOrganization/siteCollections/{id}/sites/{id}/notes/staffNotebooks

https://www.onenote.com/api/v1.0/myOrganization/groups/{id}/notes/staffNotebooks/{id}

https://www.onenote.com/api/v1.0/me/notes/staffNotebooks/{id}/copySectionsToContentLibrary

En savoir plus sur l’URL racine du service.

Créez des bloc-notes du personnel

Pour créer un bloc-note du personnel, envoyez une requête POST au point de terminaison staffNotebooks.

POST ../staffNotebooks[?omkt,sendemail]

Dans le corps du message, envoyez un objet JSON avec les paramètres de création de bloc-notes du personnel.

{
    "name": "notebook-name",
    "memberSections": [ 
        "section1-name", 
        "section2-name"
    ],
    "leaders": [
        {
            "id": "alias@tenant",
            "principalType": "Person-or-Group"
        }
    ],
    "members": [
        {
            "id": "alias@tenant",
            "principalType": "Person-or-Group" 
        },
        {
            "id": "alias@tenant",
            "principalType": "Person-or-Group"
        },
        {
            "id": "alias@tenant",
            "principalType": "Person-or-Group"
        }
   ], 
   "hasLeaderOnlySectionGroup": true
}
ParamètreDescription
nomNom du bloc-notes.
memberSectionsUn tableau contenant un ou plusieurs noms de section. Ces sections sont créées dans le groupe de sections de chaque membre.
organisateursUn tableau contenant un ou plusieurs objets principaux.
membresUn tableau contenant un ou plusieurs objets principaux. Un groupe de sections est créé pour chaque membre.
hasLeaderOnlySectionGrouptrue pour créer un groupe de sections Organisateurs seulement visible uniquement par les organisateurs.
omktParamètre de requête d'URL qui spécifie la langue du bloc-notes. La valeur par défaut est en-us. Exemple : ?omkt=es-es
sendmailParamètre de requête d'URL qui spécifie s'il faut envoyer une notification par e-mail aux organisateurs et membres affectés au bloc-notes lors de sa création. La valeur par défaut est false.


Les organisateurs et les membres sont représentés par des objets principaux, qui contiennent les propriétés suivantes :

ParamètreDescription
idLe nom principal de l'utilisateur Office 365.

Voir la Documentation de l'API Azure AD Graph pour en savoir plus sur les utilisateurs et les groupes.
principalTypePerson ou Group

Langues prises en charge

Vous pouvez utiliser le omkt={language-code} paramètre de requête d'URL pour créer un bloc-notes du personnel dans une langue spécifique. Par exemple :

POST ../staffNotebooks?omkt=de-de

Les codes de langue suivants sont pris en charge. La valeur par défaut est en-us.

CodeLangue
bg-bgБългарски (България)
cs-czČeština (Česká republika)
da-dkDansk (Danmark)
de-deDeutsch (Deutschland)
el-grΕλληνικά (Ελλάδα)
en-usAnglais (États-Unis)
es-esEspagnol (España)
et-eeEesti (Eesti)
fi-fiSuomi (Suomi)
fr-frFrançais (France)
hi-inहिंदी (भारत)
hr-hrHrvatski (Hrvatska)
hu-huMagyar (Magyarország)
id-idBahasa Indonesie (Indonesie)
it-itItaliano (Italia)
ja-jp日本語 (日本)
kz-kzҚазақ (Қазақстан)
ko-kr한국어 (대한민국)
lt-ltLietuvių (Lietuva)
lv-lvLatviešu (Latvija)
ms-myBahasa Melayu (Asia Tenggara)
nb-noNorsk (Norge)
nl-nlNéerlandais (Nederland)
pl-plPolski (Polska)
pt-brPortugais (Brésil)
pt-ptPortugais (Portugal)
ro-roRomână (România)
ru-ruРусский (Россия)
sk-skSlovenčina (Slovenská republika)
sl-siSlovenski (Slovenija)
sr-Latn-RSSrpski (Rep. Srbija i Rep. Crna Gora)
sv-seSvenska (Sverige)
th-thไทย (ไทย)
tr-trTürkçe (Türkiye)
uk-uaУкраїнська (Україна)
vi-vnTiếng Việt (Việt Nam)
zh-cn简体 中文 (中国)
zh-tw繁體 中文 (台灣)

Par exemple

La requête suivante crée un bloc-notes du * personnel Réunions du personnel.*

POST ../v1.0/users/{leader-id}/notes/staffNotebooks?sendemail=true
Authorization: Bearer {token}
Content-Type: application/json
Accept: application/json

{
    "name": "Staff Meetings",
    "memberSections": [
        "Staff Notes",
        "Meeting Summaries",
    ],
    "leaders": [
        {
            "id": "leader1@contoso.com",
            "principalType": "Person"
        }
    ],
    "members": [
        {
            "id": "member1@contoso.com",
            "principalType": "Person"
        },
        {
            "id": "member2@contoso.com",
            "principalType": "Person" 
        },
        {
            "id": "member3@contoso.com",
            "principalType": "Person"
        },
        {
            "id": "member4@contoso.com",
            "principalType": "Person"
        }
    ],
    "hasLeaderOnlySectionGroup": true
}

Cela crée un bloc-notes avec quatre groupes de sections membres, chacun contenant une section Documents, Notes du personnel et Résumés de réunion. Le groupe de sections créé pour chaque membre n'est accessible que par le membre et l'organisateur. Il crée également un groupe de section Organisateur seulement qui est visible uniquement pour le leader. La requête sendemail=true paramètre spécifie d'envoyer une notification par e-mail au leader et aux membres lors de la création du bloc-notes.

Informations sur les requêtes et les réponses

Les informations suivantes s'appliquent aux POST /staffNotebooksrequêtes.

Données des requêtesDescription
ProtocoleToutes les requêtes utilisent le protocole SSL/TLS HTTPS.
En-tête d’autorisation

Bearer {token}, où le {jeton} est un jeton d'accès OAuth 2.0 valide pour votre application enregistrée.

S'il est manquant ou non valide, la demande échoue avec un code d'état 401. Voir Authentification avec Azure AD (applications d'entreprise).

En-tête Content-Typeapplication/json
En-tête d'acceptationapplication/json
Étendue d’autorisationNotes.ReadWrite.CreatedByApp, Notes.ReadWrite ou Notes.ReadWrite.All
Données de réponseDescription
Code de réussiteUn code d'état HTTP 201.
Corps de la réponseUne représentation OData du nouveau bloc-notes au format JSON.

En plus des propriétés de bloc-notes standard, les blocs-notes du personnel ont également les propriétés suivantes :
  • memberSections. Les sections membres dans les bloc-notes.
  • organisateurs. Les organisateurs qui peuvent accéder au bloc-notes.
  • membre. Les membres qui peuvent accéder au bloc-notes.
  • hasLeaderOnlySectionGroup. true si le bloc-notes contient un groupe de section Réservé l'organisateur, sinon false.
ErreursSi la requête échoue, l'API renvoie les les erreurs dans l'objet @ api.diagnostics dans le corps de la réponse.
En-tête X-CorrelationIdUn GUID qui identifie la requête de manière unique. Vous pouvez utiliser cette valeur avec la valeur de l'en-tête Date lorsque vous faites appel au Microsoft Support pour résoudre les problèmes.

Mettre à jour les bloc-notes du personnel

Pour mettre à jour un bloc-notes du personnel, envoyez une requête PATCH au point de terminaison staffNotebooks / {notebook-id}.

Actuellement, seule la propriété hasLeacherOnlySectionGroup peut être mise à jour dans une requête PATCH.

PATCH ../staffNotebooks/{notebook-id}

Dans le corps du message, envoyez un objet JSON avec le paramètre de mise à jour.

{
    "hasLeaderOnlySectionGroup": true
}
ParamètreDescription
hasLeaderOnlySectionGrouptrue pour créer un groupe de sections Réservé à l'Organisateur visible uniquement par les organisateurs. false n’est pas pris en charge.

Consultez ces méthodes pour d'autres façons de modifier les blocs-notes du personnel : Ajoutez des membres ou des organisateurs, Supprimez des membres ou des leaders, Insérez des sections.

Par exemple

La requête suivante ajoute un groupe de section Réservé à l'Organisateur au cahier bloc-notes du personnel spécifié.

PATCH ../v1.0/users/{leader-id}/notes/staffNotebooks/{notebook-id}
Authorization: Bearer {token}
Content-Type: application/json
Accept: application/json

{
    "hasLeaderOnlySectionGroup": true
}

Le nouveau groupe de section Réservé à l'Organisateur est visible uniquement pour les leaders.

Informations sur les requêtes et les réponses

Les informations suivantes s'appliquent aux PATCH ../staffNotebooks/{notebook-id}requêtes.

Données des requêtesDescription
ProtocoleToutes les requêtes utilisent le protocole SSL/TLS HTTPS.
En-tête d’autorisation

Bearer {token}, où le {jeton} est un jeton d'accès OAuth 2.0 valide pour votre application enregistrée.

S'il est manquant ou non valide, la demande échoue avec un code d'état 401. Voir Authentification avec Azure AD (applications d'entreprise).

En-tête Content-Typeapplication/json
En-tête d'acceptationapplication/json
Étendue d’autorisationNotes.ReadWrite.CreatedByApp, Notes.ReadWrite ou Notes.ReadWrite.All
Données de réponseDescription
Code de réussiteUn code d'état HTTP 204.
ErreursSi la requête échoue, l'API renvoie les erreurs dans le corps de la réponse.
En-tête X-CorrelationIdUn GUID qui identifie la requête de manière unique. Vous pouvez utiliser cette valeur avec la valeur de l'en-tête Date lorsque vous faites appel au Microsoft Support pour résoudre les problèmes.

Obtention des bloc-notes du personnel

Pour obtenir un ou plusieurs blocs-notes, envoyez une requête GET au point de terminaison staffNotebooks.

Obtenez un ou plusieurs bloc-notes du personnel

GET ../staffNotebooks[?filter,orderby,select,top,skip,expand,count]

Obtenir un bloc-notes du personnel spécifique

GET ../staffNotebooks/{notebook-id}[?select,expand]


Les blocs-notes peuvent développer leaders et members et les propriétés. L’ordre de tri par défaut est name asc.

Les blocs-notes du personnel sont également retournés pour les requêtes GET /notebooks, mais les résultats n'incluent aucune propriété spécifique aux blocs-notes du personnel.

Par exemple

La requête suivante obtient les blocs-notes du personnel créés depuis le 1er janvier 2016.

GET ../v1.0/users/{leader-id}/notes/staffNotebooks?filter=createdTime%20ge%202016-01-01 
Authorization: Bearer {token}
Accept: application/json

La requête suivante obtient les bloc-notes du personnel créés depuis le 1er janvier 2016.

Informations sur les requêtes et les réponses

Les informations suivantes s'appliquent aux GET /staffNotebooksrequêtes.

Données des requêtesDescription
ProtocoleToutes les requêtes utilisent le protocole SSL/TLS HTTPS.
En-tête d’autorisation

Bearer {token}, où le {jeton} est un jeton d'accès OAuth 2.0 valide pour votre application enregistrée.

S'il est manquant ou non valide, la demande échoue avec un code d'état 401. Voir Authentification avec Azure AD (applications d'entreprise).

En-tête d'acceptationapplication/json
Étendue d’autorisationNotes.ReadWrite.CreatedByApp, Notes.ReadWrite, ou Notes.ReadWrite.All
Données de réponseDescription
Code de réussiteUn code d'état HTTP 200.
Corps de la réponseUne représentation OData des blocs-notes du personnel au format JSON.

En plus des propriétés de bloc-notes standard, les blocs-notes du personnel ont également les propriétés suivantes :
  • memberSections. Les sections membres dans les bloc-notes.
  • organisateurs. Les organisateurs qui peuvent accéder au bloc-notes.
  • membre. Les membres qui peuvent accéder au bloc-notes.
  • hasLeaderOnlySectionGroup. true si le bloc-notes contient un groupe de section Réservé l'organisateur, sinon false.
ErreursSi la requête échoue, l'API renvoie les les erreurs dans l'objet @ api.diagnostics dans le corps de la réponse.
En-tête X-CorrelationIdUn GUID qui identifie la requête de manière unique. Vous pouvez utiliser cette valeur avec la valeur de l'en-tête Date lorsque vous faites appel au Microsoft Support pour résoudre les problèmes.

Supprimez les bloc-notes du personnel

Pour supprimer un bloc-notes, envoyez une requête SUPPRIMER au point de terminaison staffNotebooks / {notebook-id}.

DELETE ../staffNotebooks/{notebook-id}

Par exemple

La requête suivante supprime le bloc-notes du personnel spécifié.

DELETE ../v1.0/users/{leader-id}/notes/staffNotebooks/{notebook-id} 
Authorization: Bearer {token}
Accept: application/json

Informations sur les requêtes et les réponses

Les informations suivantes s'appliquent aux DELETE ../staffNotebooks/{notebook-id}requêtes.

Données des requêtesDescription
ProtocoleToutes les requêtes utilisent le protocole SSL/TLS HTTPS.
En-tête d’autorisation

Bearer {token}, où le {jeton} est un jeton d'accès OAuth 2.0 valide pour votre application enregistrée.

S'il est manquant ou non valide, la demande échoue avec un code d'état 401. Voir Authentification avec Azure AD (applications d'entreprise).

En-tête d'acceptationapplication/json
Étendue d’autorisationNotes.ReadWrite.CreatedByApp, Notes.ReadWrite ou Notes.ReadWrite.All
Données de réponseDescription
Code de réussiteUn code d'état HTTP 204.
ErreursSi la requête échoue, l'API renvoie les erreurs dans le corps de la réponse.
En-tête X-CorrelationIdUn GUID qui identifie la requête de manière unique. Vous pouvez utiliser cette valeur avec la valeur de l'en-tête Date lorsque vous faites appel au Microsoft Support pour résoudre les problèmes.

Ajouter des membres et des organisateurs

L'ajout d'organisateurs et de membres leur donne accès au bloc-notes du personnel. L'ajout d'un membre crée également un groupe de sections de membre. Ce groupe de sections est uniquement accessible par le membre et le l'organisateur, et contient les sections membres définies pour le bloc-notes.

Pour ajouter un membre ou un organisateur à un bloc-notes, envoyez une requête POST au point de terminaison approprié.

Ajout d'un membre

POST ../staffNotebooks/{notebook-id}/members

Ajout d'un organisateur

POST ../staffNotebooks/{notebook-id}/leaders


Envoyer un objet principal JSON dans le corps du message. Vous pouvez ajouter un membre ou un organisateur par requête.

{
    "id": "alias@tenant",
    "principalType": "Person-or-Group"
}

Les organisateurs et les membres sont représentés par des objets principaux, qui contiennent les propriétés suivantes :

ParamètreDescription
idLe nom principal de l'utilisateur Office 365. Voir la Documentation de l'API Azure AD Graph pour en savoir plus sur les utilisateurs et les groupes.
principalTypePerson ou Group

Par exemple

La requête suivante ajoute un organisateur à un bloc-notes du personnel.

POST ../v1.0/users/{leader-id}/notes/staffNotebooks/{notebook-id}/leaders 
Authorization: Bearer {token}
Content-Type: application/json
Accept: application/json

{
    "id": "leader2@contoso.com",
    "principalType": "Person"
}

Informations sur les requêtes et les réponses

Les informations suivantes s'appliquent aux POST /members et POST /leadersaux requêtes.

Données des requêtesDescription
ProtocoleToutes les requêtes utilisent le protocole SSL/TLS HTTPS.
En-tête d’autorisation

Bearer {token}, où le {jeton} est un jeton d'accès OAuth 2.0 valide pour votre application enregistrée.

S'il est manquant ou non valide, la demande échoue avec un code d'état 401. Voir Authentification avec Azure AD (applications d'entreprise).

En-tête Content-Typeapplication/json
En-tête d'acceptationapplication/json
Étendue d’autorisationNotes.ReadWrite.CreatedByApp, Notes.ReadWrite ou Notes.ReadWrite.All
Données de réponseDescription
Code de réussiteUn code d'état HTTP 201.
Corps de la réponseLe membre ou le chef qui a été ajouté.
ErreursSi la requête échoue, l'API renvoie les les erreurs dans l'objet @ api.diagnostics dans le corps de la réponse.
En-tête X-CorrelationIdUn GUID qui identifie la requête de manière unique. Vous pouvez utiliser cette valeur avec la valeur de l'en-tête Date lorsque vous faites appel au Microsoft Support pour résoudre les problèmes.

Supprimez des membres et des organisateurs

Supprimer des membres et des organisateurs d'un bloc-notes du personnel révoque leur accès au bloc-notes, mais ne supprime aucun contenu.

Pour supprimer un membre ou un organisateur d'un bloc-notes du personnel, envoyez une requête SUPPRIMER au point de terminaison approprié.

Supprimez un membre

DELETE ../staffNotebooks/{notebook-id}/members/{member-id}

Supprimer un organisateur

DELETE ../staffNotebooks/{notebook-id}/leaders/{leader-id}


Vous pouvez supprimer un membre ou un organisateur par requête.

Par exemple

La requête suivante supprime le membre spécifié du bloc-notes du personnel spécifié.

DELETE ../v1.0/users/{leader-id}/notes/staffNotebooks/{notebook-id}/members/{member-id} 
Authorization: Bearer {token}
Accept: application/json

Informations sur les requêtes et les réponses

Les informations suivantes s'appliquent aux DELETE /members et DELETE /leadersaux requêtes.

Données des requêtesDescription
ProtocoleToutes les requêtes utilisent le protocole SSL/TLS HTTPS.
En-tête d’autorisation

Bearer {token}, où le {jeton} est un jeton d'accès OAuth 2.0 valide pour votre application enregistrée.

S'il est manquant ou non valide, la demande échoue avec un code d'état 401. Voir Authentification avec Azure AD (applications d'entreprise).

En-tête d'acceptationapplication/json
Étendue d’autorisationNotes.ReadWrite.CreatedByApp, Notes.ReadWrite ou Notes.ReadWrite.All
Données de réponseDescription
Code de réussiteUn code d'état HTTP 204.
ErreursSi la requête échoue, l'API renvoie les les erreurs dans l'objet @ api.diagnostics dans le corps de la réponse.
En-tête X-CorrelationIdUn GUID qui identifie la requête de manière unique. Vous pouvez utiliser cette valeur avec la valeur de l'en-tête Date lorsque vous faites appel au Microsoft Support pour résoudre les problèmes.

Insérez des sections

Utilisez copySectionsToContentLibrary pour copier des sections spécifiques de blocs-notes Office 365 et les insérer dans la bibliothèque de contenu d'un bloc-notes du personnel. Une bibliothèque de contenu est un groupe de sections dans le bloc-notes du personnel disposant d'autorisations en lecture/écriture pour les organisateurs et d'autorisations en lecture pour les membres.

Pour insérer des sections dans un bloc-notes du personnel, envoyez une requête POST au point de terminaison copySectionsToContentLibrary du bloc-notes du personnel cible. Par exemple :

POST ../staffNotebooks/{notebook-id}/copySectionsToContentLibrary

Dans le corps du message, envoyez un objet JSON avec le paramètre sectionIds.

{
    "sectionIds": [
        "section1-id", 
        "section2-id",
        ...
    ]
}
ParamètreDescription
sectionIdsUn tableau qui contient les ID des sections que vous souhaitez insérer dans le bloc-notes du personnel.

L'utilisateur doit avoir un accès aux sections cible et aux bloc-notes (réservé ou partagé). Toutes les cibles doivent faire partie du même client.

Par exemple

La requête suivante insère deux sections dans la bibliothèque de contenu du bloc-notes du personnel spécifié.

POST ../v1.0/me/notes/staffNotebooks/{notebook-id}/copySectionsToContentLibrary
Authorization: Bearer {token}
Content-Type: application/json
Accept: application/json

{
    "sectionIds": [
        "1-85ba33b1-4959-4102-8dcd-d98e4e56e56f", 
        "1-8ba42j81-4959-4102-8dcd-d98e4e94s62ef"
    ]
}

Informations sur les requêtes et les réponses

Les informations suivantes s'appliquent aux POST /copySectionsToContentLibraryrequêtes.

Données des requêtesDescription
ProtocoleToutes les requêtes utilisent le protocole SSL/TLS HTTPS.
En-tête d’autorisation

Bearer {token}, où le {jeton} est un jeton d'accès OAuth 2.0 valide pour votre application enregistrée.

S'il est manquant ou non valide, la demande échoue avec un code d'état 401. Voir Authentification avec Azure AD (applications d'entreprise).

En-tête Content-Typeapplication/json
En-tête d'acceptationapplication/json
Étendue d’autorisationNotes.ReadWrite.CreatedByApp, Notes.ReadWrite ou Notes.ReadWrite.All
Données de réponseDescription
Code de réussiteUn code d'état HTTP 201.
ErreursSi la requête de création échoue, l'API renvoie les erreurs dans le corps de la réponse.
En-tête X-CorrelationIdUn GUID qui identifie la requête de manière unique. Vous pouvez utiliser cette valeur avec la valeur de l'en-tête Date lorsque vous faites appel au Microsoft Support pour résoudre les problèmes.

Construction de l'URL racine du service OneNote

L’URL racine du service OneNote utilise le format suivant pour tous les appels à l’API OneNote.

https://www.onenote.com/api/{version}/{location}/notes/


Le segment version dans l’URL représente la version de l’API OneNote que vous souhaitez utiliser.

  • Utilisez v1.0 pour le code de production stable.
  • Utilisez beta pour tester une fonctionnalité en cours de développement. Les fonctions et fonctionnalités en version bêta peuvent changer. Nous vous recommandons donc de ne pas les utiliser dans votre code de production.


Le segment location dans l’URL représente la localisation des blocs-notes auxquels vous souhaitez accéder.

Blocs-notes sur OneDrive Entreprise
Utilisez me pour le contenu OneNote appartenant à l’utilisateur actuel.

Utilisez users/{id} pour le contenu OneNote que l’utilisateur spécifié (dans l’URL) a partagé avec l’utilisateur actuel. Utilisez l’API de Azure AD Graph pour obtenir les ID utilisateurs.

Blocs-notes de sites SharePoint
Les sites d’équipe et d’autres sites SharePoint peuvent contenir des blocs-notes OneNote dans leurs bibliothèques de documents.

Utilisez myOrganization/siteCollections/{id}/sites/{id} pour le contenu OneNote sur un site du client auquel l’utilisateur actuel est connecté. Seul le client actuel est pris en charge et accessible en utilisant le mot-clé myOrganization. En savoir plus sur l’obtention des ID de sites.

Blocs-notes de groupe Office 365
Les groupes Office 365 font partie de l’expérience connectée Office 365. Les membres du groupe peuvent partager des blocs-notes, des fichiers et des e-mails.

Utilisez myOrganization/groups/{id} pour le contenu OneNote dans le groupe spécifié dont l’utilisateur actuel est membre. Seul le type de groupe Office 365 (qui renvoie le groupType unified) est pris en charge. Utilisez l’API de Azure AD Graph pour obtenir les ID de groupes.


Utilisez la méthode FromUrl pour obtenir la collection de sites et les ID de sites
Vous pouvez utiliser la méthode FromUrl pour obtenir la collection de sites et les ID de sites pour une URL de site absolue spécifiée. Vous devez effectuer cet appel uniquement lorsque cela est nécessaire, puis stocker les valeurs pour une utilisation ultérieure.

Le format de l’URL de site dépend de votre configuration, par exemple https://domain.sharepoint.com/site-a ou https://domain.com/sites/site-a.

Exemple de demande :

GET https://www.onenote.com/api/v1.0/myOrganization/siteCollections/FromUrl(url='{full-path-to-SharePoint-site}')
Authorization: Bearer {token}
Accept: application/json

Exemple de réponse :

{
  "@odata.context":"https://www.onenote.com/api/v1.0/$metadata#Microsoft.OneNote.Api.SiteMetadata",
  "siteCollectionId":"09d1a587-a84b-4264-3d15-669429be8cc5",
  "siteId":"d9e4d5c8-683f-4363-89ae-18c4e3da91e9"
}

Conditions préalables à l’utilisation de FromUrl et pour travailler avec des blocs-notes de sites SharePoint :

  • Vous pouvez uniquement créer des blocs-notes, des groupes de sections, des sections et des pages OneNote sur des sites disposant d’une bibliothèque de documents par défaut. (Certains modèles de sites ne créent pas de bibliothèque de documents par défaut.) Toutefois, les demandes GET renvoient le contenu OneNote de toutes les bibliothèques de documents sur le site.
  • L’URL racine du service OneNote n’est pas modifiable, ce qui signifie que vous ne pouvez pas utiliser un chemin d’accès au site de l’API REST SharePoint et ensuite y coller le point de terminaison notes.
  • L’utilisateur au nom duquel vous appelez doit être membre du site.
  • FromUrl fonctionne uniquement avec les sites qui ont été indexés. L’indexation d’un nouveau site peut prendre plusieurs heures.

Ressources supplémentaires

© 2018 Microsoft