Namespace: microsoft.graph
Importante
As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Copia um bloco de anotações para a pasta Blocos de Anotações na biblioteca de documentos de destino. A pasta é criada se não existir.
Para operações de cópia, você segue um padrão de chamada assíncrono: primeiro chame a ação Copiar e, em seguida, sonde o ponto de extremidade da operação para obter o resultado.
Essa API está disponível nas seguintes implantações de nuvem nacional.
| Serviço global |
Governo dos EUA L4 |
US Government L5 (DOD) |
China operada pela 21Vianet |
| ✅ |
❌ |
❌ |
❌ |
Permissões
Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
| Tipo de permissão |
Permissões menos privilegiadas |
Permissões com privilégios mais elevados |
| Delegado (conta corporativa ou de estudante) |
Notes.Create |
Notes.ReadWrite, Notes.ReadWrite.All |
| Delegado (conta pessoal da Microsoft) |
Notes.Create |
Notes.ReadWrite |
| Application |
Notes.ReadWrite.All |
Indisponível. |
Solicitação 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
| Nome |
Tipo |
Descrição |
| Autorização |
string |
{token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
| Content-Type |
string |
application/json |
Corpo da solicitação
No corpo da solicitação, forneça um objeto JSON que contenha os parâmetros de que sua operação precisa. Não há problema em enviar um corpo vazio se nenhum for necessário.
| Parâmetro |
Tipo |
Descrição |
| siteCollectionId |
Cadeia de caracteres |
A ID do site do SharePoint para o qual copiar. Use somente ao copiar para um site do SharePoint. |
| siteId |
Cadeia de caracteres |
A ID da Web do SharePoint para a qual copiar. Use somente ao copiar para um site do SharePoint. |
| groupId |
Cadeia de caracteres |
A ID do grupo para o qual copiar. Use somente ao copiar para um grupo do Microsoft 365. |
| renameAs |
Cadeia de caracteres |
O nome da cópia. O padrão é o nome do item existente. |
Resposta
Se for bem-sucedido, esse método retornará um código de 202 Accepted resposta e um Operation-Location cabeçalho. Sonde o ponto de extremidade Operation-Location para obter o status da operação de cópia.
Exemplo
O exemplo a seguir mostra como chamar essa API.
Solicitação
O exemplo a seguir mostra uma solicitação.
POST https://graph.microsoft.com/beta/me/onenote/notebooks/{id}/copyNotebook
Content-type: application/json
{
"groupId": "groupId-value",
"renameAs": "renameAs-value"
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Beta.Me.Onenote.Notebooks.Item.CopyNotebook;
var requestBody = new CopyNotebookPostRequestBody
{
GroupId = "groupId-value",
RenameAs = "renameAs-value",
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Me.Onenote.Notebooks["{notebook-id}"].CopyNotebook.PostAsync(requestBody);
// Code snippets are only available for the latest major version. Current major version is $v0.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
graphusers "github.com/microsoftgraph/msgraph-beta-sdk-go/users"
//other-imports
)
requestBody := graphusers.NewItemCopyNotebookPostRequestBody()
groupId := "groupId-value"
requestBody.SetGroupId(&groupId)
renameAs := "renameAs-value"
requestBody.SetRenameAs(&renameAs)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
copyNotebook, err := graphClient.Me().Onenote().Notebooks().ByNotebookId("notebook-id").CopyNotebook().Post(context.Background(), requestBody, nil)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
com.microsoft.graph.beta.users.item.onenote.notebooks.item.copynotebook.CopyNotebookPostRequestBody copyNotebookPostRequestBody = new com.microsoft.graph.beta.users.item.onenote.notebooks.item.copynotebook.CopyNotebookPostRequestBody();
copyNotebookPostRequestBody.setGroupId("groupId-value");
copyNotebookPostRequestBody.setRenameAs("renameAs-value");
var result = graphClient.me().onenote().notebooks().byNotebookId("{notebook-id}").copyNotebook().post(copyNotebookPostRequestBody);
const options = {
authProvider,
};
const client = Client.init(options);
const onenoteOperation = {
groupId: 'groupId-value',
renameAs: 'renameAs-value'
};
await client.api('/me/onenote/notebooks/{id}/copyNotebook')
.version('beta')
.post(onenoteOperation);
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Users\Item\Onenote\Notebooks\Item\CopyNotebook\CopyNotebookPostRequestBody;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new CopyNotebookPostRequestBody();
$requestBody->setGroupId('groupId-value');
$requestBody->setRenameAs('renameAs-value');
$result = $graphServiceClient->me()->onenote()->notebooks()->byNotebookId('notebook-id')->copyNotebook()->post($requestBody)->wait();
Import-Module Microsoft.Graph.Beta.Notes
$params = @{
groupId = "groupId-value"
renameAs = "renameAs-value"
}
# A UPN can also be used as -UserId.
Copy-MgBetaUserOnenoteNotebook -UserId $userId -NotebookId $notebookId -BodyParameter $params
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.users.item.onenote.notebooks.item.copy_notebook.copy_notebook_post_request_body import CopyNotebookPostRequestBody
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = CopyNotebookPostRequestBody(
group_id = "groupId-value",
rename_as = "renameAs-value",
)
result = await graph_client.me.onenote.notebooks.by_notebook_id('notebook-id').copy_notebook.post(request_body)
Resposta
O exemplo a seguir mostra a resposta.
HTTP/1.1 202 Accepted