OneNote (Negócios)
O OneNote é um aplicativo de anotações da Microsoft que facilita a sincronização de suas ideias, esboços e anotações em todos os seus dispositivos! Conecte-se à sua conta do Office 365 com o OneDrive for Business habilitado para acompanhar novas seções, criar anotações e muito mais.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Standard | Todas as regiões do Power Automate |
| Aplicativos Lógicos | Standard | Todas as regiões de Aplicativos Lógicos |
| Power Apps | Standard | Todas as regiões do Power Apps |
| Power Automate | Standard | Todas as regiões do Power Automate |
| Metadados do conector | |
|---|---|
| Publicador | Microsoft |
| Site | https://products.office.com/onenote/digital-note-taking-app |
Para usar essa integração, você precisará de acesso a um bloco de anotações do OneNote armazenado no OneDrive For Business. Para fazer uma conexão, selecione Entrar. Você será solicitado a fornecer sua conta do O365 com o OneDrive for Business habilitado, siga o restante das telas para criar uma conexão.
Problemas e limitações conhecidos
- Ao usar a conexão, se você não estiver vendo a lista de blocos de anotações que está esperando, verifique a conta com a qual criou a conexão e tente novamente. Se você vir um erro ao usar o conector, poderá procurar mais informações no código de erro .
- Essa integração requer a conexão com uma conta que tenha a permissão "UserRemoteAPIs". Se você vir esse erro: "Erro: o usuário não tem permissões para acessar o recurso solicitado", a conta pode não ter as permissões corretas. Um administrador do SharePoint pode controlar os níveis de permissão navegando até o conjunto de sites e abrindo as configurações do Site. Selecione as Permissões de Site e, em seguida, o Nível de Permissão para ver as permissões (como as Interfaces Remotas de Uso) que o nível contém. Se um usuário que pertence a um determinado nível não tiver a permissão necessária, modifique o nível marcando a caixa para obter a permissão ou crie um novo nível de permissão e atribua-o ao usuário.
- Atualmente, o conector não dá suporte a um parâmetro de entrada explícito Page Title para as ações Criar Página . Essa é uma limitação decorrente da implementação da API do OneNote. No entanto, o título pode ser especificado como parte do Conteúdo da Página em HTML usando as <marcas de título></título>.
-
Seção Bloco de anotações. Se você quiser fornecer um valor personalizado para o parâmetro seção Notebook, especifique-o no formato de URL da API. O padrão de URL da API:
https://www.onenote.com/api/v1.0/myOrganization/siteCollections/{siteCollectionsId}/sites/{SiteId}/notes/sections/{SectionId}/pages. Para obter mais informações, você pode dar uma olhada na documentação da API do OneNote. - Não há suporte para criar uma página na ação Anotações Rápidas nas seguintes regiões:
- Aplicativos Lógicos:
- Azure Governamental
- Regiões do Azure na China
- Power Automate e Power Apps:
- Governo dos EUA (GCC)
- Governo dos EUA (GCC High)
- China Cloud operado pela 21Vianet
- Aplicativos Lógicos:
- Não há suporte para a ação obter conteúdo da página no Power Apps, no entanto, essa ação tem suporte no Power Automate.
Observação
Os seguintes caracteres não são permitidos no nome do bloco de anotações: *":<>?/|%
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
| Frequência das pesquisas de gatilho | 1 | 1200 segundos |
Ações
| Atualizar conteúdo da página |
Atualize o conteúdo da página HTML. |
| Criar página em uma seção |
Crie uma nova página em uma seção especificada. |
| Criar seção em um bloco de anotações |
Criar seção em um bloco de anotações. |
| Criar uma página em Notas Rápidas |
Crie uma nova página na seção Notas Rápidas. |
| Excluir uma página |
Excluir uma página. |
| Obter blocos de anotações recentes |
Obtenha blocos de anotações recentes. |
| Obter conteúdo da página |
Obter conteúdo da página HTML. |
| Obter páginas para uma seção específica |
Obtenha páginas para uma seção específica. |
| Obter seções no notebook |
Obtenha seções em um bloco de anotações específico. |
Atualizar conteúdo da página
Atualize o conteúdo da página HTML.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Chave do Bloco de Anotações
|
notebookKey | True | string |
Uma chave que identifica o bloco de anotações. Observe que isso é específico para a API e não pode ser tipado à mão. |
|
Seção Notebook
|
sectionId | True | string |
URL da API das páginas da seção. |
|
ID da página
|
pageId | True | string |
ID exclusiva da página. |
|
Meta
|
target | string |
O elemento a ser atualizado. |
|
|
Ação
|
action | string |
A ação a ser executada no elemento de destino. |
|
|
Localização
|
position | string |
O local para adicionar o conteúdo fornecido. |
|
|
Content
|
content | html |
O novo conteúdo. |
Retornos
O conteúdo HTML da página
- response
- string
Criar página em uma seção
Crie uma nova página em uma seção especificada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Chave do Bloco de Anotações
|
notebookKey | True | string |
Uma chave que identifica o bloco de anotações. Observe que isso é específico para a API e não pode ser tipado à mão. |
|
Seção Notebook
|
sectionId | True | string |
URL da API das páginas da seção. |
|
Conteúdo da Página
|
pageContent | True | html |
Conteúdo da página. |
Retornos
- Corpo
- Page
Criar seção em um bloco de anotações
Criar seção em um bloco de anotações.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Chave do Bloco de Anotações
|
notebookKey | True | string |
Uma chave que identifica o bloco de anotações. Observe que isso é específico para a API e não pode ser tipado à mão. |
|
Nome da nova seção
|
name | string |
O nome da nova seção. |
Retornos
Criar uma página em Notas Rápidas
Crie uma nova página na seção Notas Rápidas.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Conteúdo da Página
|
pageContent | True | html |
Conteúdo da página. |
Retornos
- Corpo
- Page
Excluir uma página
Excluir uma página.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Chave do Bloco de Anotações
|
notebookKey | True | string |
Uma chave que identifica o bloco de anotações. Observe que isso é específico para a API e não pode ser tipado à mão. |
|
Seção Notebook
|
sectionId | True | string |
URL da API das páginas da seção. |
|
ID da página
|
pageId | True | string |
ID exclusiva da página. |
Obter blocos de anotações recentes
Obter conteúdo da página
Obter conteúdo da página HTML.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Chave do Bloco de Anotações
|
notebookKey | True | string |
Uma chave que identifica o bloco de anotações. Observe que isso é específico para a API e não pode ser tipado à mão. |
|
Seção Notebook
|
sectionId | True | string |
URL da API das páginas da seção. |
|
ID da página
|
pageId | True | string |
ID exclusiva da página. |
Retornos
O conteúdo HTML da página
- response
- string
Obter páginas para uma seção específica
Obtenha páginas para uma seção específica.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Chave do Bloco de Anotações
|
notebookKey | True | string |
Uma chave que identifica o bloco de anotações. Observe que isso é específico para a API e não pode ser tipado à mão. |
|
Seção Notebook
|
sectionId | True | string |
URL da API das páginas da seção. |
Retornos
Obter seções no notebook
Obtenha seções em um bloco de anotações específico.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Chave do Bloco de Anotações
|
notebookKey | True | string |
Uma chave que identifica o bloco de anotações. Observe que isso é específico para a API e não pode ser tipado à mão. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
value
|
value | array of SectionListItem |
Gatilhos
| Quando um novo grupo de seções é criado |
Dispara um fluxo quando um novo grupo de seções é adicionado a um notebook. |
| Quando uma nova página é criada em uma seção |
Dispara um fluxo quando uma nova página é adicionada a uma seção. |
| Quando uma nova seção é criada |
Dispara um fluxo quando uma nova seção é adicionada a um notebook. |
Quando um novo grupo de seções é criado
Dispara um fluxo quando um novo grupo de seções é adicionado a um notebook.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Chave do Bloco de Anotações
|
notebookKey | True | string |
Uma chave que identifica o bloco de anotações. Observe que isso é específico para a API e não pode ser tipado à mão. |
Retornos
Resposta para um novo grupo de seções.
- Corpo
- NewSectionGroupResponse
Quando uma nova página é criada em uma seção
Dispara um fluxo quando uma nova página é adicionada a uma seção.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Chave do Bloco de Anotações
|
notebookKey | True | string |
Uma chave que identifica o bloco de anotações. Observe que isso é específico para a API e não pode ser tipado à mão. |
|
Seção Notebook
|
sectionId | True | string |
URL da API das páginas da seção. |
Retornos
Resposta para uma nova página.
- Corpo
- NewPageResponse
Quando uma nova seção é criada
Dispara um fluxo quando uma nova seção é adicionada a um notebook.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Chave do Bloco de Anotações
|
notebookKey | True | string |
Uma chave que identifica o bloco de anotações. Observe que isso é específico para a API e não pode ser tipado à mão. |
Retornos
Resposta para uma nova seção.
- Corpo
- NewSectionResponse
Definições
CreateSectionInNotebookResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Contexto OData
|
@odata.context | string |
O contexto OData. |
|
Criado pelo nome
|
createdBy | string |
Esta seção criada pelo nome. |
|
Tempo de criação
|
createdTime | date-time |
Esta seção criou a hora. |
|
Criar seção na ID do objeto do notebook
|
id | string | |
|
Sinalizador de seção padrão
|
isDefault | boolean |
Um sinalizador para indicar se esta é a seção padrão. |
|
Última modificação feita por
|
lastModifiedBy | string |
Última modificação por nome. |
|
Hora da Última Modificação
|
lastModifiedTime | date-time |
A hora em que esta seção foi modificada pela última vez. |
|
Href do cliente da área de trabalho
|
links.oneNoteClientUrl.href | string |
Href do cliente da área de trabalho do OneNote. |
|
Href do cliente Web
|
links.oneNoteWebUrl.href | string |
Href do cliente Web do OneNote. |
|
Nome da Secção
|
name | string |
O nome da seção. |
|
A URL de páginas
|
pagesUrl | string |
A URL das páginas. |
|
URL para criar seção no notebook
|
self | string |
A URL a ser criada no grupo de blocos de anotações. |
Página
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Título da página
|
title | string |
O título da página. |
|
links
|
links | Link |
Os links associados à página do OneNote. |
|
URL de Conteúdo
|
contentUrl | string |
Uma URL para o conteúdo da página. |
|
Data da última modificação
|
lastModifiedTime | date-time |
A última data modificada da página. |
|
Data de criação
|
createdTime | date-time |
A data em que a página foi criada. |
|
ID
|
id | string |
O identificador exclusivo da página. |
Notebook
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Nome do Arquivo
|
FileName | string | |
|
Key
|
Key | string |
ParentNotebook
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Chave do Bloco de Anotações Pai
|
id | string |
O identificador exclusivo do notebook pai. |
|
Nome do bloco de anotações pai
|
name | string |
O nome do bloco de anotações pai. |
|
URL do Notebook Pai
|
self | string |
Um link de URL para o bloco de anotações pai. |
Link
Os links associados à página do OneNote.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
oneNoteClientUrl
|
oneNoteClientUrl | OneNoteClientUrl | |
|
oneNoteWebUrl
|
oneNoteWebUrl | OneNoteWebUrl |
OneNoteClientUrl
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
URL do cliente do OneNote
|
href | string |
Um link para o bloco de anotações usando o cliente windows do OneNote. |
OneNoteWebUrl
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
URL da Web do OneNote
|
href | string |
Um link para o bloco de anotações usando o cliente Web do OneNote. |
SectionListItem
Os campos incluídos em um item de lista de seções.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Nome da seção
|
name | string |
O nome da seção. |
|
Chave de seção
|
pagesUrl | string |
A chave usada para fazer referência a esta seção; também uma URL para as páginas. |
|
Identificador de Seção
|
id | string |
Identificador exclusivo da secção. |
SectionResponse
Os campos incluídos em uma seção.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Criador
|
createdBy | string |
O criador da seção. |
|
Data de Criação
|
createdTime | date-time |
A data e a hora da criação da seção. |
|
Identificador de Seção
|
id | string |
Identificador exclusivo da secção. |
|
Última modificação feita por
|
lastModifiedBy | string |
O usuário que modificou a seção pela última vez. |
|
Data da última modificação
|
lastModifiedTime | date-time |
A última data e hora modificadas da seção. |
|
Nome da Secção
|
name | string |
O nome da seção. |
|
URL de Páginas
|
pagesUrl | string |
Url para as páginas desta seção. |
|
parentNotebook
|
parentNotebook | ParentNotebook | |
|
URL
|
self | string |
A URL desta seção. |
SectionGroupResponse
Os campos incluídos em um grupo de seções.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Data de criação
|
createdTime | date-time |
A data e a hora de criação do grupo de seções. |
|
Criador
|
createdBy | string |
O criador do grupo de seções. |
|
Identificador
|
id | string |
Identificador exclusivo do grupo de seções. |
|
Último modificador
|
lastModifiedBy | string |
O usuário que modificou o grupo de seções pela última vez. |
|
Data da última modificação
|
lastModifiedTime | date-time |
A data e a hora da última modificação do grupo de seções. |
|
Nome
|
name | string |
O nome do grupo de seções. |
|
URL de Seções
|
sectionsUrl | string |
Url das seções neste grupo de seções. |
|
URL do Grupo de Seções
|
self | string |
A URL deste grupo de seções. |
NewSectionResponse
Resposta para uma nova seção.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Seções
|
value | array of SectionResponse |
Uma matriz de objetos, cada um representando uma seção específica. |
NewSectionGroupResponse
Resposta para um novo grupo de seções.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Grupos de Seções
|
value | array of SectionGroupResponse |
Uma matriz de objetos, cada um representando um grupo de seções específico. |
NewPageResponse
Resposta para uma nova página.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Páginas
|
value | array of Page |
Uma matriz de objetos, cada um representando uma página específica. |
GetPagesInSectionResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Contexto OData
|
@odata.context | string |
O contexto OData. |
|
Páginas no objeto de valor de seção
|
value | array of object |
value |
|
URL de Conteúdo
|
value.contentUrl | string |
A URL do conteúdo. |
|
Criado pela ID do aplicativo
|
value.createdByAppId | string |
A ID do aplicativo criada. |
|
Tempo de criação
|
value.createdTime | date-time |
O tempo criado para essa resposta. |
|
Identificador exclusivo para resposta
|
value.id | string |
O identificador exclusivo para essa resposta. |
|
Hora da última modificação
|
value.lastModifiedTime | date-time |
A hora da última modificação para este objeto. |
|
Href do cliente da área de trabalho do OneNote
|
value.links.oneNoteClientUrl.href | string |
Href do cliente da área de trabalho do OneNote. |
|
Href do cliente Web do OneNote
|
value.links.oneNoteWebUrl.href | string |
Href do cliente Web do OneNote. |
|
Identificador exclusivo da seção pai
|
value.parentSection.id | string |
O identificador exclusivo para esta seção pai do objeto. |
|
Nome da seção pai
|
value.parentSection.name | string | |
|
Páginas na seção pai da seção
|
value.parentSection.self | string |
A URL para as páginas na seção pai da seção. |
|
Contexto OData da Seção Pai
|
value.parentSection@odata.context | string |
Contexto OData da Seção Pai. |
|
Páginas no grupo Seção
|
value.self | string |
A URL para o grupo Páginas na Seção. |
|
Título da página
|
value.title | string |
Título da página. |
cadeia
Esse é o tipo de dados básico 'string'.