Freigeben über


Konzept (unabhängiger Herausgeber)

Der Konzeptkonnektor verwendet die API für den Zugriff auf die Seiten, Datenbanken und Benutzer von Konzepten.

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Dienstleistung Class Regions
Copilot Studio Premium Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Logik-Apps Norm Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche:
     – Azure Government-Regionen
     - Azure China-Regionen
     - US Department of Defense (DoD)
Power Apps Premium Alle Power Apps-Regionen mit Ausnahme der folgenden:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Power Automate Premium Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Kontakt
Name Chandra Sekhar & Harshini Varma
URL https://github.com/sekharmalla
Email chandra.malla@msftcommunity.com
Connectormetadaten
Herausgeber Chandra Sekhar & Harshini Varma
Webseite https://www.notion.so/
Datenschutzrichtlinie https://www.notion.so/Privacy-Policy-3468d120cf614d4c9014c09f6adc9091
Kategorien Produktivität; Zusammenarbeit

Eine Verbindung wird erstellt

Der Connector unterstützt die folgenden Authentifizierungstypen:

Vorgabe Parameter zum Erstellen einer Verbindung. Alle Regionen Nicht teilbar

Vorgabe

Anwendbar: Alle Regionen

Parameter zum Erstellen einer Verbindung.

Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.

Name Typ Description Erforderlich
API-Schlüssel securestring Der API-Schlüssel für diese API Richtig

Drosselungsgrenzwerte

Name Aufrufe Verlängerungszeitraum
API-Aufrufe pro Verbindung 100 60 Sekunden

Aktionen

Abfragen einer Datenbank

Ruft eine Liste der In der Datenbank enthaltenen Seiten ab, gefiltert und sortiert nach den Filterbedingungen und Sortierkriterien in der Anforderung.

Abrufen des Bot-Benutzers Ihres Tokens

Ruft den bot-Benutzer ab, der dem IM Autorisierungsheader bereitgestellten API-Token zugeordnet ist. Der Bot verfügt über ein Besitzerfeld mit Informationen über die Person, die die Integration autorisiert hat.

Abrufen einer Datenbank

Ruft ein Database -Objekt mithilfe der angegebenen ID ab.

Abrufen einer Seite

Ruft ein Page -Objekt mithilfe der angegebenen ID ab.

Abrufen eines Blocks

Ruft ein Block -Objekt mithilfe der angegebenen ID ab.

Abrufen eines Seiteneigenschaftselements

Abrufen eines Seiteneigenschaftselements

Abrufen von block untergeordneten Elementen

Gibt ein paginiertes Array von untergeordneten Blockobjekten zurück, die im Block enthalten sind, wobei die angegebene ID verwendet wird.

Abrufen von Kommentaren

Ruft eine Liste nicht aufgelöster Kommentarobjekte von einer Seite oder einem Block ab.

Aktualisieren eines Blocks

Aktualisiert den Inhalt für die angegebene block_id basierend auf dem Blocktyp. Unterstützte Felder basierend auf dem Blockobjekttyp

Anfügen von untergeordneten Elementen

Erstellt und fügt neue untergeordnete Blöcke an das angegebene übergeordnete block_id an.

Benutzer abrufen

Ruft einen Benutzer mithilfe der angegebenen ID ab.

Erstellen einer Seite

Erstellt eine neue Seite in der angegebenen Datenbank. vorhandene Seite.

Kommentar erstellen

Erstellt einen Kommentar auf einer Seite oder in einem vorhandenen Diskussionsthread.

Liste aller Benutzer

Gibt eine paginierte Liste der Benutzer für den Arbeitsbereich zurück.

Löschen eines Blocks

Legt ein Block -Objekt, einschließlich Seitenblöcke, auf archiviert fest: true mithilfe der angegebenen ID. Hinweis: In der Anwendung "Notion UI" verschiebt dies den Block in den "Papierkorb", auf den weiterhin zugegriffen und wiederhergestellt werden kann.

Suche

Durchsucht alle Seiten und untergeordneten Seiten, die für die Integration freigegeben sind. Die Ergebnisse können Datenbanken enthalten.

Abfragen einer Datenbank

