Aracılığıyla paylaş

Notion (Bağımsız Yayımcı)

Notion bağlayıcısı, Notion'un sayfalarına, veritabanlarına ve kullanıcılarına erişmek için API'yi kullanır.

Bu bağlayıcı aşağıdaki ürün ve bölgelerde kullanılabilir:

Hizmet Class Bölgeler
Copilot Studio Premium Aşağıdakiler dışında tüm Power Automate bölgeleri :
     - ABD Kamu (GCC)
     - US Government (GCC High)
     - 21Vianet tarafından işletilen Çin Bulutu
     - ABD Savunma Bakanlığı (DoD)
Logic Apps Standart Aşağıdakiler dışında tüm Logic Apps bölgeleri :
     - Azure Kamu bölgeleri
     - Azure Çin bölgeleri
     - ABD Savunma Bakanlığı (DoD)
Power Apps Premium Aşağıdakiler dışında tüm Power Apps bölgeleri :
     - ABD Kamu (GCC)
     - US Government (GCC High)
     - 21Vianet tarafından işletilen Çin Bulutu
     - ABD Savunma Bakanlığı (DoD)
Power Automate Premium Aşağıdakiler dışında tüm Power Automate bölgeleri :
     - ABD Kamu (GCC)
     - US Government (GCC High)
     - 21Vianet tarafından işletilen Çin Bulutu
     - ABD Savunma Bakanlığı (DoD)
İletişim
İsim Chandra Sekhar & Harshini Varma
URL https://github.com/sekharmalla
E-posta chandra.malla@msftcommunity.com
Bağlayıcı Meta Verileri
Publisher Chandra Sekhar & Harshini Varma
Web sitesi https://www.notion.so/
Gizlilik ilkesi https://www.notion.so/Privacy-Policy-3468d120cf614d4c9014c09f6adc9091
Kategoriler Verimli -lik; Işbirliği

Bağlantı oluşturma

Bağlayıcı aşağıdaki kimlik doğrulama türlerini destekler:
Varsayılan Bağlantı oluşturmak için parametreler. Tüm bölgeler Paylaşılamaz

Temerrüt

Geçerli: Tüm bölgeler

Bağlantı oluşturmak için parametreler.

Bu, paylaşılabilir bir bağlantı değildir. Power app başka bir kullanıcıyla paylaşılıyorsa, başka bir kullanıcıdan açıkça yeni bağlantı oluşturması istenir.

İsim Türü Description Gerekli
API Anahtarı securestring Bu API için API Anahtarı Doğru

Azaltma Sınırları

Name Çağrılar Yenileme Dönemi
Bağlantı başına API çağrıları 100 60 saniye

Eylemler

Açıklama oluşturma

Sayfada veya mevcut tartışma yazışmasında açıklama oluşturur.
Açıklamaları alma

Bir sayfadan veya bloktan çözümlenmemiş Açıklama nesnelerinin listesini alır.
Belirtecin bot kullanıcısını alma

Yetkilendirme üst bilgisinde sağlanan API belirteci ile ilişkilendirilmiş bot Kullanıcısını alır. Bot, tümleştirmeyi yetkilendiren kişi hakkında bilgi içeren bir sahip alanına sahip olur.
Bir bloğu güncelleştirme

Belirtilen block_id içeriğini blok türüne göre güncelleştirir. Blok nesnesi türüne göre desteklenen alanlar
Blok alma

Belirtilen kimliği kullanarak bir Block nesnesi alır.
Blok alt öğelerini alma

Belirtilen kimliği kullanarak blokta yer alan alt blok nesnelerinin sayfalandırılmış dizisini döndürür
Blok alt öğelerini ekleme

Yeni alt blokları oluşturur ve belirtilen üst block_id ekler.
Blok silme

