Table of contents
TOC
Collapse the table of content
Expand the table of content
Última actualización: 20/06/2018

Trabajar con blocs de notas del personal

Se aplica a: Bloc 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.

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 solicitud

Para crear el URI de solicitud, comience con la URL raíz del servicio para 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/


A continuación, agregue el extremo 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 completo tendrá un aspecto similar a los ejemplos siguientes:

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

Obtenga más información sobre service root URL.

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ámetroDescripción
nameEl nombre del bloc de notas.
memberSectionsUna matriz que contiene uno o más nombres de sección. Estas secciones se crean en el grupo de secciones de cada miembro.
leadersUna matriz que contiene uno o más objetos principales.
membersUna matriz que contiene uno o más objetos principales. Se crea un grupo de secciones para cada miembro.
hasLeaderOnlySectionGrouptrue para crear un grupo de secciones Solo líder que solo es visible para los líderes.
omktParámetro de consulta de URL que especifica el idioma para el bloc de notas. El valor predeterminado es en-us. Ejemplo: ?omkt=es-es
sendemailPará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ámetroDescripción
idEl 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.
principalTypePerson 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ódigoIdioma
bg-bgБългарски (България)
cs-czČeština (Česká republika)
da-dkDansk (Danmark)
de-deDeutsch (Deutschland)
el-grΕλληνικά (Ελλάδα)
en-usInglés (Estados Unidos)
es-esEspañol (España)
et-eeEesti (Eesti)
fi-fiSuomi (Suomi)
fr-frFrançais (France)
hi-inहिंदी (भारत)
hr-hrHrvatski (Hrvatska)
hu-huMagyar (Magyarország)
id-idBahasa Indonesia (Indonesia)
it-itItaliano (Italia)
ja-jp日本語 (日本)
kk-kzҚазақ (Қазақстан)
ko-kr한국어 (대한민국)
lt-ltLietuvių (Lietuva)
lv-lvLatviešu (Latvija)
ms-myBahasa Melayu (Asia Tenggara)
nb-noNorsk (Norge)
nl-nlNederlands (Nederland)
pl-plPolski (Polska)
pt-brPortuguês (Brasil)
pt-ptPortuguês (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繁體 中文 (台灣)

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 solicitudDescripción
ProtocoloTodas 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 la solicitud falta o no es válida, se produce un error de la solicitud con un código de estado 401. Consulte Autenticar con Azure AD (aplicaciones empresariales).

Encabezado Content-Typeapplication/json
Encabezado Acceptapplication/json
Ámbito de permisoNotes.ReadWrite.CreatedByApp, Notes.ReadWrite o Notes.ReadWrite.All
Datos de respuestaDescripción
Código correctoUn código de estado HTTP 201.
Cuerpo de la respuestaUna 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.
ErroresSi se produce un error en la solicitud, la API devuelve errors en el objeto @api.diagnostics en el cuerpo de la respuesta.
Encabezado X-CorrelationIdGUID que identifica la solicitud de manera única. Puede utilizar este valor junto con el valor del encabezado Date 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}

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ámetroDescripción
hasLeaderOnlySectionGrouptrue 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 solicitudDescripción
ProtocoloTodas 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 la solicitud falta o no es válida, se produce un error de la solicitud con un código de estado 401. Consulte Autenticar con Azure AD (aplicaciones empresariales).

Encabezado Content-Typeapplication/json
Encabezado Acceptapplication/json
Ámbito de permisoNotes.ReadWrite.CreatedByApp, Notes.ReadWrite o Notes.ReadWrite.All
Datos de respuestaDescripción
Código correctoUn código de estado HTTP 204.
ErroresSi se produce un error en la solicitud, la API devuelve errores en el cuerpo de la respuesta.
Encabezado X-CorrelationIdGUID que identifica la solicitud de manera única. Puede utilizar este valor junto con el valor del encabezado Date 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 expandir 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 bloc 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 solicitudDescripción
ProtocoloTodas 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 la solicitud falta o no es válida, se produce un error de la solicitud con un código de estado 401. Consulte Autenticar con Azure AD (aplicaciones empresariales).

