Compartilhar via

Noção (Editor Independente)

O conector de noção usa a API para acessar páginas, bancos de dados e usuários do Notion.

Esse conector está disponível nos seguintes produtos e regiões:

Service Class Regions
Copilot Studio Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicativos Lógicos Standard Todas as regiões dos Aplicativos Lógicos , exceto as seguintes:
     – Regiões do Azure Governamental
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Power Apps Premium Todas as regiões do Power Apps , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Power Automate Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Chandra Sekhar &Harshini Varma
URL https://github.com/sekharmalla
Email chandra.malla@msftcommunity.com
Metadados do conector
Publicador Chandra Sekhar &Harshini Varma
Site https://www.notion.so/
Política de privacidade https://www.notion.so/Privacy-Policy-3468d120cf614d4c9014c09f6adc9091
Categorias Produtividade; colaboração

Criando uma conexão

O conector dá suporte aos seguintes tipos de autenticação:
Default Parâmetros para criar conexão. Todas as regiões Não compartilhável

Padrão

Aplicável: todas as regiões

Parâmetros para criar conexão.

Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome Tipo Description Obrigatório
Chave de API secureString A chave de API para esta api Verdade

Limitações

Nome Chamadas Período de renovação
Chamadas à API por conexão 100 60 segundos

Ações

Anexar filhos do bloco

Cria e acrescenta novos blocos filhos ao block_id pai especificado.
Atualizar um bloco

Atualiza o conteúdo do block_id especificado com base no tipo de bloco. Campos com suporte com base no tipo de objeto de bloco
Consultar um banco de dados

Obtém uma lista de Páginas contidas no banco de dados, filtradas e ordenadas de acordo com as condições de filtro e os critérios de classificação fornecidos na solicitação.
Criar comentário

Cria um comentário em uma página ou thread de discussão existente.
Criar uma página

Cria uma nova página no banco de dados especificado. página existente.
Excluir um bloco

Define um objeto Block, incluindo blocos de página, como arquivado: true usando a ID especificada. Observação: no aplicativo notion UI, isso move o bloco para o "Lixo", onde ele ainda pode ser acessado e restaurado.
Lista de todos os usuários

Retorna uma lista paginada de Usuários para o workspace
Pesquisa

Pesquisa todas as páginas e páginas filho que são compartilhadas com a integração. Os resultados podem incluir bancos de dados.
Recuperar comentários

Recupera uma lista de objetos comment não resolvidos de uma página ou bloco.
Recuperar filhos de bloco

Retorna uma matriz paginada de objetos de bloco filho contidos no bloco usando a ID especificada
Recuperar o usuário de bot do token

Recupera o usuário do bot associado ao token de API fornecido no cabeçalho de autorização. O bot terá um campo proprietário com informações sobre a pessoa que autorizou a integração.
Recuperar um banco de dados

Recupera um objeto Database usando a ID especificada.
Recuperar um bloco

Recupera um objeto Block usando a ID especificada.
Recuperar um item de propriedade de página

Recuperar um item de propriedade de página
Recuperar uma página

Recupera um objeto Page usando a ID especificada.
Recuperar Usuário

Recupera um usuário usando a ID especificada.

Anexar filhos do bloco

ID da operação:
Appendblockchildren

Cria e acrescenta novos blocos filhos ao block_id pai especificado.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do bloco
 block_id True string

Identificador de um bloco
objeto
 object string

objeto
tipo
 type string

tipo
tipo
 type string

tipo
conteúdo
 content string

conteúdo
tipo
 type string

tipo
conteúdo
 content string

conteúdo
url
 url string

url

Atualizar um bloco

ID da operação:
Updateablock

Atualiza o conteúdo do block_id especificado com base no tipo de bloco. Campos com suporte com base no tipo de objeto de bloco

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do bloco
 blockId True string

Identificador para um bloco noção
Content
 content string

Conteúdo de texto. Esse campo contém o conteúdo real do seu texto e provavelmente é o campo que você usará com mais frequência.
Cor
 color string

Cor do bloco.
Content
 content string

Conteúdo de texto. Esse campo contém o conteúdo real do seu texto e provavelmente é o campo que você usará com mais frequência.
Cor
 color string

Cor do bloco.
Content
 content string

Conteúdo de texto2. Esse campo contém o conteúdo real do seu texto e provavelmente é o campo que você usará com mais frequência.
Cor
 color string

Cor do bloco.
Content
 content string

