Compartir a través de

Trabajar con blocs de notas del personal

  • Artículo

Se aplica a: blocs de notas empresariales en Office 365

Escuelas, colegios y universidades de todo el mundo utilizan blocs de notas del personal para ayudar a promover la productividad, el compromiso y la colaboración.

Puede utilizar el extremo staffNotebooks para realizar tareas comunes de blocs de notas del personal, como crear blocs de notas del personal y agregar o eliminar líderes o miembros.

Nota

La API de OneNote proporciona el punto de conexión staffNotebooks para las operaciones que son específicas de blocs de notas del personal.

Crear el URI de la solicitud

  1. Para construir el URI de solicitud, comience con la URL raíz del servicio de su plataforma:

    Blocs de notas en OneDrive para la Empresa

    https://www.onenote.com/api/v1.0/me/notes/

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

    Blocs de notas del sitio de SharePoint

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

    Blocs de notas de grupos unificados

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

  2. Agregue el punto de conexión staffNotebooks, seguido de una ruta de acceso de recurso, según se requiera:

    Crear blocs de notas del personal

    ../staffNotebooks[?omkt,sendemail]

    Actualizar un bloc de notas del personal

    ../staffNotebooks/{notebook-id}

    Obtener uno o más blocs de notas del personal

    ../staffNotebooks

    ../staffNotebooks/{notebook-id}

    Eliminar un bloc de notas del personal

    ../staffNotebooks/{notebook-id}

    Agregar miembros o líderes

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

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

    Eliminar miembros o líderes

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

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

    Insertar secciones

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

Su URI de solicitud completa tendrá más o menos el aspecto de estos ejemplos:

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

Nota

Obtenga más información sobre la URL raíz del servicio.

Crear blocs de notas del personal

Para crear un bloc de notas del personal, envíe una solicitud POST al extremo staffNotebooks.

POST ../staffNotebooks[?omkt,sendemail]

En el cuerpo del mensaje, envíe un objeto JSON con los parámetros de creación del bloc de notas del personal.

{
    "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
}
Parámetro Descripción
name El nombre del bloc de notas.
memberSections Una matriz que contiene uno o más nombres de sección. Estas secciones se crean en el grupo de secciones de cada miembro.
leaders Una matriz que contiene uno o más objetos principales.
members Una matriz que contiene uno o más objetos principales. Se crea un grupo de secciones para cada miembro.
hasLeaderOnlySectionGroup true para crear un grupo de secciones Solo líder que solo es visible para los líderes.
omkt Parámetro de consulta de URL que especifica el idioma para el bloc de notas. El valor predeterminado es en-us. Ejemplo: ?omkt=es-es
sendemail Parámetro de consulta de URL que especifica si se debe enviar una notificación por correo electrónico a los líderes y miembros asignados al bloc de notas al crearlo. El valor predeterminado es false.

Los líderes y miembros se representan mediante objetos principales, que contienen las siguientes propiedades:
Parámetro Descripción
id El nombre principal de usuario de Office 365.

Consulte la Documentación de la API de Azure AD Graph para obtener más información sobre usuarios y grupos.
principalType Person o Group

Idiomas admitidos

Puede utilizar el omkt={language-code} Parámetro de consulta de URL para crear un bloc de notas del personal en un idioma específico. Por ejemplo:

POST ../staffNotebooks?omkt=de-de

Son compatibles los siguientes códigos de idioma. El valor predeterminado es en-us.

Código Idioma
bg-bg Български (България)
cs-cz Čeština (Česká republika)
da-dk Dansk (Danmark)
de-de Deutsch (Deutschland)
el-gr Ελληνικά (Ελλάδα)
en-us Inglés (Estados Unidos)
es-es Español (España)
et-ee Eesti (Eesti)
fi-fi Suomi (Suomi)
fr-fr Français (France)
hi-in हिंदी (भारत)
hr-hr Hrvatski (Hrvatska)
hu-hu Magyar (Magyarország)
id-id Bahasa Indonesia (Indonesia)
it-it Italiano (Italia)
ja-jp 日本語 (日本)
kk-kz Қазақ (Қазақстан)
ko-kr 한국어 (대한민국)
lt-lt Lietuvių (Lietuva)
lv-lv Latviešu (Latvija)
ms-my Bahasa Melayu (Asia Tenggara)
nb-no Norsk (Norge)
nl-nl Nederlands (Nederland)
pl-pl Polski (Polska)
pt-br Português (Brasil)
pt-pt Português (Portugal)
ro-ro Română (România)
ru-ru Русский (Россия)
sk-sk Slovenčina (Slovenská republika)
sl-si Slovenski (Slovenija)
sr-latn-rs Srpski (Rep. Srbija i Rep. Crna Gora)
sv-se Svenska (Sverige)
th-th ไทย (ไทย)
tr-tr Türkçe (Türkiye)
uk-ua Українська (Україна)
vi-vn Tiếng Việt (Việt Nam)
zh-cn 简体中文 (中国)
zh-tw 繁體中文 (台灣)

