Noción (publicador independiente)
El conector De noción usa la API para acceder a las páginas, bases de datos y usuarios de Notion.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Chandra Sekhar & Harshini Varma |
| URL | https://github.com/sekharmalla |
| Correo Electrónico | chandra.malla@msftcommunity.com |
| Metadatos del conector | |
|---|---|
| Publicador | Chandra Sekhar & Harshini Varma |
| Sitio web | https://www.notion.so/ |
| Directiva de privacidad | https://www.notion.so/Privacy-Policy-3468d120cf614d4c9014c09f6adc9091 |
| Categorías | Productividad; colaboración |
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Predeterminado | Parámetros para crear una conexión. | Todas las regiones | No se puede compartir |
Predeterminado
Aplicable: Todas las regiones
Parámetros para crear una conexión.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
| Nombre | Tipo | Description | Obligatorio |
|---|---|---|---|
| Clave de API | securestring | La clave de API de esta API | Cierto |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Actualizar un bloque |
Actualiza el contenido del block_id especificado en función del tipo de bloque. Campos admitidos basados en el tipo de objeto de bloque |
| Anexar elementos secundarios del bloque |
Crea y anexa nuevos bloques secundarios al block_id primario especificado. |
| Consulta de una base de datos |
Obtiene una lista de Páginas contenidas en la base de datos, filtradas y ordenadas según las condiciones de filtro y los criterios de ordenación proporcionados en la solicitud. |
| Crear comentario |
Crea un comentario en una página o en un subproceso de discusión existente. |
| Crear una página |
Crea una nueva página en la base de datos especificada. página existente. |
| Eliminar un bloque |
Establece un objeto Block, incluidos los bloques de página, en archivado: true mediante el identificador especificado. Nota: en la aplicación De la interfaz de usuario de Notion, esto mueve el bloque a la "Papelera" donde todavía se puede acceder y restaurar. |
| Lista de todos los usuarios |
Devuelve una lista paginada de Usuarios para el área de trabajo. |
| Recuperación de elementos secundarios de bloque |
Devuelve una matriz paginada de objetos de bloque secundarios contenidos en el bloque mediante el identificador especificado. |
| Recuperación de un bloque |
Recupera un objeto Block con el identificador especificado. |
| Recuperación de una base de datos |
Recupera un objeto Database mediante el identificador especificado. |
| Recuperación del usuario del bot del token |
Recupera el bot Usuario asociado al token de API proporcionado en el encabezado de autorización. El bot tendrá un campo propietario con información sobre la persona que autorizó la integración. |
| Recuperar comentarios |
Recupera una lista de objetos Comment no resueltos de una página o bloque. |
| Recuperar un elemento de propiedad de página |
Recuperar un elemento de propiedad de página |
| Recuperar una página |
Recupera un objeto Page con el identificador especificado. |
| Recuperar usuario |
Recupera un usuario mediante el identificador especificado. |
| Search |
Busca en todas las páginas y páginas secundarias que se comparten con la integración. Los resultados pueden incluir bases de datos. |
Actualizar un bloque
Actualiza el contenido del block_id especificado en función del tipo de bloque. Campos admitidos basados en el tipo de objeto de bloque
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de bloque
|
blockId | True | string |
Identificador de un bloque De noción |
|
Content
|
content | string |
Contenido de texto. Este campo contiene el contenido real del texto y es probablemente el campo que usará con más frecuencia. |
|
|
Color
|
color | string |
Color del bloque. |
|
|
Content
|
content | string |
Contenido de texto. Este campo contiene el contenido real del texto y es probablemente el campo que usará con más frecuencia. |
|
|
Color
|
color | string |
Color del bloque. |
|
|
Content
|
content | string |
Contenido de texto2. Este campo contiene el contenido real del texto y es probablemente el campo que usará con más frecuencia. |
|
|
Color
|
color | string |
Color del bloque. |
|
|
Content
|
content | string |
Contenido de texto. Este campo contiene el contenido real del texto y es probablemente el campo que usará con más frecuencia. |
|
|
Color
|
color | string |
colores |
|
|
Contents1
|
content | string |
Contenido de texto. Este campo contiene el contenido real del texto y es probablemente el campo que usará con más frecuencia. |
|
|
Color
|
color | string |
Color del bloque. |
|
|
Contents1
|
content | string |
Contenido de texto. Este campo contiene el contenido real del texto y es probablemente el campo que usará con más frecuencia. |
|
|
Color
|
color | string |
Color del bloque. |
|
|
Contents1
|
content | string |
Contenido de texto. Este campo contiene el contenido real del texto y es probablemente el campo que usará con más frecuencia. |
|
|
Comprobado
|
checked | boolean |
Indica si la to_do está activada o no. |
|
|
Color
|
color | string |
Color del bloque. |
Anexar elementos secundarios del bloque
Crea y anexa nuevos bloques secundarios al block_id primario especificado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de bloque
|
block_id | True | string |
Identificador de un bloque |
|
objeto
|
object | string |
objeto |
|
|
type
|
type | string |
type |
|
|
type
|
type | string |
type |
|
|
contenido
|
content | string |
contenido |
|
|
type
|
type | string |
type |
|
|
contenido
|
content | string |
contenido |
|
|
URL
|
url | string |
URL |
Consulta de una base de datos
Obtiene una lista de Páginas contenidas en la base de datos, filtradas y ordenadas según las condiciones de filtro y los criterios de ordenación proporcionados en la solicitud.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de base de datos
|
database_id | True | string |
Identificador de una base de datos de Notion. |
Devoluciones
- Body
- DatabaseResponse
Crear comentario
Crea un comentario en una página o en un subproceso de discusión existente.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de página
|
page_id | string |
Identificador de una página |
|
|
Identificador de discusión
|
discussion_id | string |
Identificador de un bloque De noción |
|
|
Content
|
content | string |
Contenido de texto. Este campo contiene el contenido real del texto y es probablemente el campo que usará con más frecuencia. |
Devoluciones
- Body
- CommentResponse
Crear una página
Crea una nueva página en la base de datos especificada. página existente.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de base de datos
|
database_id | True | string |
Identificador único de la base de datos. |
|
Emoji
|
emoji | string |
emoji |
|
|
Dirección URL de portada
|
url | string |
Dirección URL de la imagen de portada de página. |
|
|
Propiedades
|
properties | object |
Esquema de propiedades de la base de datos tal como aparecen en Notion. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id
|
id | string |
Identificador único de la página. |
|
Tiempo creado
|
created_time | string |
Fecha y hora en que se creó esta página. Con formato de cadena de fecha y hora ISO 8601. |
|
Hora de última edición
|
last_edited_time | string |
Fecha y hora en que se actualizó esta página. Con formato de cadena de fecha y hora ISO 8601. |
|
Id
|
created_by.id | string |
Identificador único para este usuario. |
|
Id
|
last_edited_by.id | string |
Identificador único para este usuario. |
|
URL
|
cover.url | string |
Vínculo a la imagen hospedada externamente. |
|
emoji
|
icon.emoji | string |
Carácter emoji. |
|
ID de base de datos
|
parent.database_id | string |
ID de base de datos |
|
Archivados
|
archived | boolean |
Estado archivado de la página. |
|
URL
|
url | string |
Dirección URL de la página De noción. |
Eliminar un bloque
Establece un objeto Block, incluidos los bloques de página, en archivado: true mediante el identificador especificado. Nota: en la aplicación De la interfaz de usuario de Notion, esto mueve el bloque a la "Papelera" donde todavía se puede acceder y restaurar.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de bloque
|
blockId | True | string |
Identificador de un bloque De noción |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
id
|
id | string |
Identificador del bloque. |
|
Tiempo creado
|
created_time | date-time |
Fecha y hora en que se creó este bloque. |
|
Hora de última edición
|
last_edited_time | date-time |
Fecha y hora en que se actualizó por última vez este bloque. |
|
Objeto
|
created_by.object | string |
Siempre "usuario" |
|
Id
|
created_by.id | string |
Identificador único para este usuario. |
|
Objeto
|
last_edited_by.object | string |
Último usuario editado |
|
Id
|
last_edited_by.id | string |
Identificador único para este usuario. |
|
Tiene hijos
|
has_children | boolean |
Si el bloque tiene o no bloques secundarios anidados dentro de él. |
|
Archivado
|
archived | boolean |
Estado archivado del bloque. |
|
Tipo
|
type | string |
Objeto que contiene información de bloque específica del tipo |
Lista de todos los usuarios
Devuelve una lista paginada de Usuarios para el área de trabajo.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Tamaño de página
|
page_size | integer |
Número de elementos de la lista completa deseada en la respuesta. Máximo: 100 |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id
|
id | string |
Identificador de un bloque De noción |
|
Nombre de pantalla
|
name | string |
Nombre del usuario que se muestra en Notion. |
|
Avatar URL
|
avatar_url | string |
Imagen de avatar elegida. |
|
Tipo
|
type | string |
Tipo del usuario. Los valores posibles son "person" y "bot". |
|
Correo Electrónico
|
string |
Dirección de correo electrónico de la persona. |
|
|
Cursor siguiente
|
next_cursor | string |
Cursor devuelto usado para solicitar la siguiente página de resultados. Tratar esto como un valor opaco |
|
Tiene más
|
has_more | boolean |
Cuando la respuesta incluye el final de la lista |
Recuperación de elementos secundarios de bloque
Devuelve una matriz paginada de objetos de bloque secundarios contenidos en el bloque mediante el identificador especificado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de bloque
|
block_id | True | string |
Identificador de un bloque |
|
Tamaño de página
|
page_size | integer |
Número de elementos de la lista completa deseada en la respuesta. Máximo: 100 |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
id
|
items.id | string |
Identificador del bloque. |
|
Tiempo creado
|
items.created_time | date-time |
Fecha y hora en que se creó este bloque. |
|
Hora de última edición
|
items.last_edited_time | date-time |
Fecha y hora en que se actualizó por última vez este bloque. |
|
Tiene hijos
|
items.has_children | boolean |
Si el bloque tiene o no bloques secundarios anidados dentro de él. |
|
Archivado
|
items.archived | boolean |
Estado archivado del bloque. |
|
Tipo
|
items.type | string |
Tipo de bloque. Valores posibles |
|
Texto sin formato
|
plain_text | string |
Texto sin formato en el bloque de párrafos plain_text |
|
Cursor siguiente
|
next_cursor | string |
Cursor devuelto usado para solicitar la siguiente página de resultados. Tratar esto como un valor opaco |
|
Tiene más
|
has_more | boolean |
Si el bloque tiene o no más bloques |
Recuperación de un bloque
Recupera un objeto Block con el identificador especificado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de bloque
|
blockId | True | string |
Identificador del bloque. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
objeto
|
object | string |
objeto |
|
id
|
id | string |
Identificador del bloque. |
|
Tiempo creado
|
created_time | date-time |
Fecha y hora en que se creó este bloque. |
|
Hora de última edición
|
last_edited_time | date-time |
Fecha y hora en que se actualizó por última vez este bloque. |
|
Objeto
|
created_by.object | string |
Siempre "usuario" |
|
Id
|
created_by.id | string |
Identificador único para este usuario. |
|
Objeto
|
last_edited_by.object | string |
Último usuario editado |
|
Id
|
last_edited_by.id | string |
Identificador único para este usuario. |
|
Tiene hijos
|
has_children | boolean |
Si el bloque tiene o no bloques secundarios anidados dentro de él. |
|
Archivado
|
archived | boolean |
Estado archivado del bloque. |
|
Tipo
|
type | string |
Objeto que contiene información de bloque específica del tipo |
Recuperación de una base de datos
Recupera un objeto Database mediante el identificador especificado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de base de datos
|
database_id | True | string |
Identificador de una base de datos de Notion |
Devoluciones
- Body
- DatabaseResponse
Recuperación del usuario del bot del token
Recupera el bot Usuario asociado al token de API proporcionado en el encabezado de autorización. El bot tendrá un campo propietario con información sobre la persona que autorizó la integración.
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id
|
id | string |
Identificador único para este usuario. |
|
Nombre
|
name | string |
Nombre del usuario tal y como se muestra en Notion. |
|
Url del avatar
|
avatar_url | string |
Imagen de avatar elegida. |
|
Tipo
|
type | string |
Tipo del usuario. Los valores posibles son "person" y "bot". |
|
Tipo de propietario
|
bot.owner.type | string |
Tipo de propietario: "área de trabajo" o "usuario". |
Recuperar comentarios
Recupera una lista de objetos Comment no resueltos de una página o bloque.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de bloque
|
block_id | True | string |
Identificador de un bloque o página de Noción |
Devoluciones
- Body
- CommentResponse
Recuperar un elemento de propiedad de página
Recuperar un elemento de propiedad de página
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de página
|
page_id | True | string |
Identificador de una página De noción |
|
Id. de propiedad
|
property_id | True | string |
Identificador de una propiedad de página |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Objeto
|
object | string |
Lista siempre. |
|
Tiene más
|
has_more | boolean |
Cuando la respuesta incluye el final de la lista, false. De lo contrario, true. |
Recuperar una página
Recupera un objeto Page con el identificador especificado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de página
|
page_id | True | string |
Identificador de una página De noción |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id
|
id | string |
Identificador único de la página. |
|
Tiempo creado
|
created_time | string |
Fecha y hora en que se creó esta página. Con formato de cadena de fecha y hora ISO 8601. |
|
Hora de última edición
|
last_edited_time | string |
Fecha y hora en que se actualizó esta página. Con formato de cadena de fecha y hora ISO 8601. |
|
Id
|
created_by.id | string |
Identificador único para este usuario. |
|
Id
|
last_edited_by.id | string |
Identificador único para este usuario. |
|
URL
|
cover.url | string |
Vínculo a la imagen hospedada externamente. |
|
emoji
|
icon.emoji | string |
Carácter emoji. |
|
ID de base de datos
|
parent.database_id | string |
ID de base de datos |
|
Archivados
|
archived | boolean |
Estado archivado de la página. |
|
URL
|
url | string |
Dirección URL de la página De noción. |
Recuperar usuario
Recupera un usuario mediante el identificador especificado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de usuario
|
user_id | True | string |
Identificador único para este usuario. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id
|
id | string |
Identificador de un usuario de Notion |
|
Nombre de usuario
|
name | string |
Nombre del usuario |
|
Avatar URL
|
avatar_url | string |
Imagen de avatar elegida |
|
Correo Electrónico
|
string |
Dirección de correo electrónico de la persona. |
Search
Busca en todas las páginas y páginas secundarias que se comparten con la integración. Los resultados pueden incluir bases de datos.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Query
|
query | True | string |
Cuando se proporciona, limita las páginas que se devuelven comparando la consulta con el título de la página. |
|
Dirección
|
direction | string |
Dirección que se va a ordenar. Los valores posibles incluyen ascendente y descendente. |
|
|
Marca de tiempo
|
timestamp | string |
Nombre de la marca de tiempo con la que se va a ordenar. Entre los valores posibles se incluyen last_edited_time. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
id
|
id | string |
Identificador del bloque. |
|
Tiempo creado
|
created_time | string |
Fecha y hora en que se creó esta página. |
|
Hora de última edición
|
last_edited_time | string |
Fecha y hora en que se actualizó esta página. |
|
Texto sin formato
|
plain_text | string |
Texto sin formato sin anotaciones. |
|
Etiquetas
|
Tags | object |
El objeto tags contiene la lista de etiquetas. |
|
URL
|
url | string |
Dirección URL del objeto . |
|
Cursor siguiente
|
next_cursor | string |
Cursor devuelto usado para solicitar la siguiente página de resultados. Tratar esto como un valor opaco |
|
Tiene más
|
has_more | boolean |
Si el bloque tiene o no más bloques |
Definiciones
CommentResponse
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id
|
id | string |
Identificador único del comentario. |
|
Id. de página
|
parent.page_id | string |
Identificador de la página a la que pertenece esta página. |
|
Identificador de discusión
|
discussion_id | string |
Identificador único del subproceso de discusión al que está asociado el comentario. |
|
Tiempo creado
|
created_time | string |
Fecha y hora en que se creó este comentario. |
|
Hora de última edición
|
last_edited_time | string |
Fecha y hora en que se actualizó este comentario. |
|
objeto
|
created_by.object | string |
objeto |
|
id
|
created_by.id | string |
id |
|
Texto enriquecido
|
rich_text | array of object |
Contenido del comentario, que admite formato de texto enriquecido, vínculos y menciones. |
|
type
|
rich_text.type | string |
type |
|
Content
|
rich_text.text.content | string |
Contenido de texto. |
|
Link
|
rich_text.text.link | string |
Cualquier vínculo insertado en este texto. |
|
Texto sin formato
|
rich_text.plain_text | string |
Texto sin formato sin anotaciones. |
|
href
|
rich_text.href | string |
(opcional) Dirección URL de cualquier vínculo o mención interna de Noción en este texto, si existe. |
DatabaseResponse
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
results
|
results | array of object | |
|
Objeto
|
results.object | string |
Página o "base de datos" |
|
Id
|
results.id | string |
Identificador único de la base de datos. |
|
Tiempo creado
|
results.created_time | string |
Fecha y hora en que se creó esta base de datos. Con formato de cadena de fecha y hora ISO 8601. |
|
Hora de última edición
|
results.last_edited_time | string |
Fecha y hora en que se actualizó esta base de datos. Con formato de cadena de fecha y hora ISO 8601. |
|
Objeto
|
results.created_by.object | string |
Usuario que creó la base de datos. |
|
Id
|
results.created_by.id | string |
Identificador único del usuario |
|
Objeto
|
results.last_edited_by.object | string |
Usuario que creó la base de datos. |
|
Id
|
results.last_edited_by.id | string |
Identificador único del usuario |
|
Archivado
|
results.archived | boolean |
Estado archivado de la base de datos. |
|
URL
|
results.url | string |
Dirección URL de la base de datos de Notion |