Belirtilen kimliği kullanarak sayfa blokları da dahil olmak üzere bir Block nesnesini arşivlenmiş: true olarak ayarlar. Not: Notion UI uygulamasında bu, bloğu hala erişilebilen ve geri yüklenebilen "Çöp Kutusu"na taşır.
Kullanıcı Al

Belirtilen kimliği kullanarak bir Kullanıcı alır.
Sayfa alma

Belirtilen kimliği kullanarak bir Page nesnesi alır.
Sayfa oluşturma

Belirtilen veritabanında yeni bir sayfa oluşturur. var olan sayfayı seçin.
Sayfa özellik öğesini alma

Sayfa özellik öğesini alma
Search

Tümleştirmeyle paylaşılan tüm sayfaları ve alt sayfaları arar. Sonuçlar veritabanlarını içerebilir.
Tüm kullanıcıların listesi

Çalışma alanı için sayfalandırılmış bir Kullanıcı listesi döndürür
Veritabanı alma

Belirtilen kimliği kullanarak bir Veritabanı nesnesi alır.
Veritabanını sorgulama

veritabanında bulunan sayfaların listesini alır, istekte sağlanan filtre koşullarına ve sıralama ölçütlerine göre filtrelenir ve sıralanır.

Açıklama oluşturma

İşlem Kimliği:
Createcomment

Sayfada veya mevcut tartışma yazışmasında açıklama oluşturur.

Parametreler

Name Anahtar Gerekli Tür Description
Sayfa Kimliği
 page_id string

Sayfanın tanımlayıcısı
Tartışma Kimliği
 discussion_id string

Notion bloğu tanımlayıcısı
Content
 content string

Metin içeriği. Bu alan, metninizin gerçek içeriğini içerir ve büyük olasılıkla en sık kullanacağınız alandır.

Döndürülenler

Body
CommentResponse

Açıklamaları alma

İşlem Kimliği:
Retrievecomments

Bir sayfadan veya bloktan çözümlenmemiş Açıklama nesnelerinin listesini alır.

Parametreler

Name Anahtar Gerekli Tür Description
Blok Kimliği
 block_id True string

Notion bloğunun veya sayfasının tanımlayıcısı

Döndürülenler

Body
CommentResponse

Belirtecin bot kullanıcısını alma

İşlem Kimliği:
RetrieveYourTokensBotUser

Yetkilendirme üst bilgisinde sağlanan API belirteci ile ilişkilendirilmiş bot Kullanıcısını alır. Bot, tümleştirmeyi yetkilendiren kişi hakkında bilgi içeren bir sahip alanına sahip olur.

Döndürülenler

Name Yol Tür Description
Kimlik
 id string

Bu kullanıcı için benzersiz tanımlayıcı.
İsim
 name string

Notion'da görüntülenen kullanıcı adı.
Avatar url'si
 avatar_url string

Seçili avatar resmi.
Türü
 type string

Kullanıcının türü. Olası değerler "kişi" ve "bot" şeklindedir.
Sahip türü
 bot.owner.type string

Sahip türü : "çalışma alanı" veya "kullanıcı".

Bir bloğu güncelleştirme

İşlem Kimliği:
Updateablock

Belirtilen block_id içeriğini blok türüne göre güncelleştirir. Blok nesnesi türüne göre desteklenen alanlar

Parametreler

Name Anahtar Gerekli Tür Description
Blok Kimliği
 blockId True string

Notion bloğu tanımlayıcısı
Content
 content string

Metin içeriği. Bu alan, metninizin gerçek içeriğini içerir ve büyük olasılıkla en sık kullanacağınız alandır.
Renk
 color string

Bloğun rengi.
Content
 content string

Metin içeriği. Bu alan, metninizin gerçek içeriğini içerir ve büyük olasılıkla en sık kullanacağınız alandır.
Renk
 color string

Bloğun rengi.
Content
 content string

Metin içeriği2. Bu alan, metninizin gerçek içeriğini içerir ve büyük olasılıkla en sık kullanacağınız alandır.
Renk
 color string

