Partilhar via


tipo de recurso do onenote

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.

O ponto de entrada para os recursos do OneNote.

Todas as chamadas para o serviço do OneNote pela API do Microsoft Graph usam essa URL raiz de serviço:

https://graph.microsoft.com/{version}/{location}/onenote/ 

A localização pode ser blocos de anotações do usuário no Microsoft 365 ou no OneDrive do consumidor, blocos de anotações de grupo ou blocos de anotações hospedado no site de equipe do SharePoint no Microsoft 365.

Blocos de notas de utilizador Para aceder a blocos de notas pessoais no OneDrive para consumidores ou no OneDrive para Trabalho ou Escola, utilize um dos seguintes URLs:

https://graph.microsoft.com/{version}/me/onenote/{notebooks | sections | sectionGroups | pages} 
https://graph.microsoft.com/{version}/users/{userPrincipalName}/onenote/{notebooks | sections | sectionGroups | pages} 
https://graph.microsoft.com/{version}/users/{id}/onenote/{notebooks | sections | sectionGroups | pages} 

Blocos de anotações de grupo para acessar blocos de anotações que pertencem a um grupo, use a seguinte URL raiz de serviço:

https://graph.microsoft.com/{version}/groups/{id}/onenote/{notebooks | sections | sectionGroups | pages} 

Blocos de anotações do site do SharePoint para acessar blocos de anotações que pertencem a um site de equipe do SharePoint, use a seguinte URL raiz de serviço:

https://graph.microsoft.com/{version}/sites/{id}/onenote/{notebooks | sections | sectionGroups | pages} 

Autorização

Para obter informações sobre as permissões necessárias para trabalhar com o APIs do OneNote, confira Permissões de anotações.

Métodos

Método Tipo de retorno Descrição
Criar bloco de anotações bloco de anotações Crie um bloco de anotações postando na coleção notebooks.
Listar blocos de anotações Coleção bloco de anotações Obter uma coleção de blocos de anotações.
Create page onenotePage Crie uma página postando na coleção pages.
List pages coleção onenotePage Obter uma coleção de páginas.
List section groups Coleção SectionGroup Obter uma coleção de grupos de seção.
Listar seções coleção onenoteSection Obter uma coleção de seções.

Propriedades

Nenhum.

Relações

Relação Tipo Descrição
notebooks Coleção bloco de anotações A coleção de blocos de notas do OneNote que o utilizador ou grupo possui. Somente leitura. Anulável.
operations Coleção OnenoteOperation O status das operações do OneNote. A obtenção de uma coleção de operações não é suportada, mas pode obter a status de operações de execução prolongada se o Operation-Location cabeçalho for devolvido na resposta. Somente leitura. Anulável.
páginas coleção onenotePage As páginas em todos os blocos de notas do OneNote que o utilizador ou grupo possui. Somente leitura. Anulável.
recursos coleção onenoteResource A imagem e outros recursos de arquivos nas páginas do OneNote. A obtenção de uma coleção de recursos não é suportada, mas pode obter o conteúdo binário de um recurso específico. Somente leitura. Anulável.
sectionGroups Coleção SectionGroup A secção agrupa em todos os blocos de notas do OneNote que o utilizador ou grupo possui. Somente leitura. Anulável.
seções coleção onenoteSection As secções em todos os blocos de notas do OneNote que o utilizador ou grupo possui. Somente leitura. Anulável.
{
  "notebooks": [{ "@odata.type": "microsoft.graph.notebook" }],
  "operations": [{ "@odata.type": "microsoft.graph.onenoteOperation" }],
  "pages": [{ "@odata.type": "microsoft.graph.onenotePage" }],
  "resources": [ { "@odata.type": "microsoft.graph.onenoteResource" } ],
  "sectionGroups": [ { "@odata.type": "microsoft.graph.sectionGroup" } ],
  "sections": [ { "@odata.type": "microsoft.graph.onenoteSection" } ]
}