Notion (éditeur indépendant)
Le connecteur Notion utilise l’API pour accéder aux pages, bases de données et utilisateurs de Notion.
Ce connecteur est disponible dans les produits et régions suivants :
| Service | classe | Régions |
|---|---|---|
| Copilot Studio | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Applications logiques | Norme | Toutes les régions Logic Apps , à l’exception des suivantes : - Régions Azure Government - Régions Azure Chine - Us Department of Defense (DoD) |
| Power Apps | Premium | Toutes les régions Power Apps , à l’exception des suivantes : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Nom | Chandra Sekhar &Harshini Varma |
| URL | https://github.com/sekharmalla |
| Messagerie électronique | chandra.malla@msftcommunity.com |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | Chandra Sekhar &Harshini Varma |
| Site internet | https://www.notion.so/ |
| Politique de confidentialité | https://www.notion.so/Privacy-Policy-3468d120cf614d4c9014c09f6adc9091 |
| Catégories | Productivité; collaboration |
Création d’une connexion
Le connecteur prend en charge les types d’authentification suivants :
| Par défaut | Paramètres de création de connexion. | Toutes les régions | Non partageable |
Faire défaut
Applicable : Toutes les régions
Paramètres de création de connexion.
Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.
| Nom | Type | Descriptif | Obligatoire |
|---|---|---|---|
| Clé d’API | securestring | Clé API pour cette API | Vrai |
Limitations
| Nom | Appels | Période de renouvellement |
|---|---|---|
| Appels d’API par connexion | 100 | 60 secondes |
Actions
| Ajouter des enfants de bloc |
Crée et ajoute de nouveaux blocs enfants au block_id parent spécifié. |
| Créer un commentaire |
Crée un commentaire dans une page ou un thread de discussion existant. |
| Créer une page |
Crée une page dans la base de données spécifiée. page existante. |
| Interroger une base de données |
Obtient une liste de pages contenues dans la base de données, filtrées et triées en fonction des conditions de filtre et des critères de tri fournis dans la requête. |
| Liste de tous les utilisateurs |
Retourne une liste paginé d’utilisateurs pour l’espace de travail |
| Mettre à jour un bloc |
Met à jour le contenu du block_id spécifié en fonction du type de bloc. Champs pris en charge en fonction du type d’objet de bloc |
| Rechercher |
Recherche toutes les pages et pages enfants partagées avec l’intégration. Les résultats peuvent inclure des bases de données. |
| Récupérer des commentaires |
Récupère une liste d’objets Commentaires non résolus à partir d’une page ou d’un bloc. |
| Récupérer les enfants de bloc |
Retourne un tableau paginé d’objets de bloc enfant contenus dans le bloc à l’aide de l’ID spécifié |
| Récupérer l’utilisateur |
Récupère un utilisateur à l’aide de l’ID spécifié. |
| Récupérer l’utilisateur du bot de votre jeton |
Récupère l’utilisateur du bot associé au jeton d’API fourni dans l’en-tête d’autorisation. Le bot aura un champ propriétaire avec des informations sur la personne qui a autorisé l’intégration. |
| Récupérer un bloc |
Récupère un objet Block à l’aide de l’ID spécifié. |
| Récupérer un élément de propriété de page |
Récupérer un élément de propriété de page |
| Récupérer une base de données |
Récupère un objet De base de données à l’aide de l’ID spécifié. |
| Récupérer une page |
Récupère un objet Page à l’aide de l’ID spécifié. |
| Supprimer un bloc |
Définit un objet Block, y compris des blocs de page, à archiver : true à l’aide de l’ID spécifié. Remarque : dans l’application Notion UI, cela déplace le bloc vers la « Corbeille » où il est toujours accessible et restauré. |
Ajouter des enfants de bloc
Crée et ajoute de nouveaux blocs enfants au block_id parent spécifié.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de bloc
|
block_id | True | string |
Identificateur d’un bloc |
|
objet
|
object | string |
objet |
|
|
type
|
type | string |
type |
|
|
type
|
type | string |
type |
|
|
contenu
|
content | string |
contenu |
|
|
type
|
type | string |
type |
|
|
contenu
|
content | string |
contenu |
|
|
URL
|
url | string |
URL |
Créer un commentaire
Crée un commentaire dans une page ou un thread de discussion existant.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Page ID
|
page_id | string |
Identificateur d’une page |
|
|
Discussion ID
|
discussion_id | string |
Identificateur d’un bloc Notion |
|
|
Content
|
content | string |
Contenu texte. Ce champ contient le contenu réel de votre texte et est probablement le champ que vous utiliserez le plus souvent. |
Retours
- Corps
- CommentResponse
Créer une page
Crée une page dans la base de données spécifiée. page existante.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de base de données
|
database_id | True | string |
Identificateur unique de la base de données. |
|
Emoji
|
emoji | string |
emoji |
|
|
URL de couverture
|
url | string |
URL de l’image de couverture de page. |
|
|
Propriétés
|
properties | object |
Schéma des propriétés de la base de données telle qu’elles apparaissent dans Notion. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Id
|
id | string |
Identificateur unique de la page. |
|
Temps créé
|
created_time | string |
Date et heure de création de cette page. Mise en forme sous forme de chaîne d’heure de date ISO 8601. |
|
Heure de dernière modification
|
last_edited_time | string |
Date et heure de la mise à jour de cette page. Mise en forme sous forme de chaîne d’heure de date ISO 8601. |
|
Id
|
created_by.id | string |
Identificateur unique pour cet utilisateur. |
|
Id
|
last_edited_by.id | string |
Identificateur unique pour cet utilisateur. |
|
URL
|
cover.url | string |
Lien vers l’image hébergée en externe. |
|
emoji
|
icon.emoji | string |
Caractère Emoji. |
|
database_id
|
parent.database_id | string |
database_id |
|
Archivés
|
archived | boolean |
État archivé de la page. |
|
URL
|
url | string |
URL de la page Notion. |
Interroger une base de données
Obtient une liste de pages contenues dans la base de données, filtrées et triées en fonction des conditions de filtre et des critères de tri fournis dans la requête.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de base de données
|
database_id | True | string |
Identificateur d’une base de données Notion. |
Retours
- Corps
- DatabaseResponse
Liste de tous les utilisateurs
Retourne une liste paginé d’utilisateurs pour l’espace de travail
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Taille de la page
|
page_size | integer |
Nombre d’éléments de la liste complète souhaitée dans la réponse. Maximum : 100 |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Id
|
id | string |
Identificateur d’un bloc Notion |
|
Nom d’affichage
|
name | string |
Nom de l’utilisateur affiché dans Notion. |
|
URL de l’avatar
|
avatar_url | string |
Image d’avatar choisie. |
|
Type
|
type | string |
Type de l’utilisateur. Les valeurs possibles sont « person » et « bot ». |
|
Messagerie électronique
|
string |
Adresse e-mail de la personne. |
|
|
Curseur suivant
|
next_cursor | string |
Curseur retourné utilisé pour demander la page suivante des résultats. Traitez-le comme une valeur opaque |
|
A plus
|
has_more | boolean |
Lorsque la réponse inclut la fin de la liste |
Mettre à jour un bloc
Met à jour le contenu du block_id spécifié en fonction du type de bloc. Champs pris en charge en fonction du type d’objet de bloc
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de bloc
|
blockId | True | string |
Identificateur d’un bloc Notion |
|
Content
|
content | string |
Contenu texte. Ce champ contient le contenu réel de votre texte et est probablement le champ que vous utiliserez le plus souvent. |
|
|
Color
|
color | string |
Couleur du bloc. |
|
|
Content
|
content | string |
Contenu texte. Ce champ contient le contenu réel de votre texte et est probablement le champ que vous utiliserez le plus souvent. |
|
|
Color
|
color | string |
Couleur du bloc. |
|
|
Content
|
content | string |
Contenu texte2. Ce champ contient le contenu réel de votre texte et est probablement le champ que vous utiliserez le plus souvent. |
|
|
Color
|
color | string |
Couleur du bloc. |
|
|
Content
|
content | string |
Contenu texte. Ce champ contient le contenu réel de votre texte et est probablement le champ que vous utiliserez le plus souvent. |
|
|
Color
|
color | string |
Couleurs |
|
|
Contenu1
|
content | string |
Contenu texte. Ce champ contient le contenu réel de votre texte et est probablement le champ que vous utiliserez le plus souvent. |
|
|
Color
|
color | string |
Couleur du bloc. |
|
|
Contenu1
|
content | string |
Contenu texte. Ce champ contient le contenu réel de votre texte et est probablement le champ que vous utiliserez le plus souvent. |
|
|
Color
|
color | string |
Couleur du bloc. |
|
|
Contenu1
|
content | string |
Contenu texte. Ce champ contient le contenu réel de votre texte et est probablement le champ que vous utiliserez le plus souvent. |
|
|
Vérifié
|
checked | boolean |
Indique si la to_do est vérifiée ou non. |
|
|
Color
|
color | string |
Couleur du bloc. |
Rechercher
Recherche toutes les pages et pages enfants partagées avec l’intégration. Les résultats peuvent inclure des bases de données.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Query
|
query | True | string |
Lorsqu’elles sont fournies, limite les pages retournées en comparant la requête au titre de la page. |
|
Direction
|
direction | string |
Direction à trier. Les valeurs possibles incluent l’ordre croissant et décroissant. |
|
|
Timestamp
|
timestamp | string |
Nom de l’horodatage à trier. Les valeurs possibles incluent last_edited_time. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
pièce d'identité
|
id | string |
Identificateur du bloc. |
|
Temps créé
|
created_time | string |
Date et heure de création de cette page. |
|
Heure de dernière modification
|
last_edited_time | string |
Date et heure de la mise à jour de cette page. |
|
Texte brut
|
plain_text | string |
Texte brut sans annotations. |
|
Étiquettes
|
Tags | object |
L’objet tags contient la liste des balises. |
|
URL
|
url | string |
URL de l’objet. |
|
Curseur suivant
|
next_cursor | string |
Curseur retourné utilisé pour demander la page suivante des résultats. Traitez-le comme une valeur opaque |
|
A plus
|
has_more | boolean |
Indique si le bloc a plus de blocs ou non |
Récupérer des commentaires
Récupère une liste d’objets Commentaires non résolus à partir d’une page ou d’un bloc.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de bloc
|
block_id | True | string |
Identificateur d’un bloc ou d’une page Notion |
Retours
- Corps
- CommentResponse
Récupérer les enfants de bloc
Retourne un tableau paginé d’objets de bloc enfant contenus dans le bloc à l’aide de l’ID spécifié
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de bloc
|
block_id | True | string |
Identificateur d’un bloc |
|
Taille de la page
|
page_size | integer |
Nombre d’éléments de la liste complète souhaitée dans la réponse. Maximum : 100 |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
pièce d'identité
|
items.id | string |
Identificateur du bloc. |
|
Temps créé
|
items.created_time | date-time |
Date et heure de création de ce bloc. |
|
Heure de dernière modification
|
items.last_edited_time | date-time |
Date et heure de la dernière mise à jour de ce bloc. |
|
A des enfants
|
items.has_children | boolean |
Indique si le bloc contient des blocs enfants imbriqués. |
|
Archivés
|
items.archived | boolean |
État archivé du bloc. |
|
Type
|
items.type | string |
Type de bloc. Valeurs possibles |
|
Texte brut
|
plain_text | string |
Texte brut dans le bloc de paragraphes plain_text |
|
Curseur suivant
|
next_cursor | string |
Curseur retourné utilisé pour demander la page suivante des résultats. Traitez-le comme une valeur opaque |
|
A plus
|
has_more | boolean |
Indique si le bloc a plus de blocs ou non |
Récupérer l’utilisateur
Récupère un utilisateur à l’aide de l’ID spécifié.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID d’utilisateur
|
user_id | True | string |
Identificateur unique pour cet utilisateur. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Id
|
id | string |
Identificateur d’un utilisateur Notion |
|
Nom d'utilisateur
|
name | string |
Nom de l’utilisateur |
|
URL de l’avatar
|
avatar_url | string |
Image d’avatar choisie |
|
Messagerie électronique
|
string |
Adresse e-mail de la personne. |
Récupérer l’utilisateur du bot de votre jeton
Récupère l’utilisateur du bot associé au jeton d’API fourni dans l’en-tête d’autorisation. Le bot aura un champ propriétaire avec des informations sur la personne qui a autorisé l’intégration.
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Id
|
id | string |
Identificateur unique pour cet utilisateur. |
|
Nom
|
name | string |
Nom de l’utilisateur tel qu’il est affiché dans Notion. |
|
URL de l’avatar
|
avatar_url | string |
Image d’avatar choisie. |
|
Type
|
type | string |
Type de l’utilisateur. Les valeurs possibles sont « person » et « bot ». |
|
Type de propriétaire
|
bot.owner.type | string |
Type de propriétaire : « espace de travail » ou « utilisateur ». |
Récupérer un bloc
Récupère un objet Block à l’aide de l’ID spécifié.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de bloc
|
blockId | True | string |
Identificateur du bloc. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
objet
|
object | string |
objet |
|
pièce d'identité
|
id | string |
Identificateur du bloc. |
|
Temps créé
|
created_time | date-time |
Date et heure de création de ce bloc. |
|
Heure de dernière modification
|
last_edited_time | date-time |
Date et heure de la dernière mise à jour de ce bloc. |
|
Objet
|
created_by.object | string |
Toujours « utilisateur » |
|
Id
|
created_by.id | string |
Identificateur unique pour cet utilisateur. |
|
Objet
|
last_edited_by.object | string |
Dernier utilisateur modifié |
|
Id
|
last_edited_by.id | string |
Identificateur unique pour cet utilisateur. |
|
A des enfants
|
has_children | boolean |
Indique si le bloc contient des blocs enfants imbriqués. |
|
Archivés
|
archived | boolean |
État archivé du bloc. |
|
Type
|
type | string |
Objet contenant des informations de bloc spécifiques au type |
Récupérer un élément de propriété de page
Récupérer un élément de propriété de page
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Page ID
|
page_id | True | string |
Identificateur d’une page Notion |
|
ID de propriété
|
property_id | True | string |
Identificateur d’une propriété de page |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Objet
|
object | string |
Toujours lister. |
|
A plus
|
has_more | boolean |
Lorsque la réponse inclut la fin de la liste, false. Sinon, vrai. |
Récupérer une base de données
Récupère un objet De base de données à l’aide de l’ID spécifié.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de base de données
|
database_id | True | string |
Identificateur d’une base de données Notion |
Retours
- Corps
- DatabaseResponse
Récupérer une page
Récupère un objet Page à l’aide de l’ID spécifié.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Page ID
|
page_id | True | string |
Identificateur d’une page Notion |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Id
|
id | string |
Identificateur unique de la page. |
|
Temps créé
|
created_time | string |
Date et heure de création de cette page. Mise en forme sous forme de chaîne d’heure de date ISO 8601. |
|
Heure de dernière modification
|
last_edited_time | string |
Date et heure de la mise à jour de cette page. Mise en forme sous forme de chaîne d’heure de date ISO 8601. |
|
Id
|
created_by.id | string |
Identificateur unique pour cet utilisateur. |
|
Id
|
last_edited_by.id | string |
Identificateur unique pour cet utilisateur. |
|
URL
|
cover.url | string |
Lien vers l’image hébergée en externe. |
|
emoji
|
icon.emoji | string |
Caractère Emoji. |
|
database_id
|
parent.database_id | string |
database_id |
|
Archivés
|
archived | boolean |
État archivé de la page. |
|
URL
|
url | string |
URL de la page Notion. |
Supprimer un bloc
Définit un objet Block, y compris des blocs de page, à archiver : true à l’aide de l’ID spécifié. Remarque : dans l’application Notion UI, cela déplace le bloc vers la « Corbeille » où il est toujours accessible et restauré.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de bloc
|
blockId | True | string |
Identificateur d’un bloc Notion |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
pièce d'identité
|
id | string |
Identificateur du bloc. |
|
Temps créé
|
created_time | date-time |
Date et heure de création de ce bloc. |
|
Heure de dernière modification
|
last_edited_time | date-time |
Date et heure de la dernière mise à jour de ce bloc. |
|
Objet
|
created_by.object | string |
Toujours « utilisateur » |
|
Id
|
created_by.id | string |
Identificateur unique pour cet utilisateur. |
|
Objet
|
last_edited_by.object | string |
Dernier utilisateur modifié |
|
Id
|
last_edited_by.id | string |
Identificateur unique pour cet utilisateur. |
|
A des enfants
|
has_children | boolean |
Indique si le bloc contient des blocs enfants imbriqués. |
|
Archivés
|
archived | boolean |
État archivé du bloc. |
|
Type
|
type | string |
Objet contenant des informations de bloc spécifiques au type |
Définitions
CommentResponse
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Id
|
id | string |
Identificateur unique du commentaire. |
|
Page Id
|
parent.page_id | string |
ID de la page à laquelle appartient cette page. |
|
ID de discussion
|
discussion_id | string |
Identificateur unique du thread de discussion auquel le commentaire est associé. |
|
Temps créé
|
created_time | string |
Date et heure de création de ce commentaire. |
|
Heure de dernière modification
|
last_edited_time | string |
Date et heure de mise à jour de ce commentaire. |
|
objet
|
created_by.object | string |
objet |
|
pièce d'identité
|
created_by.id | string |
pièce d'identité |
|
Texte enrichi
|
rich_text | array of object |
Contenu du commentaire, qui prend en charge la mise en forme de texte enrichi, les liens et les mentions. |
|
type
|
rich_text.type | string |
type |
|
Content
|
rich_text.text.content | string |
Contenu texte. |
|
Lien
|
rich_text.text.link | string |
Tout lien inline dans ce texte. |
|
Texte brut
|
rich_text.plain_text | string |
Texte brut sans annotations. |
|
href
|
rich_text.href | string |
(facultatif) URL d’un lien ou d’une mention notion interne dans ce texte, le cas échéant. |
DatabaseResponse
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
results
|
results | array of object | |
|
Objet
|
results.object | string |
Page ou « base de données » |
|
Id
|
results.id | string |
Identificateur unique de la base de données. |
|
Temps créé
|
results.created_time | string |
Date et heure de création de cette base de données. Mise en forme sous forme de chaîne d’heure de date ISO 8601. |
|
Heure de dernière modification
|
results.last_edited_time | string |
Date et heure de mise à jour de cette base de données. Mise en forme sous forme de chaîne d’heure de date ISO 8601. |
|
Objet
|
results.created_by.object | string |
Utilisateur qui a créé la base de données. |
|
Id
|
results.created_by.id | string |
Identificateur unique pour l’utilisateur |
|
Objet
|
results.last_edited_by.object | string |
Utilisateur qui a créé la base de données. |
|
Id
|
results.last_edited_by.id | string |
Identificateur unique pour l’utilisateur |
|
Archivés
|
results.archived | boolean |
État archivé de la base de données. |
|
URL
|
results.url | string |
URL de la base de données Notion |