Bloğun rengi.
Content
 content string

Metin içeriği. Bu alan, metninizin gerçek içeriğini içerir ve büyük olasılıkla en sık kullanacağınız alandır.
Renk
 color string

Renk
İçindekiler1
 content string

Metin içeriği. Bu alan, metninizin gerçek içeriğini içerir ve büyük olasılıkla en sık kullanacağınız alandır.
Renk
 color string

Bloğun rengi.
İçindekiler1
 content string

Metin içeriği. Bu alan, metninizin gerçek içeriğini içerir ve büyük olasılıkla en sık kullanacağınız alandır.
Renk
 color string

Bloğun rengi.
İçindekiler1
 content string

Metin içeriği. Bu alan, metninizin gerçek içeriğini içerir ve büyük olasılıkla en sık kullanacağınız alandır.
Kontrol edildi
 checked boolean

to_do denetlenip denetlenmediği.
Renk
 color string

Bloğun rengi.

Blok alma

İşlem Kimliği:
Retrieveablock

Belirtilen kimliği kullanarak bir Block nesnesi alır.

Parametreler

Name Anahtar Gerekli Tür Description
Blok Kimliği
 blockId True string

Bloğun tanımlayıcısı.

Döndürülenler

Name Yol Tür Description
object
 object string

object
kimlik
 id string

Bloğun tanımlayıcısı.
Yaratılış zamanı
 created_time date-time

Bu bloğun oluşturulduğu tarih ve saat.
Son düzenleme zamanı
 last_edited_time date-time

Bu bloğun en son güncelleştirildiği tarih ve saat.
Nesne
 created_by.object string

Her zaman "kullanıcı"
Kimlik
 created_by.id string

Bu kullanıcı için benzersiz tanımlayıcı.
Nesne
 last_edited_by.object string

Son düzenlenen kullanıcı
Kimlik
 last_edited_by.id string

Bu kullanıcı için benzersiz tanımlayıcı.
Çocukları var
 has_children boolean

Bloğun içinde alt bloklar olup olmadığı.
Arşivlenmiş
 archived boolean

Bloğun arşivlenmiş durumu.
Türü
 type string

Türe özgü blok bilgilerini içeren bir nesne

Blok alt öğelerini alma

İşlem Kimliği:
Retrieve_block_children

Belirtilen kimliği kullanarak blokta yer alan alt blok nesnelerinin sayfalandırılmış dizisini döndürür

Parametreler

Name Anahtar Gerekli Tür Description
Blok kimliği
 block_id True string

Bir bloğun tanımlayıcısı
Sayfa Boyutu
 page_size integer

Yanıtta istenen tam listeden öğe sayısı. Maksimum: 100

Döndürülenler

Name Yol Tür Description
kimlik
 items.id string

Bloğun tanımlayıcısı.
Yaratılış zamanı
 items.created_time date-time

Bu bloğun oluşturulduğu tarih ve saat.
Son düzenleme zamanı
 items.last_edited_time date-time

Bu bloğun en son güncelleştirildiği tarih ve saat.
Çocukları var
 items.has_children boolean

Bloğun içinde alt bloklar olup olmadığı.
Arşivlenmiş
 items.archived boolean

Bloğun arşivlenmiş durumu.
Türü
 items.type string

Blok türü. Olası değerler
Düz metin
 plain_text string

Paragraf bloğundaki düz metin plain_text
Sonraki imleç
 next_cursor string

Bir sonraki sonuç sayfasını istemek için kullanılan bir imleç döndürüldü. Bunu opak bir değer olarak değerlendirin
Daha fazlası var
 has_more boolean

Bloğun daha fazla bloğu olup olmadığı

Blok alt öğelerini ekleme

İşlem Kimliği:
Appendblockchildren

Yeni alt blokları oluşturur ve belirtilen üst block_id ekler.

Parametreler