Ruft eine Liste der In der Datenbank enthaltenen Seiten ab, gefiltert und sortiert nach den Filterbedingungen und Sortierkriterien in der Anforderung.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Datenbank-ID
database_id True string

Bezeichner für eine Begriffsdatenbank.

Gibt zurück

Abrufen des Bot-Benutzers Ihres Tokens

Ruft den bot-Benutzer ab, der dem IM Autorisierungsheader bereitgestellten API-Token zugeordnet ist. Der Bot verfügt über ein Besitzerfeld mit Informationen über die Person, die die Integration autorisiert hat.

Gibt zurück

Name Pfad Typ Beschreibung
Id
id string

Eindeutiger Bezeichner für diesen Benutzer.

Name
name string

Der Name des Benutzers wird in "Notion" angezeigt.

Avatar-URL
avatar_url string

Ausgewähltes Avatarbild.

Typ
type string

Typ des Benutzers. Mögliche Werte sind "person" und "bot".

Besitzertyp
bot.owner.type string

Der Typ des Besitzers – entweder "Arbeitsbereich" oder "Benutzer".

Abrufen einer Datenbank

Ruft ein Database -Objekt mithilfe der angegebenen ID ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Datenbank-ID
database_id True string

Bezeichner für eine Begriffsdatenbank

Gibt zurück

Abrufen einer Seite

Ruft ein Page -Objekt mithilfe der angegebenen ID ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Seiten-ID
page_id True string

Bezeichner für eine Seite "Begriff"

Gibt zurück

Name Pfad Typ Beschreibung
Id
id string

Eindeutiger Bezeichner der Seite.

Erstellte Zeit
created_time string

Datum und Uhrzeit der Erstellung dieser Seite. Formatiert als ISO 8601-Datums-Uhrzeitzeichenfolge.

Zuletzt bearbeitete Zeit
last_edited_time string

Datum und Uhrzeit der Aktualisierung dieser Seite. Formatiert als ISO 8601-Datums-Uhrzeitzeichenfolge.

Id
created_by.id string

Eindeutiger Bezeichner für diesen Benutzer.

Id
last_edited_by.id string

Eindeutiger Bezeichner für diesen Benutzer.

URL
cover.url string

Verknüpfung mit dem extern gehosteten Bild.

Emoji
icon.emoji string

Emoji-Zeichen.

database_id (Datenbank-ID)
parent.database_id string

database_id (Datenbank-ID)

archiviert
archived boolean

Der archivierte Status der Seite.

URL
url string

Die URL der Seite "Konzept".

Abrufen eines Blocks

Ruft ein Block -Objekt mithilfe der angegebenen ID ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Block-ID
blockId True string

Bezeichner für den Block.

Gibt zurück

Name Pfad Typ Beschreibung
Objekt
object string

Objekt

id
id string

Bezeichner für den Block.

Erstellte Zeit
created_time date-time

Datum und Uhrzeit der Erstellung dieses Blocks.

Zuletzt bearbeitete Zeit
last_edited_time date-time

Datum und Uhrzeit der letzten Aktualisierung dieses Blocks.

Object
created_by.object string

Immer "Benutzer"

Id
created_by.id string

Eindeutiger Bezeichner für diesen Benutzer.

Object
last_edited_by.object string

Zuletzt bearbeiteter Benutzer

Id
last_edited_by.id string

Eindeutiger Bezeichner für diesen Benutzer.

Hat Kinder
has_children boolean

Gibt an, ob der Block untergeordnete Blöcke enthält, die darin geschachtelt sind.

Archived
archived boolean

Der archivierte Status des Blocks.

Typ
type string

Ein Objekt mit typspezifischen Blockinformationen

Abrufen eines Seiteneigenschaftselements

Abrufen eines Seiteneigenschaftselements

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Seiten-ID
page_id True string

Bezeichner für eine Seite "Begriff"

Eigenschaften-ID
property_id True string

Bezeichner für eine Seiteneigenschaft

Gibt zurück

Name Pfad Typ Beschreibung
Object
object string

Immer auflisten.

Hat mehr
has_more boolean

Wenn die Antwort das Ende der Liste enthält, "false". Andernfalls "true".

Abrufen von block untergeordneten Elementen