Ejemplo

La siguiente solicitud crea un bloc de notas del personal Reuniones del personal.

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
}

Esto crea un bloc de notas del personal con cuatro grupos de secciones de miembros, cada uno con una sección Notas, Notas del personal y Resúmenes de reuniones. Solo el miembro correspondiente y el líder pueden acceder al grupo de secciones creado para un miembro. También se crea un grupo de secciones Solo líder que solo es visible para el líder. El parámetro de consulta sendemail=true especifica que se debe enviar una notificación por correo electrónico al líder y a los miembros cuando se crea el cuaderno.

Información de solicitud y respuesta

La siguiente información se aplica a las solicitudes POST /staffNotebooks.

Datos de solicitud Descripción
Protocolo Todas las solicitudes usan el protocolo HTTPS SSL/TLS.
Encabezado Authorization

Bearer {token}, donde {token} es un token de acceso de OAuth 2.0 válido para la aplicación registrada.

Si falta o no es válido, la solicitud producirá errores con el código de estado 401. Consulte Autenticar con Azure AD (aplicaciones empresariales).
Encabezado Content-Type application/json
Encabezado Accept application/json
Ámbito de permisos Notes.ReadWrite.CreatedByApp, Notes.ReadWrite o Notes.ReadWrite.All


Datos de respuesta Descripción
Código de correcto Código de estado HTTP 201.
Cuerpo de la respuesta Una representación de OData del nuevo bloc de notas en formato JSON.

Además de las propiedades normales de bloc de notas, los blocs de notas del personal también tienen las propiedades siguientes:
  • memberSections. Las secciones de miembros en los blocs de notas.
  • leaders. Los líderes que pueden acceder al bloc de notas.
  • member. Los miembros que pueden acceder al bloc de notas.
  • hasLeaderOnlySectionGroup. true si el bloc de notas contiene un grupo de secciones Sólo líder, de lo contrario false.
Errores Si se produce un error en la solicitud, la API devuelve errors en el objeto @api.diagnostics en el cuerpo de la respuesta.
Encabezado X-CorrelationId GUID que identifica la solicitud de forma única. Puede usar este valor junto con el valor del encabezado de fecha cuando trabaje con el soporte técnico de Microsoft para solucionar problemas.

Actualizar los blocs de notas del personal

Para actualizar un bloc de notas del personal, envíe una solicitud PATCH al extremo staffNotebooks / {id-bloc-de-notas}

Nota

Actualmente, solo la propiedad hasLeaderOnlySectionGroup se puede actualizar en una solicitud PATCH.

PATCH ../staffNotebooks/{notebook-id}

En el cuerpo del mensaje, envíe un objeto JSON con el parámetro update.

{
    "hasLeaderOnlySectionGroup": true
}
Parámetro Descripción
hasLeaderOnlySectionGroup true para añadir un grupo de secciones Solo líder que solo es visible para los líderes. false no es compatible.

Consulte estos métodos para conocer otras formas de cambiar los blocs de notas del personal: Agregar miembros o líderes, Eliminar miembros o líderes, Insertar secciones.

Ejemplo

La siguiente solicitud agrega un grupo de secciones Solo líder al bloc de notas del personal especificado.

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

{
    "hasLeaderOnlySectionGroup": true
}

El nuevo grupo de secciones Solo líder es visible solo para los líderes.

Información de solicitud y respuesta

La siguiente información se aplica a las solicitudes PATCH ../staffNotebooks/{notebook-id}.

Datos de solicitud Descripción
Protocolo Todas las solicitudes usan el protocolo HTTPS SSL/TLS.
Encabezado Authorization

Bearer {token}, donde {token} es un token de acceso de OAuth 2.0 válido para la aplicación registrada.

Si falta o no es válido, la solicitud producirá errores con el código de estado 401. Consulte Autenticar con Azure AD (aplicaciones empresariales).
Encabezado Content-Type application/json
Encabezado Accept application/json
Ámbito de permisos Notes.ReadWrite.CreatedByApp, Notes.ReadWrite o Notes.ReadWrite.All


