Notion (niezależny wydawca)
Łącznik pojęć używa interfejsu API do uzyskiwania dostępu do stron, baz danych i użytkowników pojęcia.
Ten łącznik jest dostępny w następujących produktach i regionach:
| Usługa | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps z wyjątkiem następujących: — Regiony platformy Azure Government — Regiony platformy Azure (Chiny) - Departament Obrony USA (DoD) |
| Power Apps | Premium | Wszystkie regiony usługi Power Apps z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Power Automate | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Kontakt | |
|---|---|
| Name | Chandra Sekhar & Harshini Varma |
| adres URL | https://github.com/sekharmalla |
| chandra.malla@msftcommunity.com |
| Metadane łącznika | |
|---|---|
| Publisher | Chandra Sekhar & Harshini Varma |
| Witryna internetowa | https://www.notion.so/ |
| Zasady ochrony prywatności | https://www.notion.so/Privacy-Policy-3468d120cf614d4c9014c09f6adc9091 |
| Kategorie | Produktywność; kolaboracja |
Tworzenie połączenia
Łącznik obsługuje następujące typy uwierzytelniania:
| Wartość domyślna | Parametry tworzenia połączenia. | Wszystkie regiony | Nie można udostępniać |
Domyślny
Dotyczy: wszystkie regiony
Parametry tworzenia połączenia.
Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.
| Name | Typ | Description | Wymagane |
|---|---|---|---|
| Klucz interfejsu API | securestring | Klucz interfejsu API dla tego interfejsu API | Prawda |
Limity ograniczania
| Nazwa | Wywołania | Okres odnowienia |
|---|---|---|
| Wywołania interfejsu API na połączenie | 100 | 60 sekund |
Akcje
| Aktualizowanie bloku |
Aktualizuje zawartość określonego block_id na podstawie typu bloku. Obsługiwane pola oparte na typie obiektu bloku |
| Dołączanie elementów podrzędnych bloków |
Tworzy i dołącza nowe bloki podrzędne do określonego block_id nadrzędnego. |
| Lista wszystkich użytkowników |
Zwraca listę użytkowników z podziałem na strony dla obszaru roboczego |
| Pobieranie bazy danych |
Pobiera obiekt Bazy danych przy użyciu określonego identyfikatora. |
| Pobieranie bloku |
Pobiera obiekt Blokuj przy użyciu określonego identyfikatora. |
| Pobieranie elementu właściwości strony |
Pobieranie elementu właściwości strony |
| Pobieranie elementów podrzędnych bloków |
Zwraca tablicę z podziałem na strony obiektów blokowych podrzędnych zawartych w bloku przy użyciu określonego identyfikatora |
| Pobieranie komentarzy |
Pobiera listę nieuznanych obiektów komentarza ze strony lub bloku. |
| Pobieranie strony |
Pobiera obiekt Page przy użyciu określonego identyfikatora. |
| Pobieranie użytkownika |
Pobiera użytkownika przy użyciu określonego identyfikatora. |
| Pobieranie użytkownika bota tokenu |
Pobiera bota Użytkownika skojarzonego z tokenem interfejsu API podanym w nagłówku autoryzacji. Bot będzie miał pole właściciela z informacjami o osobie, która autoryzował integrację. |
| Search |
Wyszukuje wszystkie strony i strony podrzędne, które są współużytkowane z integracją. Wyniki mogą obejmować bazy danych. |
| Tworzenie komentarza |
Tworzy komentarz na stronie lub w istniejącym wątku dyskusji. |
| Tworzenie strony |
Tworzy nową stronę w określonej bazie danych. istniejąca strona. |
| Usuwanie bloku |
Ustawia obiekt Blokuj, w tym bloki stron, na zarchiwizowane: true przy użyciu określonego identyfikatora. Uwaga: w aplikacji Interfejs użytkownika pojęcia spowoduje to przeniesienie bloku do kosza, do którego nadal można uzyskać dostęp i przywrócić. |
| Wykonywanie zapytań względem bazy danych |
Pobiera listę stron zawartych w bazie danych, filtrowanych i uporządkowanych zgodnie z warunkami filtrowania i kryteriami sortowania podanymi w żądaniu. |
Aktualizowanie bloku
Aktualizuje zawartość określonego block_id na podstawie typu bloku. Obsługiwane pola oparte na typie obiektu bloku
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator bloku
|
blockId | True | string |
Identyfikator bloku pojęć |
|
Content
|
content | string |
Zawartość tekstowa. To pole zawiera rzeczywistą zawartość tekstu i jest prawdopodobnie polem, którego będziesz używać najczęściej. |
|
|
Kolor
|
color | string |
Kolor bloku. |
|
|
Content
|
content | string |
Zawartość tekstowa. To pole zawiera rzeczywistą zawartość tekstu i jest prawdopodobnie polem, którego będziesz używać najczęściej. |
|
|
Kolor
|
color | string |
Kolor bloku. |
|
|
Content
|
content | string |
Zawartość tekstowa2. To pole zawiera rzeczywistą zawartość tekstu i jest prawdopodobnie polem, którego będziesz używać najczęściej. |
|
|
Kolor
|
color | string |
Kolor bloku. |
|
|
Content
|
content | string |
Zawartość tekstowa. To pole zawiera rzeczywistą zawartość tekstu i jest prawdopodobnie polem, którego będziesz używać najczęściej. |
|
|
Kolor
|
color | string |
Kolory |
|
|
Zawartość1
|
content | string |
Zawartość tekstowa. To pole zawiera rzeczywistą zawartość tekstu i jest prawdopodobnie polem, którego będziesz używać najczęściej. |
|
|
Kolor
|
color | string |
Kolor bloku. |
|
|
Zawartość1
|
content | string |
Zawartość tekstowa. To pole zawiera rzeczywistą zawartość tekstu i jest prawdopodobnie polem, którego będziesz używać najczęściej. |
|
|
Kolor
|
color | string |
Kolor bloku. |
|
|
Zawartość1
|
content | string |
Zawartość tekstowa. To pole zawiera rzeczywistą zawartość tekstu i jest prawdopodobnie polem, którego będziesz używać najczęściej. |
|
|
Sprawdzane
|
checked | boolean |
Czy to_do jest sprawdzana, czy nie. |
|
|
Kolor
|
color | string |
Kolor bloku. |
Dołączanie elementów podrzędnych bloków
Tworzy i dołącza nowe bloki podrzędne do określonego block_id nadrzędnego.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator bloku
|
block_id | True | string |
Identyfikator bloku |
|
obiekt
|
object | string |
obiekt |
|
|
typ
|
type | string |
typ |
|
|
typ
|
type | string |
typ |
|
|
zawartość
|
content | string |
zawartość |
|
|
typ
|
type | string |
typ |
|
|
zawartość
|
content | string |
zawartość |
|
|
URL
|
url | string |
URL |
Lista wszystkich użytkowników
Zwraca listę użytkowników z podziałem na strony dla obszaru roboczego
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Rozmiar strony
|
page_size | integer |
Liczba elementów z pełnej listy żądanej w odpowiedzi. Maksimum: 100 |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Id
|
id | string |
Identyfikator bloku pojęć |
|
Wyświetlana nazwa
|
name | string |
Nazwa użytkownika wyświetlana w obszarze Pojęcie. |
|
Adres URL awatara
|
avatar_url | string |
Wybrany obraz awatara. |
|
Typ
|
type | string |
Typ użytkownika. Możliwe wartości to "person" i "bot". |
|
Email
|
string |
Adres e-mail osoby. |
|
|
Następny kursor
|
next_cursor | string |
Kursor zwrócony do żądania następnej strony wyników. Traktuj to jako nieprzezroczystą wartość |
|
Ma więcej
|
has_more | boolean |
Gdy odpowiedź zawiera koniec listy |
Pobieranie bazy danych
Pobiera obiekt Bazy danych przy użyciu określonego identyfikatora.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator bazy danych
|
database_id | True | string |
Identyfikator bazy danych Pojęć |
Zwraca
- Body
- DatabaseResponse
Pobieranie bloku
Pobiera obiekt Blokuj przy użyciu określonego identyfikatora.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator bloku
|
blockId | True | string |
Identyfikator bloku. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
obiekt
|
object | string |
obiekt |
|
id
|
id | string |
Identyfikator bloku. |
|
Czas utworzenia
|
created_time | date-time |
Data i godzina utworzenia tego bloku. |
|
Czas ostatniej edycji
|
last_edited_time | date-time |
Data i godzina ostatniej aktualizacji tego bloku. |
|
Object
|
created_by.object | string |
Zawsze "użytkownik" |
|
Id
|
created_by.id | string |
Unikatowy identyfikator tego użytkownika. |
|
Object
|
last_edited_by.object | string |
Ostatni edytowany użytkownik |
|
Id
|
last_edited_by.id | string |
Unikatowy identyfikator tego użytkownika. |
|
Ma elementy podrzędne
|
has_children | boolean |
Niezależnie od tego, czy blok zawiera bloki podrzędne zagnieżdżone w nim. |
|
Archiwizowane
|
archived | boolean |
Zarchiwizowany stan bloku. |
|
Typ
|
type | string |
Obiekt zawierający informacje o bloku specyficznym dla typu |
Pobieranie elementu właściwości strony
Pobieranie elementu właściwości strony
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator strony
|
page_id | True | string |
Identyfikator strony Pojęcia |
|
Identyfikator właściwości
|
property_id | True | string |
Identyfikator właściwości strony |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Object
|
object | string |
Zawsze wyświetlaj listę. |
|
Ma więcej
|
has_more | boolean |
Gdy odpowiedź zawiera koniec listy, false. W przeciwnym razie wartość true. |
Pobieranie elementów podrzędnych bloków
Zwraca tablicę z podziałem na strony obiektów blokowych podrzędnych zawartych w bloku przy użyciu określonego identyfikatora
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator bloku
|
block_id | True | string |
Identyfikator bloku |
|
Rozmiar strony
|
page_size | integer |
Liczba elementów z pełnej listy żądanej w odpowiedzi. Maksimum: 100 |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
id
|
items.id | string |
Identyfikator bloku. |
|
Czas utworzenia
|
items.created_time | date-time |
Data i godzina utworzenia tego bloku. |
|
Czas ostatniej edycji
|
items.last_edited_time | date-time |
Data i godzina ostatniej aktualizacji tego bloku. |
|
Ma elementy podrzędne
|
items.has_children | boolean |
Niezależnie od tego, czy blok zawiera bloki podrzędne zagnieżdżone w nim. |
|
Archiwizowane
|
items.archived | boolean |
Zarchiwizowany stan bloku. |
|
Typ
|
items.type | string |
Typ bloku. Możliwe wartości |
|
Zwykły tekst
|
plain_text | string |
Zwykły tekst w bloku akapitu plain_text |
|
Następny kursor
|
next_cursor | string |
Kursor zwrócony do żądania następnej strony wyników. Traktuj to jako nieprzezroczystą wartość |
|
Ma więcej
|
has_more | boolean |
Czy blok ma więcej bloków, czy nie |
Pobieranie komentarzy
Pobiera listę nieuznanych obiektów komentarza ze strony lub bloku.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator bloku
|
block_id | True | string |
Identyfikator bloku pojęcia lub strony |
Zwraca
- Body
- CommentResponse
Pobieranie strony
Pobiera obiekt Page przy użyciu określonego identyfikatora.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator strony
|
page_id | True | string |
Identyfikator strony Pojęcia |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Id
|
id | string |
Unikatowy identyfikator strony. |
|
Czas utworzenia
|
created_time | string |
Data i godzina utworzenia tej strony. Sformatowany jako ciąg daty ISO 8601. |
|
Czas ostatniej edycji
|
last_edited_time | string |
Data i godzina aktualizacji tej strony. Sformatowany jako ciąg daty ISO 8601. |
|
Id
|
created_by.id | string |
Unikatowy identyfikator tego użytkownika. |
|
Id
|
last_edited_by.id | string |
Unikatowy identyfikator tego użytkownika. |
|
URL
|
cover.url | string |
Łącze do obrazu hostowanego zewnętrznie. |
|
emoji
|
icon.emoji | string |
Znak emoji. |
|
id_bazy_danych
|
parent.database_id | string |
id_bazy_danych |
|
Archiwizowane
|
archived | boolean |
Zarchiwizowany stan strony. |
|
adres URL
|
url | string |
Adres URL strony Pojęcie. |
Pobieranie użytkownika
Pobiera użytkownika przy użyciu określonego identyfikatora.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator użytkownika
|
user_id | True | string |
Unikatowy identyfikator tego użytkownika. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Id
|
id | string |
Identyfikator użytkownika pojęcia |
|
Nazwa użytkownika
|
name | string |
Nazwa użytkownika |
|
Adres URL awatara
|
avatar_url | string |
Obraz wybranego awatara |
|
Email
|
string |
Adres e-mail osoby. |
Pobieranie użytkownika bota tokenu
Pobiera bota Użytkownika skojarzonego z tokenem interfejsu API podanym w nagłówku autoryzacji. Bot będzie miał pole właściciela z informacjami o osobie, która autoryzował integrację.
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Id
|
id | string |
Unikatowy identyfikator tego użytkownika. |
|
Name
|
name | string |
Nazwa użytkownika wyświetlana w obszarze Pojęcie. |
|
Adres URL awatara
|
avatar_url | string |
Wybrany obraz awatara. |
|
Typ
|
type | string |
Typ użytkownika. Możliwe wartości to "person" i "bot". |
|
Typ właściciela
|
bot.owner.type | string |
Typ właściciela — "obszar roboczy" lub "użytkownik". |
Search
Wyszukuje wszystkie strony i strony podrzędne, które są współużytkowane z integracją. Wyniki mogą obejmować bazy danych.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Query
|
query | True | string |
Po podaniu limity, które strony są zwracane przez porównanie zapytania z tytułem strony. |
|
Direction
|
direction | string |
Kierunek sortowania. Możliwe wartości obejmują rosnąco i malejąco. |
|
|
Sygnatura czasowa
|
timestamp | string |
Nazwa znacznika czasu do sortowania. Możliwe wartości obejmują last_edited_time. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
id
|
id | string |
Identyfikator bloku. |
|
Czas utworzenia
|
created_time | string |
Data i godzina utworzenia tej strony. |
|
Czas ostatniej edycji
|
last_edited_time | string |
Data i godzina aktualizacji tej strony. |
|
Zwykły tekst
|
plain_text | string |
Zwykły tekst bez adnotacji. |
|
Etykiety
|
Tags | object |
Obiekt tags zawiera listę tagów. |
|
adres URL
|
url | string |
Adres URL obiektu. |
|
Następny kursor
|
next_cursor | string |
Kursor zwrócony do żądania następnej strony wyników. Traktuj to jako nieprzezroczystą wartość |
|
Ma więcej
|
has_more | boolean |
Czy blok ma więcej bloków, czy nie |
Tworzenie komentarza
Tworzy komentarz na stronie lub w istniejącym wątku dyskusji.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator strony
|
page_id | string |
Identyfikator strony |
|
|
Identyfikator dyskusji
|
discussion_id | string |
Identyfikator bloku pojęć |
|
|
Content
|
content | string |
Zawartość tekstowa. To pole zawiera rzeczywistą zawartość tekstu i jest prawdopodobnie polem, którego będziesz używać najczęściej. |
Zwraca
- Body
- CommentResponse
Tworzenie strony
Tworzy nową stronę w określonej bazie danych. istniejąca strona.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator bazy danych
|
database_id | True | string |
Unikatowy identyfikator bazy danych. |
|
Emoji
|
emoji | string |
emoji |
|
|
Adres URL okładki
|
url | string |
Adres URL obrazu okładki strony. |
|
|
Właściwości
|
properties | object |
Schemat właściwości bazy danych wyświetlany w obszarze Pojęcie. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Id
|
id | string |
Unikatowy identyfikator strony. |
|
Czas utworzenia
|
created_time | string |
Data i godzina utworzenia tej strony. Sformatowany jako ciąg daty ISO 8601. |
|
Czas ostatniej edycji
|
last_edited_time | string |
Data i godzina aktualizacji tej strony. Sformatowany jako ciąg daty ISO 8601. |
|
Id
|
created_by.id | string |
Unikatowy identyfikator tego użytkownika. |
|
Id
|
last_edited_by.id | string |
Unikatowy identyfikator tego użytkownika. |
|
URL
|
cover.url | string |
Łącze do obrazu hostowanego zewnętrznie. |
|
emoji
|
icon.emoji | string |
Znak emoji. |
|
id_bazy_danych
|
parent.database_id | string |
id_bazy_danych |
|
Archiwizowane
|
archived | boolean |
Zarchiwizowany stan strony. |
|
adres URL
|
url | string |
Adres URL strony Pojęcie. |
Usuwanie bloku
Ustawia obiekt Blokuj, w tym bloki stron, na zarchiwizowane: true przy użyciu określonego identyfikatora. Uwaga: w aplikacji Interfejs użytkownika pojęcia spowoduje to przeniesienie bloku do kosza, do którego nadal można uzyskać dostęp i przywrócić.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator bloku
|
blockId | True | string |
Identyfikator bloku pojęć |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
id
|
id | string |
Identyfikator bloku. |
|
Czas utworzenia
|
created_time | date-time |
Data i godzina utworzenia tego bloku. |
|
Czas ostatniej edycji
|
last_edited_time | date-time |
Data i godzina ostatniej aktualizacji tego bloku. |
|
Object
|
created_by.object | string |
Zawsze "użytkownik" |
|
Id
|
created_by.id | string |
Unikatowy identyfikator tego użytkownika. |
|
Object
|
last_edited_by.object | string |
Ostatni edytowany użytkownik |
|
Id
|
last_edited_by.id | string |
Unikatowy identyfikator tego użytkownika. |
|
Ma elementy podrzędne
|
has_children | boolean |
Niezależnie od tego, czy blok zawiera bloki podrzędne zagnieżdżone w nim. |
|
Archiwizowane
|
archived | boolean |
Zarchiwizowany stan bloku. |
|
Typ
|
type | string |
Obiekt zawierający informacje o bloku specyficznym dla typu |
Wykonywanie zapytań względem bazy danych
Pobiera listę stron zawartych w bazie danych, filtrowanych i uporządkowanych zgodnie z warunkami filtrowania i kryteriami sortowania podanymi w żądaniu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator bazy danych
|
database_id | True | string |
Identyfikator bazy danych Pojęć. |
Zwraca
- Body
- DatabaseResponse
Definicje
KomentarzResponse
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Id
|
id | string |
Unikatowy identyfikator komentarza. |
|
Identyfikator strony
|
parent.page_id | string |
Identyfikator strony, do którego należy ta strona. |
|
Identyfikator dyskusji
|
discussion_id | string |
Unikatowy identyfikator wątku dyskusji, z którą jest skojarzony komentarz. |
|
Czas utworzenia
|
created_time | string |
Data i godzina utworzenia tego komentarza. |
|
Czas ostatniej edycji
|
last_edited_time | string |
Data i godzina aktualizacji tego komentarza. |
|
obiekt
|
created_by.object | string |
obiekt |
|
id
|
created_by.id | string |
id |
|
Tekst sformatowany
|
rich_text | array of object |
Zawartość komentarza, która obsługuje formatowanie tekstu sformatowanego, linki i wzmianki. |
|
typ
|
rich_text.type | string |
typ |
|
Content
|
rich_text.text.content | string |
Zawartość tekstowa. |
|
Link
|
rich_text.text.link | string |
Dowolny link wbudowany w tym tekście. |
|
Zwykły tekst
|
rich_text.plain_text | string |
Zwykły tekst bez adnotacji. |
|
href
|
rich_text.href | string |
(opcjonalnie) Adres URL dowolnego linku lub wewnętrznych wzmianek pojęć w tym tekście, jeśli istnieje. |
DatabaseResponse
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
results
|
results | array of object | |
|
Object
|
results.object | string |
Strona lub baza danych |
|
Id
|
results.id | string |
Unikatowy identyfikator bazy danych. |
|
Czas utworzenia
|
results.created_time | string |
Data i godzina utworzenia tej bazy danych. Sformatowany jako ciąg daty ISO 8601. |
|
Czas ostatniej edycji
|
results.last_edited_time | string |
Data i godzina aktualizacji tej bazy danych. Sformatowany jako ciąg daty ISO 8601. |
|
Object
|
results.created_by.object | string |
Użytkownik, który utworzył bazę danych. |
|
Id
|
results.created_by.id | string |
Unikatowy identyfikator użytkownika |
|
Object
|
results.last_edited_by.object | string |
Użytkownik, który utworzył bazę danych. |
|
Id
|
results.last_edited_by.id | string |
Unikatowy identyfikator użytkownika |
|
Archiwizowane
|
results.archived | boolean |
Zarchiwizowany stan bazy danych. |
|
adres URL
|
results.url | string |
Adres URL bazy danych Pojęć |