notebook: copyNotebook
Espacio de nombres: microsoft.graph
Importante
Las API de la versión /beta
de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.
Copia un cuaderno en la carpeta Cuadernos de la biblioteca de documentos de destino. La carpeta se crea si no existe.
Para las operaciones de copia, siga un patrón de llamada asincrónica: llame primero a la acción Copiar y, a continuación, sondee el punto de conexión de la operación para obtener el resultado.
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}/copyNotebook
POST /users/{id | userPrincipalName}/onenote/notebooks/{id}/copyNotebook
POST /groups/{id}/onenote/notebooks/{id}/copyNotebook
POST /sites/{id}/onenote/notebooks/{id}/copyNotebook
Encabezados de solicitud
Nombre | Tipo | Descripción |
---|---|---|
Authorization | string | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
Content-Type | string | application/json |
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporcione un objeto JSON que contenga los parámetros que necesita la operación. Está bien enviar un cuerpo vacío si no se necesita ninguno.
Parámetro | Tipo | Descripción |
---|---|---|
siteCollectionId | Cadena | Identificador del sitio de SharePoint en el que se va a copiar. Use solo al copiar en un sitio de SharePoint. |
siteId | Cadena | Identificador de la web de SharePoint en la que se va a copiar. Use solo al copiar en un sitio de SharePoint. |
groupId | Cadena | Identificador del grupo en el que se va a copiar. Use solo al copiar en un grupo de Microsoft 365. |
renameAs | Cadena | Nombre de la copia. El valor predeterminado es el nombre del elemento existente. |
Respuesta
Si se ejecuta correctamente, este método devuelve un 202 Accepted
código de respuesta y un Operation-Location
encabezado. Sondee el punto de conexión Operation-Location para obtener el estado de la operación de copia.
Ejemplo
Este es un ejemplo de cómo llamar a esta API.
Solicitud
En el ejemplo siguiente se muestra la solicitud.
POST https://graph.microsoft.com/beta/me/onenote/notebooks/{id}/copyNotebook
Content-type: application/json
{
"groupId": "groupId-value",
"renameAs": "renameAs-value"
}
Respuesta
En el ejemplo siguiente se muestra la respuesta.
HTTP/1.1 202 Accepted
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