Datos de respuesta Descripción
Código correcto Un código de estado HTTP 204.
Errores Si se produce un error en la solicitud, la API devolverá errores en el cuerpo de la respuesta.
Encabezado X-CorrelationId GUID que identifica la solicitud de forma única. Puede usar este valor junto con el valor del encabezado de fecha cuando trabaje con el soporte técnico de Microsoft para solucionar problemas.

Obtenga blocs de notas del personal

Para obtener uno o más blocs de notas del personal, envíe una solicitud GET al extremo staffNotebooks.

Obtener uno o más blocs de notas del personal

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

Obtener un bloc de notas del personal específico

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

Los blocs de notas pueden ampliar las propiedades leaders y members. El criterio de ordenación predeterminado es name asc.

También se devuelven blocs de notas del personal para solicitudes GET /notebooks, pero los resultados no incluirán propiedades específicas de blocs de notas del personal.

Ejemplo

La siguiente solicitud obtiene los blocs de notas del personal creados desde el 1 de enero de 2016.

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

Para obtener más información sobre cómo obtener blocs de notas, incluidas las opciones y ejemplos de cadenas de consulta compatibles, consulte Obtener contenido y estructura de OneNote.

Información de solicitud y respuesta

La siguiente información se aplica a las solicitudes GET /staffNotebooks.

Datos de solicitud Descripción
Protocolo Todas las solicitudes usan el protocolo HTTPS SSL/TLS.
Encabezado Authorization

Bearer {token}, donde {token} es un token de acceso de OAuth 2.0 válido para la aplicación registrada.

Si falta o no es válido, la solicitud producirá errores con el código de estado 401. Consulte Autenticar con Azure AD (aplicaciones empresariales).
Encabezado Accept application/json
Ámbito de permisos Notes.Read, Notes.ReadWrite.CreatedByApp, Notes.ReadWrite o Notes.ReadWrite.All


Datos de respuesta Descripción
Código de correcto Un código de estado HTTP 200.
Cuerpo de la respuesta Una representación de OData de los blocs de notas del personal en formato JSON.

Además de las propiedades normales de bloc de notas, los blocs de notas del personal también tienen las propiedades siguientes:
  • memberSections. Las secciones de miembros en los blocs de notas.
  • leaders. Los líderes que pueden acceder al bloc de notas.
  • member. Los miembros que pueden acceder al bloc de notas.
  • hasLeaderOnlySectionGroup. true si el bloc de notas contiene un grupo de secciones Sólo líder, de lo contrario false.
Errores Si se produce un error en la solicitud, la API devuelve errors en el objeto @api.diagnostics en el cuerpo de la respuesta.
Encabezado X-CorrelationId GUID que identifica la solicitud de forma única. Puede usar este valor junto con el valor del encabezado de fecha cuando trabaje con el soporte técnico de Microsoft para solucionar problemas.

Eliminar blocs de notas del personal

Para eliminar un bloc de notas del personal, envíe una solicitud DELETE al extremo staffNotebooks / {id-bloc-de-notas}.

DELETE ../staffNotebooks/{notebook-id}

Ejemplo

La siguiente solicitud elimina el bloc de notas del personal especificado.

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

Información de solicitud y respuesta

La siguiente información se aplica a las solicitudes DELETE ../staffNotebooks/{notebook-id}.

Datos de solicitud Descripción
Protocolo Todas las solicitudes usan el protocolo HTTPS SSL/TLS.
Encabezado Authorization

Bearer {token}, donde {token} es un token de acceso de OAuth 2.0 válido para la aplicación registrada.

Si falta o no es válido, la solicitud producirá errores con el código de estado 401. Consulte Autenticar con Azure AD (aplicaciones empresariales).
Encabezado Accept application/json
Ámbito de permisos Notes.ReadWrite.CreatedByApp, Notes.ReadWrite o Notes.ReadWrite.All


Datos de respuesta Descripción
Código correcto Un código de estado HTTP 204.
Errores Si se produce un error en la solicitud, la API devolverá errores en el cuerpo de la respuesta.
Encabezado X-CorrelationId GUID que identifica la solicitud de forma única. Puede usar este valor junto con el valor del encabezado de fecha cuando trabaje con el soporte técnico de Microsoft para solucionar problemas.

Agregar miembros y líderes

Agregar líderes y miembros les da acceso al bloc de notas del personal. Agregar un miembro también crea un grupo de secciones del miembro. El miembro y el líder pueden acceder a este grupo de secciones, que contiene las secciones del miembro definidas para el bloc de notas.