Conteúdo de texto. Esse campo contém o conteúdo real do seu texto e provavelmente é o campo que você usará com mais frequência.
Cor
 color string

Cores
Conteúdo1
 content string

Conteúdo de texto. Esse campo contém o conteúdo real do seu texto e provavelmente é o campo que você usará com mais frequência.
Cor
 color string

Cor do bloco.
Conteúdo1
 content string

Conteúdo de texto. Esse campo contém o conteúdo real do seu texto e provavelmente é o campo que você usará com mais frequência.
Cor
 color string

Cor do bloco.
Conteúdo1
 content string

Conteúdo de texto. Esse campo contém o conteúdo real do seu texto e provavelmente é o campo que você usará com mais frequência.
Verificado
 checked boolean

Se a to_do está marcada ou não.
Cor
 color string

Cor do bloco.

Consultar um banco de dados

ID da operação:
Query_a_database

Obtém uma lista de Páginas contidas no banco de dados, filtradas e ordenadas de acordo com as condições de filtro e os critérios de classificação fornecidos na solicitação.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do banco de dados
 database_id True string

Identificador de um banco de dados notion.

Retornos

Corpo
DatabaseResponse

Criar comentário

ID da operação:
Createcomment

Cria um comentário em uma página ou thread de discussão existente.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da página
 page_id string

Identificador de uma página
ID de discussão
 discussion_id string

Identificador para um bloco noção
Content
 content string

Conteúdo de texto. Esse campo contém o conteúdo real do seu texto e provavelmente é o campo que você usará com mais frequência.

Retornos

Corpo
CommentResponse

Criar uma página

ID da operação:
CreateaPage

Cria uma nova página no banco de dados especificado. página existente.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do banco de dados
 database_id True string

Identificador exclusivo para o banco de dados.
Emoji
 emoji string

emoji
URL de cobertura
 url string

URL da imagem da capa da página.
Propriedades
 properties object

Esquema de propriedades para o banco de dados conforme elas aparecem no Notion.

Retornos

Nome Caminho Tipo Description
ID
 id string

Identificador exclusivo da página.
Tempo de criação
 created_time string

Data e hora em que esta página foi criada. Formatado como uma cadeia de caracteres de data e hora ISO 8601.
Hora da última edição
 last_edited_time string

Data e hora em que esta página foi atualizada. Formatado como uma cadeia de caracteres de data e hora ISO 8601.
ID
 created_by.id string

Identificador exclusivo para este usuário.
ID
 last_edited_by.id string

Identificador exclusivo para este usuário.
url
 cover.url string

Link para a imagem hospedada externamente.
emoji
 icon.emoji string

Caractere emoji.
database_id
 parent.database_id string

database_id
Arquivados
 archived boolean

O status arquivado da página.
URL
 url string

A URL da página Noção.

Excluir um bloco

ID da operação:
Deleteablock

Define um objeto Block, incluindo blocos de página, como arquivado: true usando a ID especificada. Observação: no aplicativo notion UI, isso move o bloco para o "Lixo", onde ele ainda pode ser acessado e restaurado.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do bloco
 blockId True string

Identificador para um bloco noção

Retornos

Nome Caminho Tipo Description
id
 id string

Identificador do bloco.
Tempo de criação
 created_time date-time

Data e hora em que esse bloco foi criado.
Hora da última edição
 last_edited_time date-time

Data e hora em que esse bloco foi atualizado pela última vez.
Object
 created_by.object string

Sempre "usuário"
ID
 created_by.id string

Identificador exclusivo para este usuário.
Object
 last_edited_by.object string

Último usuário editado
ID
 last_edited_by.id string

Identificador exclusivo para este usuário.
Tem filhos
 has_children boolean

Se o bloco tem ou não blocos de filhos aninhados dentro dele.
Arquivados
 archived boolean

O status arquivado do bloco.
Tipo
 type string

Um objeto que contém informações de bloco específicas do tipo

Lista de todos os usuários

ID da operação:
List_of_all_users

Retorna uma lista paginada de Usuários para o workspace

Parâmetros

Nome Chave Obrigatório Tipo Description
Tamanho da página
 page_size integer

O número de itens da lista completa desejada na resposta. Máximo: 100

Retornos

Nome Caminho Tipo Description
ID
 id string

Identificador para um bloco noção
Nome de Exibição
 name string

Nome do usuário exibido no Notion.
Avatar URL
 avatar_url string

Imagem de avatar escolhida.
Tipo
 type string