Encabezado Acceptapplication/json
Ámbito de permisoNotes.Read, Notes.ReadWrite.CreatedByApp, Notes.ReadWrite o Notes.ReadWrite.All
Datos de respuestaDescripción
Código de correctoUn código de estado HTTP 200.
Cuerpo de la respuestaUna 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.
ErroresSi se produce un error en la solicitud, la API devuelve errors en el objeto @api.diagnostics en el cuerpo de la respuesta.
Encabezado X-CorrelationIdGUID que identifica la solicitud de manera única. Puede utilizar este valor junto con el valor del encabezado Date 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 solicitudDescripción
ProtocoloTodas 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 la solicitud falta o no es válida, se produce un error de la solicitud con un código de estado 401. Consulte Autenticar con Azure AD (aplicaciones empresariales).

Encabezado Acceptapplication/json
Ámbito de permisoNotes.ReadWrite.CreatedByApp, Notes.ReadWrite o Notes.ReadWrite.All
Datos de respuestaDescripción
Código correctoUn código de estado HTTP 204.
ErroresSi se produce un error en la solicitud, la API devuelve errores en el cuerpo de la respuesta.
Encabezado X-CorrelationIdGUID que identifica la solicitud de manera única. Puede utilizar este valor junto con el valor del encabezado Date 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


Enviar 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ámetroDescripción
idEl 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.
principalTypePerson 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 solicitudDescripción
ProtocoloTodas 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 la solicitud falta o no es válida, se produce un error de la solicitud con un código de estado 401. Consulte Autenticar con Azure AD (aplicaciones empresariales).

Encabezado Content-Typeapplication/json
Encabezado Acceptapplication/json
Ámbito de permisoNotes.ReadWrite.CreatedByApp, Notes.ReadWrite o Notes.ReadWrite.All
Datos de respuestaDescripción
Código correctoUn código de estado HTTP 201.
Cuerpo de la respuestaEl miembro o líder que se agregó.
ErroresSi se produce un error en la solicitud, la API devuelve errors en el objeto @api.diagnostics en el cuerpo de la respuesta.
Encabezado X-CorrelationIdGUID que identifica la solicitud de manera única. Puede utilizar este valor junto con el valor del encabezado Date 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.

Eliminar 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 solicitudDescripción
ProtocoloTodas 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 la solicitud falta o no es válida, se produce un error de la solicitud con un código de estado 401. Consulte Autenticar con Azure AD (aplicaciones empresariales).

Encabezado Acceptapplication/json
Ámbito de permisoNotes.ReadWrite.CreatedByApp, Notes.ReadWrite o Notes.ReadWrite.All
Datos de respuestaDescripción
Código correctoUn código de estado HTTP 204.
ErroresSi se produce un error en la solicitud, la API devuelve errors en el objeto @api.diagnostics en el cuerpo de la respuesta.
Encabezado X-CorrelationIdGUID que identifica la solicitud de manera única. Puede utilizar este valor junto con el valor del encabezado Date 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ámetroDescripción
sectionIdsUna 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 el mismo inquilino.

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 solicitudDescripción
ProtocoloTodas 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 la solicitud falta o no es válida, se produce un error de la solicitud con un código de estado 401. Consulte Autenticar con Azure AD (aplicaciones empresariales).

Encabezado Content-Typeapplication/json
Encabezado Acceptapplication/json
Ámbito de permisoNotes.ReadWrite.CreatedByApp, Notes.ReadWrite o Notes.ReadWrite.All
Datos de respuestaDescripción
Código correctoUn código de estado HTTP 201.
ErroresSi se produce un error en la solicitud, la API devuelve errores en el cuerpo de la respuesta.
Encabezado X-CorrelationIdGUID que identifica la solicitud de manera única. Puede utilizar este valor junto con el valor del encabezado Date cuando trabaje con el soporte técnico de Microsoft para solucionar problemas.

Crear la URL raíz del servicio de OneNote

La dirección URL raíz del servicio de 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.

  • Utilice 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 funciones pueden cambiar en la versión beta, por lo que le recomendamos que no la use en 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.

Utilice users/{id} para el contenido de OneNote que el usuario especificado (en la URL) haya compartido 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.

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

Blocs de notas de grupo de Office 365
Los grupos de Office 365 son 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 de Office 365 (que devuelven el unified groupType) son el único tipo de grupo admitido. Use la API de Azure AD Graph para obtener id. de usuario.


Utilizar el método FromUrl para obtener la colección y los id. 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

Ejemplo de respuesta:

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

Recursos adicionales

© 2018 Microsoft