Gibt ein paginiertes Array von untergeordneten Blockobjekten zurück, die im Block enthalten sind, wobei die angegebene ID verwendet wird.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Block-ID
block_id True string

Bezeichner für einen Block

Seitenformat
page_size integer

Die Anzahl der Elemente aus der vollständigen Liste, die in der Antwort gewünscht wurde. Maximal: 100

Gibt zurück

Name Pfad Typ Beschreibung
id
items.id string

Bezeichner für den Block.

Erstellte Zeit
items.created_time date-time

Datum und Uhrzeit der Erstellung dieses Blocks.

Zuletzt bearbeitete Zeit
items.last_edited_time date-time

Datum und Uhrzeit der letzten Aktualisierung dieses Blocks.

Hat Kinder
items.has_children boolean

Gibt an, ob der Block untergeordnete Blöcke enthält, die darin geschachtelt sind.

Archived
items.archived boolean

Der archivierte Status des Blocks.

Typ
items.type string

Typ des Blocks. Mögliche Werte

Nur-Text
plain_text string

Nur-Text im Absatzblock plain_text

Nächster Cursor
next_cursor string

Ein Zurückgegebener Cursor, der zum Anfordern der nächsten Seite mit Ergebnissen verwendet wird. Behandeln Sie dies als undurchsichtigen Wert.

Hat mehr
has_more boolean

Gibt an, ob der Block mehr Blöcke enthält oder nicht.

Abrufen von Kommentaren

Ruft eine Liste nicht aufgelöster Kommentarobjekte von einer Seite oder einem Block ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Block-ID
block_id True string

Bezeichner für einen Begriffsblock oder eine Seite

Gibt zurück

Aktualisieren eines Blocks

Aktualisiert den Inhalt für die angegebene block_id basierend auf dem Blocktyp. Unterstützte Felder basierend auf dem Blockobjekttyp

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Block-ID
blockId True string

Bezeichner für einen Begriffsblock

Content
content string

Textinhalt. Dieses Feld enthält den tatsächlichen Inhalt Ihres Texts und ist wahrscheinlich das Feld, das Sie am häufigsten verwenden werden.

Farbe
color string

Farbe des Blocks.

Content
content string

Textinhalt. Dieses Feld enthält den tatsächlichen Inhalt Ihres Texts und ist wahrscheinlich das Feld, das Sie am häufigsten verwenden werden.

Farbe
color string

Farbe des Blocks.

Content
content string

Textinhalt2. Dieses Feld enthält den tatsächlichen Inhalt Ihres Texts und ist wahrscheinlich das Feld, das Sie am häufigsten verwenden werden.

Farbe
color string

Farbe des Blocks.

Content
content string

Textinhalt. Dieses Feld enthält den tatsächlichen Inhalt Ihres Texts und ist wahrscheinlich das Feld, das Sie am häufigsten verwenden werden.

Farbe
color string

Farben

Inhalt1
content string

Textinhalt. Dieses Feld enthält den tatsächlichen Inhalt Ihres Texts und ist wahrscheinlich das Feld, das Sie am häufigsten verwenden werden.

Farbe
color string

Farbe des Blocks.

Inhalt1
content string

Textinhalt. Dieses Feld enthält den tatsächlichen Inhalt Ihres Texts und ist wahrscheinlich das Feld, das Sie am häufigsten verwenden werden.

Farbe
color string

Farbe des Blocks.

Inhalt1
content string

Textinhalt. Dieses Feld enthält den tatsächlichen Inhalt Ihres Texts und ist wahrscheinlich das Feld, das Sie am häufigsten verwenden werden.

Geprüft
checked boolean

Gibt an, ob die to_do aktiviert ist oder nicht.

Farbe
color string

Farbe des Blocks.

Anfügen von untergeordneten Elementen

Erstellt und fügt neue untergeordnete Blöcke an das angegebene übergeordnete block_id an.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Block-ID
block_id True string

Bezeichner für einen Block

Objekt
object string

Objekt

type
type string

type

type
type string

type

Inhalt
content string

Inhalt

type
type string

type

Inhalt
content string

Inhalt

URL
url string

URL

Benutzer abrufen

Ruft einen Benutzer mithilfe der angegebenen ID ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Benutzer-ID
user_id True string

Eindeutiger Bezeichner für diesen Benutzer.