Tipo do usuário. Os valores possíveis são "pessoa" e "bot".
Email
 email string

Endereço de email da pessoa.
Próximo Cursor
 next_cursor string

Um cursor retornado usado para solicitar a próxima página de resultados. Trate isso como um valor opaco
Tem mais
 has_more boolean

Quando a resposta inclui o final da lista

Pesquisa

ID da operação:
Search

Pesquisa todas as páginas e páginas filho que são compartilhadas com a integração. Os resultados podem incluir bancos de dados.

Parâmetros

Nome Chave Obrigatório Tipo Description
Query
 query True string

Quando fornecido, limita quais páginas são retornadas comparando a consulta com o título da página.
Direção
 direction string

A direção a ser classificada. Os valores possíveis incluem crescente e decrescente.
Timestamp
 timestamp string

O nome do carimbo de data/hora a ser classificado. Os valores possíveis incluem last_edited_time.

Retornos

Nome Caminho Tipo Description
id
 id string

Identificador do bloco.
Tempo de criação
 created_time string

Data e hora em que esta página foi criada.
Hora da última edição
 last_edited_time string

Data e hora em que esta página foi atualizada.
Texto sem formatação
 plain_text string

O texto sem formatação sem anotações.
Etiquetas
 Tags object

O objeto tags contém a lista de marcas.
URL
 url string

A URL do objeto.
Próximo cursor
 next_cursor string

Um cursor retornado usado para solicitar a próxima página de resultados. Trate isso como um valor opaco
Tem mais
 has_more boolean

Se o bloco tem ou não mais blocos

Recuperar comentários

ID da operação:
Retrievecomments

Recupera uma lista de objetos comment não resolvidos de uma página ou bloco.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do bloco
 block_id True string

Identificador para um bloco ou página do Notion

Retornos

Corpo
CommentResponse

Recuperar filhos de bloco

ID da operação:
Retrieve_block_children

Retorna uma matriz paginada de objetos de bloco filho contidos no bloco usando a ID especificada

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do bloco
 block_id True string

Identificador de um bloco
Tamanho da página
 page_size integer

O número de itens da lista completa desejada na resposta. Máximo: 100

Retornos

Nome Caminho Tipo Description
id
 items.id string

Identificador do bloco.
Tempo de criação
 items.created_time date-time

Data e hora em que esse bloco foi criado.
Hora da última edição
 items.last_edited_time date-time

Data e hora em que esse bloco foi atualizado pela última vez.
Tem filhos
 items.has_children boolean

Se o bloco tem ou não blocos de filhos aninhados dentro dele.
Arquivados
 items.archived boolean

O status arquivado do bloco.
Tipo
 items.type string

Tipo de bloco. Valores possíveis
Texto sem formatação
 plain_text string

Texto sem formatação no bloco de parágrafo plain_text
Próximo cursor
 next_cursor string

Um cursor retornado usado para solicitar a próxima página de resultados. Trate isso como um valor opaco
Tem mais
 has_more boolean

Se o bloco tem ou não mais blocos

Recuperar o usuário de bot do token

ID da operação:
RetrieveYourTokensBotUser

Recupera o usuário do bot associado ao token de API fornecido no cabeçalho de autorização. O bot terá um campo proprietário com informações sobre a pessoa que autorizou a integração.

Retornos

Nome Caminho Tipo Description
ID
 id string

Identificador exclusivo para este usuário.
Nome
 name string

Nome do usuário, conforme exibido no Notion.
URL do avatar
 avatar_url string

Imagem de avatar escolhida.
Tipo
 type string

Tipo do usuário. Os valores possíveis são "pessoa" e "bot".
Tipo de proprietário
 bot.owner.type string

O tipo de proprietário – "workspace" ou "usuário".

Recuperar um banco de dados

ID da operação:
Retrieve_a_database

Recupera um objeto Database usando a ID especificada.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do banco de dados
 database_id True string

Identificador de um banco de dados notion

Retornos

Corpo
DatabaseResponse

Recuperar um bloco

ID da operação:
Retrieveablock

Recupera um objeto Block usando a ID especificada.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do bloco
 blockId True string

Identificador do bloco.

Retornos

Nome Caminho Tipo Description
objeto
 object string

objeto
id
 id string

Identificador do bloco.
Tempo de criação
 created_time date-time

Data e hora em que esse bloco foi criado.
Hora da última edição
 last_edited_time date-time