Name Anahtar Gerekli Tür Description
Blok kimliği
 block_id True string

Bir bloğun tanımlayıcısı
object
 object string

object
type
 type string

type
type
 type string

type
içerik
 content string

içerik
type
 type string

type
içerik
 content string

içerik
url
 url string

url

Blok silme

İşlem Kimliği:
Deleteablock

Belirtilen kimliği kullanarak sayfa blokları da dahil olmak üzere bir Block nesnesini arşivlenmiş: true olarak ayarlar. Not: Notion UI uygulamasında bu, bloğu hala erişilebilen ve geri yüklenebilen "Çöp Kutusu"na taşır.

Parametreler

Name Anahtar Gerekli Tür Description
Blok Kimliği
 blockId True string

Notion bloğu tanımlayıcısı

Döndürülenler

Name Yol Tür Description
kimlik
 id string

Bloğun tanımlayıcısı.
Yaratılış zamanı
 created_time date-time

Bu bloğun oluşturulduğu tarih ve saat.
Son düzenleme zamanı
 last_edited_time date-time

Bu bloğun en son güncelleştirildiği tarih ve saat.
Nesne
 created_by.object string

Her zaman "kullanıcı"
Kimlik
 created_by.id string

Bu kullanıcı için benzersiz tanımlayıcı.
Nesne
 last_edited_by.object string

Son düzenlenen kullanıcı
Kimlik
 last_edited_by.id string

Bu kullanıcı için benzersiz tanımlayıcı.
Çocukları var
 has_children boolean

Bloğun içinde alt bloklar olup olmadığı.
Arşivlenmiş
 archived boolean

Bloğun arşivlenmiş durumu.
Türü
 type string

Türe özgü blok bilgilerini içeren bir nesne

Kullanıcı Al

İşlem Kimliği:
Retrieveuser

Belirtilen kimliği kullanarak bir Kullanıcı alır.

Parametreler

Name Anahtar Gerekli Tür Description
Kullanıcı kimliği
 user_id True string

Bu kullanıcı için benzersiz tanımlayıcı.

Döndürülenler

Name Yol Tür Description
Kimlik
 id string

Notion kullanıcısı tanımlayıcısı
Kullanıcı Adı
 name string

Kullanıcının Adı
Avatar URL'si
 avatar_url string

Seçili avatar resmi
E-posta
 email string

Kişinin e-posta adresi.

Sayfa alma

İşlem Kimliği:
Retrieveapage

Belirtilen kimliği kullanarak bir Page nesnesi alır.

Parametreler

Name Anahtar Gerekli Tür Description
Sayfa Kimliği
 page_id True string

Notion sayfasının tanımlayıcısı

Döndürülenler

Name Yol Tür Description
Kimlik
 id string

Sayfanın benzersiz tanımlayıcısı.
Yaratılış zamanı
 created_time string

Bu sayfanın oluşturulduğu tarih ve saat. ISO 8601 tarih saat dizesi olarak biçimlendirilir.
Son düzenleme zamanı
 last_edited_time string

Bu sayfanın güncelleştirilildiği tarih ve saat. ISO 8601 tarih saat dizesi olarak biçimlendirilir.
Kimlik
 created_by.id string

Bu kullanıcı için benzersiz tanımlayıcı.
Kimlik
 last_edited_by.id string

Bu kullanıcı için benzersiz tanımlayıcı.
url
 cover.url string

Dışta barındırılan görüntüye bağlantı.
emojisi
 icon.emoji string

Emoji karakteri.
veritabanı_kimlik
 parent.database_id string

veritabanı_kimlik
Arşivlenmiş
 archived boolean

Sayfanın arşivlenmiş durumu.
URL
 url string

Notion sayfasının URL'si.

Sayfa oluşturma

İşlem Kimliği:
CreateaPage

Belirtilen veritabanında yeni bir sayfa oluşturur. var olan sayfayı seçin.

Parametreler