Para agregar un miembro o un líder a un bloc de notas del personal, envíe una solicitud POST al extremo adecuado.

Agregar un miembro

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

Agregar un líder

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

Envía un objeto principal JSON en el cuerpo del mensaje. Puede agregar un miembro o un líder por solicitud.

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

Los líderes y miembros se representan mediante objetos principales, que contienen las siguientes propiedades:

Parámetro Descripción
id El nombre principal de usuario de Office 365. Consulte la Documentación de la API de Azure AD Graph para obtener más información sobre usuarios y grupos.
principalType Person o Group

Ejemplo

La siguiente solicitud agrega un líder al bloc de notas del personal especificado.

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

Información de solicitud y respuesta

La siguiente información se aplica a las solicitudes POST /members y POST /leaders.

Datos de solicitud Descripción
Protocolo Todas las solicitudes usan el protocolo HTTPS SSL/TLS.
Encabezado Authorization

Bearer {token}, donde {token} es un token de acceso de OAuth 2.0 válido para la aplicación registrada.

Si falta o no es válido, la solicitud producirá errores con el código de estado 401. Consulte Autenticar con Azure AD (aplicaciones empresariales).
Encabezado Content-Type application/json
Encabezado Accept application/json
Ámbito de permisos Notes.ReadWrite.CreatedByApp, Notes.ReadWrite o Notes.ReadWrite.All


Datos de respuesta Descripción
Código de correcto Código de estado HTTP 201.
Cuerpo de la respuesta El miembro o líder que se agregó.
Errores Si se produce un error en la solicitud, la API devuelve errors en el objeto @api.diagnostics en el cuerpo de la respuesta.
Encabezado X-CorrelationId GUID que identifica la solicitud de forma única. Puede usar este valor junto con el valor del encabezado de fecha cuando trabaje con el soporte técnico de Microsoft para solucionar problemas.

Eliminar miembros o líderes

La eliminación de miembros y líderes de un bloc de notas del personal revoca su acceso al bloc de notas, pero no elimina ningún contenido.

Para agregar un miembro o líder a un bloc de notas del personal, envíe una solicitud DELETE al extremo adecuado.

Quitar un miembro

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

Eliminar un líder

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

Puede eliminar un miembro o un líder por solicitud.

Ejemplo

La siguiente solicitud elimina el miembro especificado del bloc de notas del personal especificado.

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

Información de solicitud y respuesta

La siguiente información se aplica a las solicitudes DELETE /members y DELETE /leaders.

Datos de solicitud Descripción
Protocolo Todas las solicitudes usan el protocolo HTTPS SSL/TLS.
Encabezado Authorization

Bearer {token}, donde {token} es un token de acceso de OAuth 2.0 válido para la aplicación registrada.

Si falta o no es válido, la solicitud producirá errores con el código de estado 401. Consulte Autenticar con Azure AD (aplicaciones empresariales).
Encabezado Accept application/json
Ámbito de permisos Notes.ReadWrite.CreatedByApp, Notes.ReadWrite o Notes.ReadWrite.All


Datos de respuesta Descripción
Código correcto Un código de estado HTTP 204.
Errores Si se produce un error en la solicitud, la API devuelve errors en el objeto @api.diagnostics en el cuerpo de la respuesta.
Encabezado X-CorrelationId GUID que identifica la solicitud de forma única. Puede usar este valor junto con el valor del encabezado de fecha cuando trabaje con el soporte técnico de Microsoft para solucionar problemas.

Insertar secciones

Utilice copySectionsToContentLibrary para copiar secciones específicas de blocs de notas de Office 365 e insertarlos en la biblioteca de contenido de un bloc de notas del personal. Una biblioteca de contenido es un grupo de secciones del bloc de notas del personal que tiene permisos de lectura/escritura para los líderes y permisos de lectura para los miembros.

Para insertar secciones en un bloc de notas del personal, envíe una solicitud POST al extremo copySectionsToContentLibrary del bloc de notas del personal de destino. Por ejemplo:

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

En el cuerpo del mensaje, envíe un objeto JSON con el parámetro sectionIds.

{
    "sectionIds": [
        "section1-id", 
        "section2-id",
        ...
    ]
}
Parámetro Descripción
sectionIds Una matriz que contiene los Id. de las secciones que desea insertar en el bloc de notas del personal.

El usuario debe tener acceso a bloc de notas y secciones de destino (propio o compartido). Todos los destinos deben estar en la misma cuenta empresarial.

