Notion (onafhankelijke uitgever)
De Notion-connector gebruikt de API voor toegang tot de pagina's, databases en gebruikers van Notion.
Deze connector is beschikbaar in de volgende producten en regio's:
| Dienst | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Logic-apps | Standaard | Alle Logic Apps-regio's , met uitzondering van het volgende: - Azure Government-regio's - Azure China-regio's - Us Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Contactpersoon | |
|---|---|
| Naam | Chandra Sekhar & Harshini Varma |
| URL | https://github.com/sekharmalla |
| E-mailen | chandra.malla@msftcommunity.com |
| Connectormetagegevens | |
|---|---|
| Uitgever | Chandra Sekhar & Harshini Varma |
| Webpagina | https://www.notion.so/ |
| Privacybeleid | https://www.notion.so/Privacy-Policy-3468d120cf614d4c9014c09f6adc9091 |
| Categorieën | Productiviteit; samenwerking |
Een verbinding maken
De connector ondersteunt de volgende verificatietypen:
| standaard | Parameters voor het maken van verbinding. | Alle regio's | Niet deelbaar |
Verstek
Van toepassing: Alle regio's
Parameters voor het maken van verbinding.
Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.
| Naam | Typologie | Description | Verplicht |
|---|---|---|---|
| API-sleutel | beveiligde string | De API-sleutel voor deze API | Klopt |
Beperkingslimieten
| Name | Aanroepen | Verlengingsperiode |
|---|---|---|
| API-aanroepen per verbinding | 100 | 60 seconden |
Acties
| Blok-onderliggende items ophalen |
Retourneert een gepagineerde matrix van onderliggende blokobjecten in het blok met behulp van de opgegeven id |
| De botgebruiker van uw token ophalen |
Hiermee wordt de botgebruiker opgehaald die is gekoppeld aan het API-token dat is opgegeven in de autorisatieheader. De bot heeft een eigenaarveld met informatie over de persoon die de integratie heeft geautoriseerd. |
| Een blok bijwerken |
Hiermee wordt de inhoud voor de opgegeven block_id bijgewerkt op basis van het bloktype. Ondersteunde velden op basis van het objecttype Blok |
| Een blok ophalen |
Hiermee haalt u een blokobject op met behulp van de opgegeven id. |
| Een blok verwijderen |
Hiermee stelt u een blokobject, inclusief paginablokken, in op gearchiveerd: true met behulp van de opgegeven id. Opmerking: in de Notion UI-toepassing wordt het blok verplaatst naar de Prullenbak waar het nog steeds kan worden geopend en hersteld. |
| Een database ophalen |
Hiermee haalt u een databaseobject op met behulp van de opgegeven id. |
| Een pagina-eigenschapsitem ophalen |
Een pagina-eigenschapsitem ophalen |
| Een pagina maken |
Hiermee maakt u een nieuwe pagina in de opgegeven database. bestaande pagina. |
| Een pagina ophalen |
Hiermee haalt u een paginaobject op met behulp van de opgegeven id. |
| Een query uitvoeren op een database |
Hiermee haalt u een lijst met pagina's op die zijn opgenomen in de database, gefilterd en geordend volgens de filtervoorwaarden en sorteercriteria die in de aanvraag zijn opgegeven. |
| Gebruiker ophalen |
Haalt een gebruiker op met behulp van de opgegeven id. |
| Lijst met alle gebruikers |
Hiermee wordt een gepagineerde lijst met gebruikers voor de werkruimte geretourneerd |
| Onderliggende elementen van toevoegblok |
Hiermee maakt en voegt u nieuwe onderliggende blokken toe aan de bovenliggende block_id opgegeven. |
| Opmerking maken |
Hiermee maakt u een opmerking in een pagina of bestaande discussiethread. |
| Opmerkingen ophalen |
Hiermee wordt een lijst met niet-opgeloste opmerkingsobjecten opgehaald van een pagina of blok. |
| Zoeken |
Hiermee doorzoekt u alle pagina's en onderliggende pagina's die worden gedeeld met de integratie. De resultaten kunnen databases bevatten. |
Blok-onderliggende items ophalen
Retourneert een gepagineerde matrix van onderliggende blokobjecten in het blok met behulp van de opgegeven id
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Blok-id
|
block_id | True | string |
Id voor een blok |
|
Paginaformaat
|
page_size | integer |
Het aantal items uit de volledige lijst dat in het antwoord wordt weergegeven. Maximum: 100 |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
identiteitskaart
|
items.id | string |
Id voor het blok. |
|
Gecreëerde tijd
|
items.created_time | date-time |
Datum en tijd waarop dit blok is gemaakt. |
|
Laatst bewerkte tijd
|
items.last_edited_time | date-time |
Datum en tijd waarop dit blok voor het laatst is bijgewerkt. |
|
Heeft kinderen
|
items.has_children | boolean |
Of het blok onderliggende blokken al dan niet genest bevat. |
|
Gearchiveerde
|
items.archived | boolean |
De gearchiveerde status van het blok. |
|
Typologie
|
items.type | string |
Type blok. Mogelijke waarden |
|
Tekst zonder opmaak
|
plain_text | string |
Tekst zonder opmaak in het alineablok plain_text |
|
Volgende cursor
|
next_cursor | string |
Een cursor die wordt geretourneerd om de volgende pagina met resultaten aan te vragen. Dit behandelen als een ondoorzichtige waarde |
|
Heeft meer
|
has_more | boolean |
Of het blok al dan niet meer blokken heeft of niet |
De botgebruiker van uw token ophalen
Hiermee wordt de botgebruiker opgehaald die is gekoppeld aan het API-token dat is opgegeven in de autorisatieheader. De bot heeft een eigenaarveld met informatie over de persoon die de integratie heeft geautoriseerd.
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Identiteitsbewijs
|
id | string |
Unieke id voor deze gebruiker. |
|
Naam
|
name | string |
De naam van de gebruiker zoals weergegeven in Notion. |
|
Avatar-URL
|
avatar_url | string |
Gekozen avatarafbeelding. |
|
Typologie
|
type | string |
Type gebruiker. Mogelijke waarden zijn 'persoon' en 'bot'. |
|
Eigenaartype
|
bot.owner.type | string |
Het type eigenaar: 'werkruimte' of 'gebruiker'. |
Een blok bijwerken
Hiermee wordt de inhoud voor de opgegeven block_id bijgewerkt op basis van het bloktype. Ondersteunde velden op basis van het objecttype Blok
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Blok-id
|
blockId | True | string |
Id voor een Notion-blok |
|
Content
|
content | string |
Tekstinhoud. Dit veld bevat de werkelijke inhoud van uw tekst en is waarschijnlijk het veld dat u het meest gebruikt. |
|
|
Kleur
|
color | string |
Kleur van het blok. |
|
|
Content
|
content | string |
Tekstinhoud. Dit veld bevat de werkelijke inhoud van uw tekst en is waarschijnlijk het veld dat u het meest gebruikt. |
|
|
Kleur
|
color | string |
Kleur van het blok. |
|
|
Content
|
content | string |
Tekstinhoud2. Dit veld bevat de werkelijke inhoud van uw tekst en is waarschijnlijk het veld dat u het meest gebruikt. |
|
|
Kleur
|
color | string |
Kleur van het blok. |
|
|
Content
|
content | string |
Tekstinhoud. Dit veld bevat de werkelijke inhoud van uw tekst en is waarschijnlijk het veld dat u het meest gebruikt. |
|
|
Kleur
|
color | string |
kleuren |
|
|
Inhoud1
|
content | string |
Tekstinhoud. Dit veld bevat de werkelijke inhoud van uw tekst en is waarschijnlijk het veld dat u het meest gebruikt. |
|
|
Kleur
|
color | string |
Kleur van het blok. |
|
|
Inhoud1
|
content | string |
Tekstinhoud. Dit veld bevat de werkelijke inhoud van uw tekst en is waarschijnlijk het veld dat u het meest gebruikt. |
|
|
Kleur
|
color | string |
Kleur van het blok. |
|
|
Inhoud1
|
content | string |
Tekstinhoud. Dit veld bevat de werkelijke inhoud van uw tekst en is waarschijnlijk het veld dat u het meest gebruikt. |
|
|
Gecontroleerd
|
checked | boolean |
Of de to_do is ingeschakeld of niet. |
|
|
Kleur
|
color | string |
Kleur van het blok. |
Een blok ophalen
Hiermee haalt u een blokobject op met behulp van de opgegeven id.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Blok-id
|
blockId | True | string |
Id voor het blok. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Voorwerp
|
object | string |
Voorwerp |
|
identiteitskaart
|
id | string |
Id voor het blok. |
|
Gecreëerde tijd
|
created_time | date-time |
Datum en tijd waarop dit blok is gemaakt. |
|
Laatst bewerkte tijd
|
last_edited_time | date-time |
Datum en tijd waarop dit blok voor het laatst is bijgewerkt. |
|
Object
|
created_by.object | string |
Altijd 'gebruiker' |
|
Identiteitsbewijs
|
created_by.id | string |
Unieke id voor deze gebruiker. |
|
Object
|
last_edited_by.object | string |
Laatst bewerkte gebruiker |
|
Identiteitsbewijs
|
last_edited_by.id | string |
Unieke id voor deze gebruiker. |
|
Heeft kinderen
|
has_children | boolean |
Of het blok onderliggende blokken al dan niet genest bevat. |
|
Gearchiveerde
|
archived | boolean |
De gearchiveerde status van het blok. |
|
Typologie
|
type | string |
Een object met typespecifieke blokgegevens |
Een blok verwijderen
Hiermee stelt u een blokobject, inclusief paginablokken, in op gearchiveerd: true met behulp van de opgegeven id. Opmerking: in de Notion UI-toepassing wordt het blok verplaatst naar de Prullenbak waar het nog steeds kan worden geopend en hersteld.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Blok-id
|
blockId | True | string |
Id voor een Notion-blok |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
identiteitskaart
|
id | string |
Id voor het blok. |
|
Gecreëerde tijd
|
created_time | date-time |
Datum en tijd waarop dit blok is gemaakt. |
|
Laatst bewerkte tijd
|
last_edited_time | date-time |
Datum en tijd waarop dit blok voor het laatst is bijgewerkt. |
|
Object
|
created_by.object | string |
Altijd 'gebruiker' |
|
Identiteitsbewijs
|
created_by.id | string |
Unieke id voor deze gebruiker. |
|
Object
|
last_edited_by.object | string |
Laatst bewerkte gebruiker |
|
Identiteitsbewijs
|
last_edited_by.id | string |
Unieke id voor deze gebruiker. |
|
Heeft kinderen
|
has_children | boolean |
Of het blok onderliggende blokken al dan niet genest bevat. |
|
Gearchiveerde
|
archived | boolean |
De gearchiveerde status van het blok. |
|
Typologie
|
type | string |
Een object met typespecifieke blokgegevens |
Een database ophalen
Hiermee haalt u een databaseobject op met behulp van de opgegeven id.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Database-id
|
database_id | True | string |
Id voor een Notion-database |
Retouren
- Body
- DatabaseResponse
Een pagina-eigenschapsitem ophalen
Een pagina-eigenschapsitem ophalen
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Pagina-id
|
page_id | True | string |
Id voor een Notion-pagina |
|
Eigenschaps-id
|
property_id | True | string |
Id voor een pagina-eigenschap |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Object
|
object | string |
Altijd vermelden. |
|
Heeft meer
|
has_more | boolean |
Wanneer het antwoord het einde van de lijst bevat, false. Anders, waar. |
Een pagina maken
Hiermee maakt u een nieuwe pagina in de opgegeven database. bestaande pagina.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Database-id
|
database_id | True | string |
Unieke id voor de database. |
|
Emoji
|
emoji | string |
emoji |
|
|
Omslag-URL
|
url | string |
Afbeeldings-URL voor paginavoorblad. |
|
|
Eigenschappen
|
properties | object |
Schema van eigenschappen voor de database zoals deze worden weergegeven in Notion. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Identiteitsbewijs
|
id | string |
Unieke id van de pagina. |
|
Gecreëerde tijd
|
created_time | string |
Datum en tijd waarop deze pagina is gemaakt. Opgemaakt als een ISO 8601-datum/tijdtekenreeks. |
|
Laatst bewerkte tijd
|
last_edited_time | string |
Datum en tijd waarop deze pagina is bijgewerkt. Opgemaakt als een ISO 8601-datum/tijdtekenreeks. |
|
Identiteitsbewijs
|
created_by.id | string |
Unieke id voor deze gebruiker. |
|
Identiteitsbewijs
|
last_edited_by.id | string |
Unieke id voor deze gebruiker. |
|
url
|
cover.url | string |
Koppeling naar de extern gehoste installatiekopie. |
|
emoji
|
icon.emoji | string |
Emoji-teken. |
|
database_id
|
parent.database_id | string |
database_id |
|
Gearchiveerde
|
archived | boolean |
De gearchiveerde status van de pagina. |
|
URL
|
url | string |
De URL van de notion-pagina. |
Een pagina ophalen
Hiermee haalt u een paginaobject op met behulp van de opgegeven id.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Pagina-id
|
page_id | True | string |
Id voor een Notion-pagina |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Identiteitsbewijs
|
id | string |
Unieke id van de pagina. |
|
Gecreëerde tijd
|
created_time | string |
Datum en tijd waarop deze pagina is gemaakt. Opgemaakt als een ISO 8601-datum/tijdtekenreeks. |
|
Laatst bewerkte tijd
|
last_edited_time | string |
Datum en tijd waarop deze pagina is bijgewerkt. Opgemaakt als een ISO 8601-datum/tijdtekenreeks. |
|
Identiteitsbewijs
|
created_by.id | string |
Unieke id voor deze gebruiker. |
|
Identiteitsbewijs
|
last_edited_by.id | string |
Unieke id voor deze gebruiker. |
|
url
|
cover.url | string |
Koppeling naar de extern gehoste installatiekopie. |
|
emoji
|
icon.emoji | string |
Emoji-teken. |
|
database_id
|
parent.database_id | string |
database_id |
|
Gearchiveerde
|
archived | boolean |
De gearchiveerde status van de pagina. |
|
URL
|
url | string |
De URL van de notion-pagina. |
Een query uitvoeren op een database
Hiermee haalt u een lijst met pagina's op die zijn opgenomen in de database, gefilterd en geordend volgens de filtervoorwaarden en sorteercriteria die in de aanvraag zijn opgegeven.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Database-id
|
database_id | True | string |
Id voor een Notion-database. |
Retouren
- Body
- DatabaseResponse
Gebruiker ophalen
Haalt een gebruiker op met behulp van de opgegeven id.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Gebruikers-ID
|
user_id | True | string |
Unieke id voor deze gebruiker. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Identiteitsbewijs
|
id | string |
Id voor een Notion-gebruiker |
|
Gebruikersnaam
|
name | string |
Naam van de gebruiker |
|
Avatar-URL
|
avatar_url | string |
Gekozen avatarafbeelding |
|
E-mailen
|
string |
E-mailadres van persoon. |
Lijst met alle gebruikers
Hiermee wordt een gepagineerde lijst met gebruikers voor de werkruimte geretourneerd
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Paginaformaat
|
page_size | integer |
Het aantal items uit de volledige lijst dat in het antwoord wordt weergegeven. Maximum: 100 |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Identiteitsbewijs
|
id | string |
Id voor een Notion-blok |
|
Weergavenaam
|
name | string |
De naam van de gebruiker wordt weergegeven in Notion. |
|
Avatar-URL
|
avatar_url | string |
Gekozen avatarafbeelding. |
|
Typologie
|
type | string |
Type gebruiker. Mogelijke waarden zijn 'persoon' en 'bot'. |
|
E-mailen
|
string |
E-mailadres van persoon. |
|
|
Volgende cursor
|
next_cursor | string |
Een cursor die wordt geretourneerd om de volgende pagina met resultaten aan te vragen. Dit behandelen als een ondoorzichtige waarde |
|
Heeft meer
|
has_more | boolean |
Wanneer het antwoord het einde van de lijst bevat |
Onderliggende elementen van toevoegblok
Hiermee maakt en voegt u nieuwe onderliggende blokken toe aan de bovenliggende block_id opgegeven.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Blok-id
|
block_id | True | string |
Id voor een blok |
|
Voorwerp
|
object | string |
Voorwerp |
|
|
type
|
type | string |
type |
|
|
type
|
type | string |
type |
|
|
inhoud
|
content | string |
inhoud |
|
|
type
|
type | string |
type |
|
|
inhoud
|
content | string |
inhoud |
|
|
url
|
url | string |
url |
Opmerking maken
Hiermee maakt u een opmerking in een pagina of bestaande discussiethread.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Pagina-id
|
page_id | string |
Id voor een pagina |
|
|
Discussie-id
|
discussion_id | string |
Id voor een Notion-blok |
|
|
Content
|
content | string |
Tekstinhoud. Dit veld bevat de werkelijke inhoud van uw tekst en is waarschijnlijk het veld dat u het meest gebruikt. |
Retouren
- Body
- CommentResponse
Opmerkingen ophalen
Hiermee wordt een lijst met niet-opgeloste opmerkingsobjecten opgehaald van een pagina of blok.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Blok-id
|
block_id | True | string |
Id voor een Notion-blok of -pagina |
Retouren
- Body
- CommentResponse
Zoeken
Hiermee doorzoekt u alle pagina's en onderliggende pagina's die worden gedeeld met de integratie. De resultaten kunnen databases bevatten.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Query
|
query | True | string |
Wanneer u deze opgeeft, worden de limieten beperkt welke pagina's worden geretourneerd door de query te vergelijken met de paginatitel. |
|
Richting
|
direction | string |
De richting om te sorteren. Mogelijke waarden zijn oplopend en aflopend. |
|
|
Tijdstempel
|
timestamp | string |
De naam van de tijdstempel waarop moet worden gesorteerd. Mogelijke waarden zijn last_edited_time. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
identiteitskaart
|
id | string |
Id voor het blok. |
|
Gecreëerde tijd
|
created_time | string |
Datum en tijd waarop deze pagina is gemaakt. |
|
Laatst bewerkte tijd
|
last_edited_time | string |
Datum en tijd waarop deze pagina is bijgewerkt. |
|
Tekst zonder opmaak
|
plain_text | string |
De tekst zonder opmaak zonder aantekeningen. |
|
Tags
|
Tags | object |
Het tagsobject bevat de lijst met tags. |
|
URL
|
url | string |
De URL van het object. |
|
Volgende cursor
|
next_cursor | string |
Een cursor die wordt geretourneerd om de volgende pagina met resultaten aan te vragen. Dit behandelen als een ondoorzichtige waarde |
|
Heeft meer
|
has_more | boolean |
Of het blok al dan niet meer blokken heeft of niet |
Definities
CommentResponse
| Name | Pad | Type | Description |
|---|---|---|---|
|
Identiteitsbewijs
|
id | string |
Unieke id van de opmerking. |
|
Pagina-id
|
parent.page_id | string |
De id van de pagina waartoe deze pagina behoort. |
|
Discussie-id
|
discussion_id | string |
Unieke id van de discussiethread waaraan de opmerking is gekoppeld. |
|
Gecreëerde tijd
|
created_time | string |
Datum en tijd waarop deze opmerking is gemaakt. |
|
Laatst bewerkte tijd
|
last_edited_time | string |
Datum en tijd waarop deze opmerking is bijgewerkt. |
|
Voorwerp
|
created_by.object | string |
Voorwerp |
|
identiteitskaart
|
created_by.id | string |
identiteitskaart |
|
Tekst met opmaak
|
rich_text | array of object |
Inhoud van de opmerking, die ondersteuning biedt voor rtf-tekstopmaak, koppelingen en vermeldingen. |
|
type
|
rich_text.type | string |
type |
|
Content
|
rich_text.text.content | string |
Tekstinhoud. |
|
Link
|
rich_text.text.link | string |
Elke inlinekoppeling in deze tekst. |
|
Tekst zonder opmaak
|
rich_text.plain_text | string |
De tekst zonder opmaak zonder aantekeningen. |
|
href
|
rich_text.href | string |
(optioneel) De URL van een koppeling of interne Notie-vermelding in deze tekst, indien van toepassing. |
DatabaseResponse
| Name | Pad | Type | Description |
|---|---|---|---|
|
results
|
results | array of object | |
|
Object
|
results.object | string |
Pagina of database |
|
Identiteitsbewijs
|
results.id | string |
Unieke id voor de database. |
|
Gecreëerde tijd
|
results.created_time | string |
Datum en tijd waarop deze database is gemaakt. Opgemaakt als een ISO 8601-datum/tijdtekenreeks. |
|
Laatst bewerkte tijd
|
results.last_edited_time | string |
Datum en tijd waarop deze database is bijgewerkt. Opgemaakt als een ISO 8601-datum/tijdtekenreeks. |
|
Object
|
results.created_by.object | string |
Gebruiker die de database heeft gemaakt. |
|
Identiteitsbewijs
|
results.created_by.id | string |
Unieke id voor de gebruiker |
|
Object
|
results.last_edited_by.object | string |
Gebruiker die de database heeft gemaakt. |
|
Identiteitsbewijs
|
results.last_edited_by.id | string |
Unieke id voor de gebruiker |
|
Gearchiveerde
|
results.archived | boolean |
De gearchiveerde status van de database. |
|
URL
|
results.url | string |
De URL van de Notion-database |