Name Anahtar Gerekli Tür Description
Veritabanı Kimliği
 database_id True string

Veritabanı için benzersiz tanımlayıcı.
Emoji
 emoji string

emojisi
Kapak URL'si
 url string

Sayfa kapağı resmi URL'si.
Özellikler
 properties object

Notion'da görünen veritabanı özelliklerinin şeması.

Döndürülenler

Name Yol Tür Description
Kimlik
 id string

Sayfanın benzersiz tanımlayıcısı.
Yaratılış zamanı
 created_time string

Bu sayfanın oluşturulduğu tarih ve saat. ISO 8601 tarih saat dizesi olarak biçimlendirilir.
Son düzenleme zamanı
 last_edited_time string

Bu sayfanın güncelleştirilildiği tarih ve saat. ISO 8601 tarih saat dizesi olarak biçimlendirilir.
Kimlik
 created_by.id string

Bu kullanıcı için benzersiz tanımlayıcı.
Kimlik
 last_edited_by.id string

Bu kullanıcı için benzersiz tanımlayıcı.
url
 cover.url string

Dışta barındırılan görüntüye bağlantı.
emojisi
 icon.emoji string

Emoji karakteri.
veritabanı_kimlik
 parent.database_id string

veritabanı_kimlik
Arşivlenmiş
 archived boolean

Sayfanın arşivlenmiş durumu.
URL
 url string

Notion sayfasının URL'si.

Sayfa özellik öğesini alma

İşlem Kimliği:
Retrieveapagepropertyitem

Sayfa özellik öğesini alma

Parametreler

Name Anahtar Gerekli Tür Description
Sayfa Kimliği
 page_id True string

Notion sayfasının tanımlayıcısı
Özellik Kimliği
 property_id True string

Sayfa özelliğinin tanımlayıcısı

Döndürülenler

Name Yol Tür Description
Nesne
 object string

Her zaman listele.
Daha fazlası var
 has_more boolean

Yanıt listenin sonunu içerdiğinde false olur. Aksi takdirde, doğru.
İşlem Kimliği:
Search

Tümleştirmeyle paylaşılan tüm sayfaları ve alt sayfaları arar. Sonuçlar veritabanlarını içerebilir.

Parametreler

Name Anahtar Gerekli Tür Description
Query
 query True string

Sağlandığında, sorguyu sayfa başlığıyla karşılaştırarak hangi sayfaların döndürüleceklerini sınırlar.
Yön
 direction string

Sıralama yönü. Olası değerler artan ve azalan değerleri içerir.
Zaman Damgası
 timestamp string

Sıralanacak zaman damgasının adı. Olası değerler last_edited_time içerir.

Döndürülenler

Name Yol Tür Description
kimlik
 id string

Bloğun tanımlayıcısı.
Yaratılış zamanı
 created_time string

Bu sayfanın oluşturulduğu tarih ve saat.
Son düzenleme zamanı
 last_edited_time string

Bu sayfanın güncelleştirilildiği tarih ve saat.
Düz metin
 plain_text string

Ek açıklama içermeyen düz metin.
Etiketler
 Tags object

Tags nesnesi etiket listesini içerir.
URL
 url string

Nesnenin URL'si.
Sonraki imleç
 next_cursor string

Bir sonraki sonuç sayfasını istemek için kullanılan bir imleç döndürüldü. Bunu opak bir değer olarak değerlendirin
Daha fazlası var
 has_more boolean

Bloğun daha fazla bloğu olup olmadığı

Tüm kullanıcıların listesi

İşlem Kimliği:
List_of_all_users

Çalışma alanı için sayfalandırılmış bir Kullanıcı listesi döndürür

Parametreler

Name Anahtar Gerekli Tür Description
Sayfa Boyutu
 page_size integer

Yanıtta istenen tam listeden öğe sayısı. Maksimum: 100

Döndürülenler

Name Yol Tür Description
Kimlik
 id string