Ejemplo

La siguiente solicitud inserta dos secciones en la bBiblioteca de contenido del bloc de notas del personal especificado.

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

Información de solicitud y respuesta

La siguiente información se aplica a las solicitudes POST /copySectionsToContentLibrary.

Datos de solicitud Descripción
Protocolo Todas las solicitudes usan el protocolo HTTPS SSL/TLS.
Encabezado Authorization

Bearer {token}, donde {token} es un token de acceso de OAuth 2.0 válido para la aplicación registrada.

Si falta o no es válido, la solicitud producirá errores con el código de estado 401. Consulte Autenticar con Azure AD (aplicaciones empresariales).
Encabezado Content-Type application/json
Encabezado Accept application/json
Ámbito de permisos Notes.ReadWrite.CreatedByApp, Notes.ReadWrite o Notes.ReadWrite.All


Datos de respuesta Descripción
Código de correcto Un código de estado HTTP 201.
Errores Si se produce un error en la solicitud, la API devuelve errores en el cuerpo de la respuesta.
Encabezado X-CorrelationId GUID que identifica la solicitud de forma única. Puede usar este valor junto con el valor del encabezado de fecha cuando trabaje con el soporte técnico de Microsoft para solucionar problemas.

Construir la URL raíz del servicio de OneNote

La dirección URL raíz del servicio OneNote utiliza el siguiente formato para todas las llamadas a la API de OneNote.

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

El segmento version de la URL representa la versión de la API de OneNote que desea utilizar.

  • Use v1.0 para un código de producción estable.

  • Use beta para probar una característica que esté en desarrollo. Las características y funcionalidades de la versión beta pueden cambiar, por lo que no debería usarla su código de producción.

El segmento location de la URL representa la ubicación de los blocs de notas a los que desea acceder:

  • Blocs de notas en OneDrive para la Empresa

    • Use me para el contenido de OneNote que sea propiedad del usuario actual.

    • Use users/{id} para el contenido de OneNote que el usuario especificado (en la URL) compartió con el usuario actual. Use la API de Azure AD Graph para obtener id. de usuario.

  • Blocs de notas del sitio de SharePoint

    • Los sitios de grupo y otros sitios de SharePoint pueden contener blocs de notas de OneNote en sus bibliotecas de documentos.

    • Use myOrganization/siteCollections/{id}/sites/{id} para el contenido de OneNote en un sitio de la cuenta empresarial donde el usuario actual haya iniciado sesión. Solo se admite la cuenta empresarial actual, a la que se accedió empleando la palabra clave myOrganization. Descubra cómo obtener identificadores de sitio.

  • Blocs de notas de grupos unificados

    • Los grupos unificados (también denominados grupos de Office 365) forman parte de la experiencia conectada de Office 365. Los miembros del grupo pueden compartir blocs de notas, archivos y correos electrónicos.

    • Utilice myOrganization/groups/{id} para el contenido de OneNote en el grupo especificado del que el usuario actual sea miembro. Los grupos unificados son el único tipo de grupo compatible. Use la API de Azure AD Graph para obtener identificadores de usuario.

Utilizar el método FromUrl para obtener la colección y los identificadores de sitios

Puede usar el método FromUrl para obtener la colección y los id. de sitios para una URL de sitio absoluta y específica. Debe realizar esta llamada solo cuando sea necesario y luego guardar los valores para usarlos en el futuro.

El formato de la URL de sitio depende de su configuración, por ejemplo https://domain.sharepoint.com/site-a o https://domain.com/sites/site-a.

Ejemplo de solicitud

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

Authorization: Bearer {token}

Accept: application/json

Respuesta de ejemplo

{"@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"}

Requisitos para usar FromUrl y trabajar con blocs de notas del sitio de SharePoint:

  • Solo puede crear blocs de notas de OneNote, grupos de secciones, secciones y páginas en sitios que tengan una biblioteca de documentos predeterminada. (Algunas plantillas de sitio no crean una biblioteca de documentos predeterminada). Sin embargo, las solicitudes GET devuelven contenido de OneNote de todas las bibliotecas de documentos del sitio.

  • La URL raíz del servicio de OneNote es inmutable, lo que significa que no puede usar una ruta de acceso al sitio de la API de REST de SharePoint y luego añadirle el punto de conexión notes.

  • El usuario en cuyo nombre está realizando la llamada debe ser miembro del sitio.

  • FromUrl funciona solo con sitios que hayan sido indexados. Puede llevar varias horas indexar un nuevo sitio.

Vea también