Data e hora em que esse bloco foi atualizado pela última vez.
Object
 created_by.object string

Sempre "usuário"
ID
 created_by.id string

Identificador exclusivo para este usuário.
Object
 last_edited_by.object string

Último usuário editado
ID
 last_edited_by.id string

Identificador exclusivo para este usuário.
Tem filhos
 has_children boolean

Se o bloco tem ou não blocos de filhos aninhados dentro dele.
Arquivados
 archived boolean

O status arquivado do bloco.
Tipo
 type string

Um objeto que contém informações de bloco específicas do tipo

Recuperar um item de propriedade de página

ID da operação:
Retrieveapagepropertyitem

Recuperar um item de propriedade de página

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da página
 page_id True string

Identificador de uma página noção
ID da Propriedade
 property_id True string

Identificador de uma propriedade de página

Retornos

Nome Caminho Tipo Description
Object
 object string

Lista sempre.
Tem mais
 has_more boolean

Quando a resposta inclui o final da lista, false. Caso contrário, true.

Recuperar uma página

ID da operação:
Retrieveapage

Recupera um objeto Page usando a ID especificada.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da página
 page_id True string

Identificador de uma página noção

Retornos

Nome Caminho Tipo Description
ID
 id string

Identificador exclusivo da página.
Tempo de criação
 created_time string

Data e hora em que esta página foi criada. Formatado como uma cadeia de caracteres de data e hora ISO 8601.
Hora da última edição
 last_edited_time string

Data e hora em que esta página foi atualizada. Formatado como uma cadeia de caracteres de data e hora ISO 8601.
ID
 created_by.id string

Identificador exclusivo para este usuário.
ID
 last_edited_by.id string

Identificador exclusivo para este usuário.
url
 cover.url string

Link para a imagem hospedada externamente.
emoji
 icon.emoji string

Caractere emoji.
database_id
 parent.database_id string

database_id
Arquivados
 archived boolean

O status arquivado da página.
URL
 url string

A URL da página Noção.

Recuperar Usuário

ID da operação:
Retrieveuser

Recupera um usuário usando a ID especificada.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do Usuário
 user_id True string

Identificador exclusivo para este usuário.

Retornos

Nome Caminho Tipo Description
ID
 id string

Identificador para um usuário do Notion
Nome do usuário
 name string

Nome do usuário
Avatar URL
 avatar_url string

Imagem de avatar escolhida
Email
 email string

Endereço de email da pessoa.

Definições

CommentResponse

Nome Caminho Tipo Description
ID
 id string

Identificador exclusivo do comentário.
ID da página
 parent.page_id string

A ID da página à qual esta página pertence.
ID de discussão
 discussion_id string

Identificador exclusivo do thread de discussão ao qual o comentário está associado.
Tempo de criação
 created_time string

Data e hora em que esse comentário foi criado.
Hora da última edição
 last_edited_time string

Data e hora em que este comentário foi atualizado.
objeto
 created_by.object string

objeto
id
 created_by.id string

id
Rich text
 rich_text array of object

Conteúdo do comentário, que dá suporte à formatação de rich text, links e menções.
tipo
 rich_text.type string

tipo
Content
 rich_text.text.content string

Conteúdo de texto.
Link
 rich_text.text.link string

Qualquer link embutido neste texto.
Texto sem formatação
 rich_text.plain_text string

O texto sem formatação sem anotações.
href
 rich_text.href string

(opcional) A URL de qualquer link ou noção interna mencionada neste texto, se houver.

DatabaseResponse

Nome Caminho Tipo Description
results
 results array of object
Object
 results.object string

Página ou 'banco de dados'
ID
 results.id string

Identificador exclusivo para o banco de dados.
Tempo de criação
 results.created_time string

Data e hora em que esse banco de dados foi criado. Formatado como uma cadeia de caracteres de data e hora ISO 8601.
Hora da última edição
 results.last_edited_time string

Data e hora em que esse banco de dados foi atualizado. Formatado como uma cadeia de caracteres de data e hora ISO 8601.
Object
 results.created_by.object string

Usuário que criou o banco de dados.
ID
 results.created_by.id string

Identificador exclusivo para o usuário
Object
 results.last_edited_by.object string

Usuário que criou o banco de dados.
ID
 results.last_edited_by.id string

Identificador exclusivo para o usuário
Arquivados
 results.archived boolean

O status arquivado do banco de dados.
URL
 results.url string

A URL do banco de dados Notion