Notion bloğu tanımlayıcısı
Görüntü adı
 name string

Notion'da görüntülenen kullanıcının adı.
Avatar URL'si
 avatar_url string

Seçili avatar resmi.
Türü
 type string

Kullanıcının türü. Olası değerler "kişi" ve "bot" şeklindedir.
E-posta
 email string

Kişinin e-posta adresi.
Sonraki İmleç
 next_cursor string

Bir sonraki sonuç sayfasını istemek için kullanılan bir imleç döndürüldü. Bunu opak bir değer olarak değerlendirin
Daha fazlası var
 has_more boolean

Yanıt listenin sonunu içerdiğinde

Veritabanı alma

İşlem Kimliği:
Retrieve_a_database

Belirtilen kimliği kullanarak bir Veritabanı nesnesi alır.

Parametreler

Name Anahtar Gerekli Tür Description
Veritabanı kimliği
 database_id True string

Notion veritabanı tanımlayıcısı

Döndürülenler

Body
DatabaseResponse

Veritabanını sorgulama

İşlem Kimliği:
Query_a_database

veritabanında bulunan sayfaların listesini alır, istekte sağlanan filtre koşullarına ve sıralama ölçütlerine göre filtrelenir ve sıralanır.

Parametreler

Name Anahtar Gerekli Tür Description
Veritabanı Kimliği
 database_id True string

Notion veritabanının tanımlayıcısı.

Döndürülenler

Body
DatabaseResponse

Tanımlar

CommentResponse

Name Yol Tür Description
Kimlik
 id string

Açıklamanın benzersiz tanımlayıcısı.
Sayfa Kimliği
 parent.page_id string

Bu sayfanın ait olduğu sayfanın kimliği.
Tartışma kimliği
 discussion_id string

Açıklamanın ilişkili olduğu tartışma yazışmasının benzersiz tanımlayıcısı.
Yaratılış zamanı
 created_time string

Bu açıklamanın oluşturulduğu tarih ve saat.
Son düzenleme zamanı
 last_edited_time string

Bu açıklamanın güncelleştirilildiği tarih ve saat.
object
 created_by.object string

object
kimlik
 created_by.id string

kimlik
Zengin metin
 rich_text array of object

Zengin metin biçimlendirmesini, bağlantıları ve bahsetmeleri destekleyen açıklamanın içeriği.
type
 rich_text.type string

type
Content
 rich_text.text.content string

Metin içeriği.
Link
 rich_text.text.link string

Bu metindeki herhangi bir satır içi bağlantı.
Düz metin
 rich_text.plain_text string

Ek açıklama içermeyen düz metin.
href
 rich_text.href string

(isteğe bağlı) Varsa, bu metindeki herhangi bir bağlantının veya iç Notion'un URL'si.

DatabaseResponse

Name Yol Tür Description
results
 results array of object
Nesne
 results.object string

Sayfa veya 'veritabanı'
Kimlik
 results.id string

Veritabanı için benzersiz tanımlayıcı.
Yaratılış zamanı
 results.created_time string

Bu veritabanının oluşturulduğu tarih ve saat. ISO 8601 tarih saat dizesi olarak biçimlendirilir.
Son düzenleme zamanı
 results.last_edited_time string

Bu veritabanının güncelleştirilildiği tarih ve saat. ISO 8601 tarih saat dizesi olarak biçimlendirilir.
Nesne
 results.created_by.object string

Veritabanını oluşturan kullanıcı.
Kimlik
 results.created_by.id string

Kullanıcı için benzersiz tanımlayıcı
Nesne
 results.last_edited_by.object string

Veritabanını oluşturan kullanıcı.
Kimlik
 results.last_edited_by.id string

Kullanıcı için benzersiz tanımlayıcı
Arşivlenmiş
 results.archived boolean

Veritabanının arşivlenmiş durumu.
URL
 results.url string

Notion veritabanının URL'si