Gibt zurück

Name Pfad Typ Beschreibung
Id
id string

Bezeichner für einen Begriffsbenutzer

Benutzername
name string

Name des Benutzers

Avatar-URL
avatar_url string

Ausgewähltes Avatarbild

Email
email string

E-Mail-Adresse der Person.

Erstellen einer Seite

Erstellt eine neue Seite in der angegebenen Datenbank. vorhandene Seite.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Datenbank-ID
database_id True string

Eindeutiger Bezeichner für die Datenbank.

Emoji
emoji string

Emoji

Deckblatt-URL
url string

Seitendeckblattbild-URL.

Eigenschaften
properties object

Schema der Eigenschaften für die Datenbank, wie sie in "Konzept" angezeigt werden.

Gibt zurück

Name Pfad Typ Beschreibung
Id
id string

Eindeutiger Bezeichner der Seite.

Erstellte Zeit
created_time string

Datum und Uhrzeit der Erstellung dieser Seite. Formatiert als ISO 8601-Datums-Uhrzeitzeichenfolge.

Zuletzt bearbeitete Zeit
last_edited_time string

Datum und Uhrzeit der Aktualisierung dieser Seite. Formatiert als ISO 8601-Datums-Uhrzeitzeichenfolge.

Id
created_by.id string

Eindeutiger Bezeichner für diesen Benutzer.

Id
last_edited_by.id string

Eindeutiger Bezeichner für diesen Benutzer.

URL
cover.url string

Verknüpfung mit dem extern gehosteten Bild.

Emoji
icon.emoji string

Emoji-Zeichen.

database_id (Datenbank-ID)
parent.database_id string

database_id (Datenbank-ID)

archiviert
archived boolean

Der archivierte Status der Seite.

URL
url string

Die URL der Seite "Konzept".

Kommentar erstellen

Erstellt einen Kommentar auf einer Seite oder in einem vorhandenen Diskussionsthread.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Seiten-ID
page_id string

Bezeichner für eine Seite

Diskussions-ID
discussion_id string

Bezeichner für einen Begriffsblock

Content
content string

Textinhalt. Dieses Feld enthält den tatsächlichen Inhalt Ihres Texts und ist wahrscheinlich das Feld, das Sie am häufigsten verwenden werden.

Gibt zurück

Liste aller Benutzer

Gibt eine paginierte Liste der Benutzer für den Arbeitsbereich zurück.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Seitenformat
page_size integer

Die Anzahl der Elemente aus der vollständigen Liste, die in der Antwort gewünscht wurde. Maximal: 100

Gibt zurück

Name Pfad Typ Beschreibung
Id
id string

Bezeichner für einen Begriffsblock

Anzeigename
name string

Der Name des Benutzers, der in "Begriff" angezeigt wird.

Avatar-URL
avatar_url string

Ausgewähltes Avatarbild.

Typ
type string

Typ des Benutzers. Mögliche Werte sind "person" und "bot".

Email
email string

E-Mail-Adresse der Person.

Nächster Cursor
next_cursor string

Ein Zurückgegebener Cursor, der zum Anfordern der nächsten Seite mit Ergebnissen verwendet wird. Behandeln Sie dies als undurchsichtigen Wert.

Hat mehr
has_more boolean

Wenn die Antwort das Ende der Liste enthält

Löschen eines Blocks

Legt ein Block -Objekt, einschließlich Seitenblöcke, auf archiviert fest: true mithilfe der angegebenen ID. Hinweis: In der Anwendung "Notion UI" verschiebt dies den Block in den "Papierkorb", auf den weiterhin zugegriffen und wiederhergestellt werden kann.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Block-ID
blockId True string

Bezeichner für einen Begriffsblock

Gibt zurück

Name Pfad Typ Beschreibung
id
id string

Bezeichner für den Block.

Erstellte Zeit
created_time date-time

Datum und Uhrzeit der Erstellung dieses Blocks.

Zuletzt bearbeitete Zeit
last_edited_time date-time

Datum und Uhrzeit der letzten Aktualisierung dieses Blocks.

Object
created_by.object string

Immer "Benutzer"

Id
created_by.id string

Eindeutiger Bezeichner für diesen Benutzer.

Object
last_edited_by.object string

