Crear sección
Espacio de nombres: microsoft.graph
Cree una instancia de onenoteSection en el cuaderno especificado.
Esta API está disponible en las siguientes implementaciones nacionales de nube.
Servicio global | Gobierno de EE. UU. L4 | Us Government L5 (DOD) | China operada por 21Vianet |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
Permissions
Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.
Tipo de permiso | Permisos con privilegios mínimos | Permisos con privilegios más altos |
---|---|---|
Delegado (cuenta profesional o educativa) | Notes.Create | Notes.ReadWrite, Notes.ReadWrite.All |
Delegado (cuenta personal de Microsoft) | Notes.Create | Notes.ReadWrite |
Aplicación | Notes.ReadWrite.All | No disponible. |
Solicitud HTTP
POST /me/onenote/notebooks/{id}/sections
POST /users/{id | userPrincipalName}/onenote/notebooks/{id}/sections
POST /groups/{id}/onenote/notebooks/{id}/sections
POST /sites/{id}/onenote/notebooks/{id}/sections
Encabezados de solicitud
Nombre | Tipo | Descripción |
---|---|---|
Authorization | string | {token} de portador. Obligatorio. |
Content-Type | string | application/json |
Cuerpo de la solicitud
En el cuerpo de la solicitud, asigne un nombre a la sección.
Dentro del mismo nivel de jerarquía, los nombres de sección deben ser únicos. El nombre no puede contener más de 50 caracteres ni contener los siguientes caracteres: ?*/:<>|''%~
Respuesta
Si se ejecuta correctamente, este método devuelve un 201 Created
código de respuesta y un objeto onenoteSection en el cuerpo de la respuesta.
Ejemplo
Solicitud
En el ejemplo siguiente se muestra la solicitud.
POST https://graph.microsoft.com/v1.0/me/onenote/notebooks/{id}/sections
Content-type: application/json
{
"displayName": "Section name"
}
Respuesta
En el ejemplo siguiente se muestra la respuesta. Nota: El objeto de respuesta que se muestra aquí se trunca por brevedad. Todas las propiedades se devolverán desde una llamada real.
HTTP/1.1 201 Created
Content-type: application/json
{
"isDefault": true,
"pagesUrl": "pagesUrl-value",
"displayName": "name-value",
"createdBy": {
"user": {
"id": "id-value",
"displayName": "displayName-value"
}
},
"lastModifiedBy": {
"user": {
"id": "id-value",
"displayName": "displayName-value"
}
}
}
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de