Créer des liens de partage sur des entités OneNote
**S'applique aux **: Blocs-notes d'entreprise sur Office 365
Créer un lien de partage permettant de partager un fichier OneNote avec n'importe qui. Vous pouvez utiliser cette API pour créer, obtenir et révoquer des liens invité anonymes. Les liens invités accorderont des autorisations d'édition ou des autorisations en lecture seule sans nécessiter de connexion.
GET ../sectiongroups/{sectiongroup-id}/Microsoft.OneNote.Api.GetAnonymousSharingLink
POST ../sectiongroups/{sectiongroup-id}/Microsoft.OneNote.Api.GetOrCreateAnonymousSharingLink
DELETE ../sectiongroups/{sectiongroup-id}/Microsoft.OneNote.Api.RevokeAnonymousSharingLink
Notes
Les liens de partage sont pris en charge pour les bloc-notes Office 365 personnels, de site et de groupe, mais pas pour les bloc-notes grand public OneDrive. Pour le moment, seules les entités de groupes de sections sont actuellement prises en charge.
Construire l’URI de la 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 chemin d'accès à l'entité de groupe de section, suivi des fonctions de partage de lien.
Votre requête URI complète ressemblera à ces exemples :
https://www.onenote.com/api/v1.0/me/notes/sectiongroups/{id}/Microsoft.OneNote.Api.GetOrCreateAnonymousSharingLink
https://www.onenote.com/api/v1.0/users/{id}/notes/sectiongroups/{id}/Microsoft.OneNote.Api.GetOrCreateAnonymousSharingLink
https://www.onenote.com/api/v1.0/myOrganization/siteCollections/{id}/sites/{id}/notes/sectiongroups/{id}/Microsoft.OneNote.Api.GetOrCreateAnonymousSharingLink
https://www.onenote.com/api/v1.0/myOrganization/groups/{id}/notes/sections/{id}/Microsoft.OneNote.Api.GetOrCreateAnonymousSharingLink
Créer un lien de partage anonyme
Pour créer un lien anonyme pour un groupe de section, envoyez une requête GET en utilisant le point de terminaison approprié.
GET ../sectiongroups/{sectiongroup-id}/Microsoft.OneNote.Api.GetAnonymousSharingLink
Le paramètre de fonction accessLevel enum indique le niveau d'accès du lien de partage.
| Valeurs de paramètre accessLevel enum | Niveau d’accès du lien de partage pour créer (afficher ou modifier) |
|---|---|
| Vue | Crée un lien en lecture seule vers l’élément. |
| Modifier | Crée un lien en lecture/écriture vers l’élément. |
Exemple
Demande
GET ../api/v1.0/me/notes/sectionGroups/{sectiongroup-id}/Microsoft.OneNote.Api.GetAnonymousSharingLink(accessLevel=Microsoft.OneNote.Api.SharingLinkAccessLevel'View')
Authorization: Bearer {token}
Content-Type: application/json
Accept: application/json
Réponse
HTTP/1.1 200 Ok
{
"@odata.context":"https://www.onenote.com/api/v1.0/$metadata#Edm.String",
"value":"https://www.contoso.com/_layouts/15/WopiFrame.aspx?folderid=084a6fcc95ab54a678257e1b9cba41e7e&authkey=AXXriBu-O475sT4tfJeJDkA&FixProgId=1"
}
Informations sur les requêtes et les réponses
Les informations suivantes s’appliquent aux requêtes GET /GetAnonymousSharingLink.
| Données des requêtes | Description |
|---|---|
| Protocole | Toutes les demandes utilisent le protocole HTTPS SSL/TLS. |
| En-tête Authorization | Bearer {token}, où {token} est un jeton d’accès OAuth 2.0 valide pour votre application inscrite.En cas de jeton manquant ou non valide, la requête échoue et le code d’état 401 s’affiche. Voir Authentification avec Azure AD (applications d'entreprise). |
| Étendue d’autorisation | Notes.ReadWrite ou Notes.ReadWrite.All |
| Données de réponse | Description |
|---|---|
| Code de succès | Code d’état HTTP 200. |
| Corps de la réponse | Une représentation OData de la valeur au format JSON. |
| Erreurs | Si la requête échoue, l'API renvoie des erreurs dans le corps de la réponse. |
| En-tête X-CorrelationId | GUID qui permet d’identifier la requête de manière unique. Vous pouvez utiliser cette valeur avec la valeur de l'en-tête Date lorsque vous utilisez le support Microsoft pour résoudre les problèmes. |
Obtenir ou créer un lien invité anonyme
Suivez ces étapes pour obtenir le lien existant ou en créer un s'il n'existe pas. Le lien anonyme peut être utilisé pour afficher un fichier OneNote sans vous connecter.
POST ../api/v1.0/me/notes/sectionGroups/{sectiongroup-id}/Microsoft.OneNote.Api.GetOrCreateAnonymousSharingLink
Dans le corps du message, envoyez un objet JSON avec le paramètre requis.
| Valeurs de paramètre accessLevel enum | Niveau d’accès du lien de partage pour créer (afficher ou modifier) |
|---|---|
| Vue | Crée un lien en lecture seule vers l’élément. |
| Modifier | Crée un lien en lecture/écriture vers l’élément. |
Exemple
Demande
POST ../api/v1.0/me/notes/sectionGroups/{sectiongroup-id}/Microsoft.OneNote.Api.GetOrCreateAnonymousSharingLink
Authorization: Bearer {token}
Content-Type: application/json
Accept: application/json
Réponse
HTTP/1.1 200 Ok
{
"@odata.context":"https://www.onenote.com/api/v1.0/$metadata#Edm.String",
"value":"https://www.contoso.com/_layouts/15/WopiFrame.aspx?folderid=084a6fcc95ab54a678257e1b9cba41e7e&authkey=AXXriBu-O475sT4tfJeJDkA&FixProgId=1"
}
Informations sur les requêtes et les réponses
Les informations suivantes s’appliquent aux requêtes POST /GetOrCreateAnonymousSharingLink.
| Données des requêtes | Description |
|---|---|
| Protocole | Toutes les demandes utilisent le protocole HTTPS SSL/TLS. |
| En-tête Authorization | Bearer {token}, où {token} est un jeton d’accès OAuth 2.0 valide pour votre application inscrite.En cas de jeton manquant ou non valide, la requête échoue et le code d’état 401 s’affiche. Voir Authentification avec Azure AD (applications d'entreprise). |
| Étendue d’autorisation | Notes.ReadWrite ou Notes.ReadWrite.All |
| Données de réponse | Description |
|---|---|
| Code de succès | Code d’état HTTP 200. |
| Corps de la réponse | Une représentation OData de la valeur au format JSON. |
| Erreurs | Si la requête échoue, l'API renvoie des erreurs dans le corps de la réponse. |
| En-tête X-CorrelationId | GUID qui permet d’identifier la requête de manière unique. Vous pouvez utiliser cette valeur avec la valeur de l'en-tête Date lorsque vous utilisez le support Microsoft pour résoudre les problèmes. |
Révoquer le lien invité anonyme
Suivez ces étapes pour révoquer un lien de partage existant pour un groupe de sections.
DELETE ../v1.0/me/notes/sectiongroups/{sectiongroup-id}/Microsoft.OneNote.Api.RevokeAnonymousSharingLink
Dans le corps du message, envoyez un objet JSON avec le paramètre requis.
| Valeurs de paramètre accessLevel enum | Niveau d’accès du lien de partage pour créer (afficher ou modifier) |
|---|---|
| Vue | Crée un lien en lecture seule vers l’élément. |
| Modifier | Crée un lien en lecture/écriture vers l’élément. |
Exemple
Demande
DELETE ../v1.0/me/notes/sectiongroups/{sectiongroup-id}/Microsoft.OneNote.Api.RevokeAnonymousSharingLink
Authorization: Bearer {token}
Accept: application/json
{
“accessLevel”: “view”
}
Réponse
HTTP/1.1 204 No Content
Informations sur les requêtes et les réponses
Les informations suivantes s’appliquent aux requêtes DELETE /RevokeAnonymousSharingLink.
| Données des requêtes | Description |
|---|---|
| Protocole | Toutes les demandes utilisent le protocole HTTPS SSL/TLS. |
| En-tête Authorization | Bearer {token}, où {token} est un jeton d’accès OAuth 2.0 valide pour votre application inscrite.En cas de jeton manquant ou non valide, la requête échoue et le code d’état 401 s’affiche. Voir Authentification avec Azure AD (applications d'entreprise). |
| Étendue d’autorisation | Notes.ReadWrite ou Notes.ReadWrite.All |
| Données de réponse | Description |
|---|---|
| Code de succès | Code d’état HTTP 200. |
| Erreurs | Si la requête échoue, l'API renvoie des erreurs dans le corps de la réponse. |
| En-tête X-CorrelationId | GUID qui permet d’identifier la requête de manière unique. Vous pouvez utiliser cette valeur avec la valeur de l'en-tête Date lorsque vous utilisez le support Microsoft pour résoudre les problèmes. |
Activer ou désactiver le partage externe pour un environnement SharePoint Online
Gérer le partage externe pour votre environnement SharePoint Online
Construire l’URL racine du service OneNote
L’URL racine du service OneNote utilise le format suivant pour tous les appels à OneNote API.
https://www.onenote.com/api/{version}/{location}/notes/
Le segment version dans l’URL représente la version de OneNote API que vous souhaitez utiliser.
- Utilisez
v1.0pour le code de production stable. - Utilisez
betapour tester une fonctionnalité en cours de développement. Les fonctions et fonctionnalités en version bêta peuvent être sujettes à des modifications. 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.
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 unifié) 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 requête
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.