Zuletzt bearbeiteter Benutzer

Id
last_edited_by.id string

Eindeutiger Bezeichner für diesen Benutzer.

Hat Kinder
has_children boolean

Gibt an, ob der Block untergeordnete Blöcke enthält, die darin geschachtelt sind.

Archived
archived boolean

Der archivierte Status des Blocks.

Typ
type string

Ein Objekt mit typspezifischen Blockinformationen

Suche

Durchsucht alle Seiten und untergeordneten Seiten, die für die Integration freigegeben sind. Die Ergebnisse können Datenbanken enthalten.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Query
query True string

Wenn angegeben, schränkt ein, welche Seiten zurückgegeben werden, indem die Abfrage mit dem Seitentitel verglichen wird.

Richtung
direction string

Die Sortierrichtung. Mögliche Werte sind aufsteigend und absteigend.

Zeitstempel
timestamp string

Der Name des Zeitstempels, nach dem sortiert werden soll. Mögliche Werte sind last_edited_time.

Gibt zurück

Name Pfad Typ Beschreibung
id
id string

Bezeichner für den Block.

Erstellte Zeit
created_time string

Datum und Uhrzeit der Erstellung dieser Seite.

Zuletzt bearbeitete Zeit
last_edited_time string

Datum und Uhrzeit der Aktualisierung dieser Seite.

Nur-Text
plain_text string

Der Nur-Text ohne Anmerkungen.

Stichwörter
Tags object

Das Tags-Objekt enthält die Liste der Tags.

URL
url string

Die URL des Objekts.

Nächster Cursor
next_cursor string

Ein Zurückgegebener Cursor, der zum Anfordern der nächsten Seite mit Ergebnissen verwendet wird. Behandeln Sie dies als undurchsichtigen Wert.

Hat mehr
has_more boolean

Gibt an, ob der Block mehr Blöcke enthält oder nicht.

Definitionen

CommentResponse

Name Pfad Typ Beschreibung
Id
id string

Eindeutiger Bezeichner des Kommentars.

Seiten-ID
parent.page_id string

Die ID der Seite, zu der diese Seite gehört.

Diskussions-ID
discussion_id string

Eindeutiger Bezeichner des Diskussionsthreads, dem der Kommentar zugeordnet ist.

Erstellte Zeit
created_time string

Datum und Uhrzeit der Erstellung dieses Kommentars.

Zuletzt bearbeitete Zeit
last_edited_time string

Datum und Uhrzeit der Aktualisierung dieses Kommentars.

Objekt
created_by.object string

Objekt

id
created_by.id string

id

Rich-Text
rich_text array of object

Inhalt des Kommentars, der Rich-Text-Formatierung, Links und Erwähnungen unterstützt.

type
rich_text.type string

type

Content
rich_text.text.content string

Textinhalt.

Link
rich_text.text.link string

Jeder Inlinelink in diesem Text.

Nur-Text
rich_text.plain_text string

Der Nur-Text ohne Anmerkungen.

href
rich_text.href string

(optional) Die URL eines Links oder einer internen Begriffs-Erwähnung in diesem Text, falls vorhanden.

DatabaseResponse

Name Pfad Typ Beschreibung
results
results array of object
Object
results.object string

Seite oder 'Datenbank'

Id
results.id string

Eindeutiger Bezeichner für die Datenbank.

Erstellte Zeit
results.created_time string

Datum und Uhrzeit der Erstellung dieser Datenbank. Formatiert als ISO 8601-Datums-Uhrzeitzeichenfolge.

Zuletzt bearbeitete Zeit
results.last_edited_time string

Datum und Uhrzeit der Aktualisierung dieser Datenbank. Formatiert als ISO 8601-Datums-Uhrzeitzeichenfolge.

Object
results.created_by.object string

Benutzer, der die Datenbank erstellt hat.

Id
results.created_by.id string

Eindeutiger Bezeichner für den Benutzer

Object
results.last_edited_by.object string

Benutzer, der die Datenbank erstellt hat.

Id
results.last_edited_by.id string

Eindeutiger Bezeichner für den Benutzer

Archived
results.archived boolean

Der archivierte Status der Datenbank.

URL
results.url string

Die URL der Begriffsdatenbank