seção: copyToSectionGroup

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 uma seção para um grupo de seções específico.

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/sections/{id}/copyToSectionGroup
POST /users/{id | userPrincipalName}/onenote/sections/{id}/copyToSectionGroup
POST /groups/{id}/onenote/sections/{id}/copyToSectionGroup
POST /sites/{id}/onenote/sections/{id}/copyToSectionGroup

Cabeçalhos de solicitação

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.

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.
id Cadeia de caracteres Obrigatório. A ID do grupo de seções de destino.
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

Aqui está um exemplo de como chamar essa API.

Solicitação

O exemplo a seguir mostra uma solicitação.

POST https://graph.microsoft.com/beta/me/onenote/sections/{id}/copyToSectionGroup
Content-type: application/json

{
  "id": "id-value",
  "groupId": "groupId-value",
  "renameAs": "renameAs-value"
}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 202 Accepted