Aracılığıyla paylaş

OneNote (İş)

OneNote, Microsoft'tan fikirlerinizi, taslaklarınızı ve notlarınızı tüm cihazlarınızda eşitlemeyi kolaylaştıran bir not alma uygulamasıdır! Yeni bölümleri izlemek, notlar oluşturmak ve daha fazlasını yapmak için OneDrive İş etkinken Office 365 hesabınıza bağlanın.

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

Hizmet Class Bölgeler
Copilot Studio Standart Tüm Power Automate bölgeleri
Logic Apps Standart Tüm Logic Apps bölgeleri
Power Apps Standart Tüm Power Apps bölgeleri
Power Automate Standart Tüm Power Automate bölgeleri
Bağlayıcı Meta Verileri
Publisher Microsoft
Web sitesi https://products.office.com/onenote/digital-note-taking-app

Bu tümleştirmeyi kullanmak için OneDrive İş'te depolanan bir OneNote not defterine erişmeniz gerekir. Bağlantı oluşturmak için Oturum Aç'ı seçin. OneDrive İş'in etkin olduğu O365 hesabınızı sağlamanız istenir, bağlantı oluşturmak için ekranların geri kalanını izleyin.

Bilinen Sorunlar ve Sınırlamalar

  1. Bağlantıyı kullanırken beklediğiniz not defterinin listesini görmüyorsanız lütfen bağlantıyı oluşturduğunuz hesabı denetleyin ve yeniden deneyin. Bağlayıcıyı kullanırken bir hata görürseniz daha fazla bilgi için hata kodunu arayabilirsiniz.
  2. Bu tümleştirme, "UserRemoteAPIs" iznine sahip bir hesapla bağlanmayı gerektirir. Şu hatayı görürseniz: "Hata: Kullanıcının istenen kaynağa erişim izinleri yok", hesap doğru izinlere sahip olmayabilir. SharePoint yöneticisi, site koleksiyonuna göz atarak ve Site ayarlarını açarak izin düzeylerini denetleyebilir. Site İzinleri'ni ve ardından İzin Düzeyi'ni seçerek düzeyin içerdiği izinleri (Uzak Arabirimleri Kullan gibi) görebilirsiniz. Belirli bir düzeye ait bir kullanıcının gerekli izni yoksa, izin kutusunu işaretleyerek düzeyi değiştirin veya yeni bir izin düzeyi oluşturup bunu kullanıcıya atayın.
  3. Bağlayıcı şu anda Sayfa Oluştur eylemleri için açık bir giriş parametresi Olan Sayfa Başlığı'nı desteklememektedir. Bu, OneNote API uygulamasından kaynaklanan bir sınırlamadır. Ancak başlık,başlık/>başlıketiketleri kullanılarak HTML'deki Sayfa İçeriğinin<><bir parçası olarak belirtilebilir.
  4. Not defteri bölümü. Not Defteri Bölümü parametresi için özel bir değer sağlamak istiyorsanız, lütfen bunu API URL biçiminde belirtin. API URL deseni: https://www.onenote.com/api/v1.0/myOrganization/siteCollections/{siteCollectionsId}/sites/{SiteId}/notes/sections/{SectionId}/pages. Daha fazla bilgi için OneNote API belgelerine göz atabilirsiniz.
  5. Hızlı Notlar'da sayfa oluşturma eylemi aşağıdaki bölgelerde desteklenmez:
    • Logic Apps:
      • Azure Government
      • Azure Çin bölgeleri
    • Power Automate ve Power Apps:
      • ABD Hükümeti (GCC)
      • ABD Hükümeti (GCC High)
      • 21Vianet tarafından işletilen China Cloud
  6. Sayfa içeriğini al eylemi Power Apps'te desteklenmez, ancak bu eylem Power Automate'te desteklenir.

Uyarı

Not defteri adında şu karakterlere izin verilmez: *":<>?/|%

Azaltma Sınırları

Name Çağrılar Yenileme Dönemi
Bağlantı başına API çağrıları 100 60 saniye
Tetikleyici yoklamalarının sıklığı 1 1200 saniye

Eylemler

Belirli bir bölümün sayfalarını alma

Belirli bir bölümün sayfalarını alma.
Bir sayfayı silme

Sayfayı silme.
Bölümde sayfa oluşturma

Belirtilen bölümde yeni sayfa oluşturun.
Hızlı Notlar'da sayfa oluşturma

Hızlı Notlar bölümünde yeni bir sayfa oluşturun.
Not defterinde bölüm oluşturma

Not defterinde bölüm oluşturma.
Not defterindeki bölümleri alma

Belirli bir not defterindeki bölümleri alma.
Sayfa içeriğini alma

HTML sayfası içeriğini alın.
Sayfa içeriğini güncelleştirme

HTML sayfası içeriğini güncelleştirin.
Son not defterlerini alma

Son not defterlerini alın.

Belirli bir bölümün sayfalarını alma

İşlem Kimliği:
GetPagesInSection

Belirli bir bölümün sayfalarını alma.

Parametreler

Name Anahtar Gerekli Tür Description
Not Defteri Anahtarı
 notebookKey True string

Not defterini tanımlayan bir anahtar. Bunun API'ye özgü olduğunu ve el ile yazılamadığını unutmayın.
Not defteri bölümü
 sectionId True string

Bölüm sayfalarının API URL'si.

Döndürülenler

Body
GetPagesInSectionResponse

Bir sayfayı silme

İşlem Kimliği:
DeletePage

Sayfayı silme.

Parametreler

Name Anahtar Gerekli Tür Description
Not Defteri Anahtarı
 notebookKey True string

Not defterini tanımlayan bir anahtar. Bunun API'ye özgü olduğunu ve el ile yazılamadığını unutmayın.
Not defteri bölümü
 sectionId True string

Bölüm sayfalarının API URL'si.
Sayfa Kimliği
 pageId True string

Sayfanın benzersiz kimliği.

Bölümde sayfa oluşturma

İşlem Kimliği:
CreatePageInSection

Belirtilen bölümde yeni sayfa oluşturun.

Parametreler

Name Anahtar Gerekli Tür Description
Not Defteri Anahtarı
 notebookKey True string

Not defterini tanımlayan bir anahtar. Bunun API'ye özgü olduğunu ve el ile yazılamadığını unutmayın.
Not defteri bölümü
 sectionId True string

Bölüm sayfalarının API URL'si.
Sayfa İçeriği
 pageContent True html

Sayfa içeriği.

Döndürülenler

Body
Page

Hızlı Notlar'da sayfa oluşturma

İşlem Kimliği:
CreatePageInQuickNotes

Hızlı Notlar bölümünde yeni bir sayfa oluşturun.

Parametreler

Name Anahtar Gerekli Tür Description
Sayfa İçeriği
 pageContent True html

Sayfa içeriği.

Döndürülenler

Body
Page

Not defterinde bölüm oluşturma

İşlem Kimliği:
CreateSectionInNotebook

Not defterinde bölüm oluşturma.

Parametreler

Name Anahtar Gerekli Tür Description
Not Defteri Anahtarı
 notebookKey True string

Not defterini tanımlayan bir anahtar. Bunun API'ye özgü olduğunu ve el ile yazılamadığını unutmayın.
Yeni bölümün adı
 name string

Yeni bölümün adı.

Döndürülenler

Body
CreateSectionInNotebookResponse

Not defterindeki bölümleri alma

İşlem Kimliği:
GetSectionsInNotebook

Belirli bir not defterindeki bölümleri alma.

Parametreler

Name Anahtar Gerekli Tür Description
Not Defteri Anahtarı
 notebookKey True string

Not defterini tanımlayan bir anahtar. Bunun API'ye özgü olduğunu ve el ile yazılamadığını unutmayın.

Döndürülenler

Name Yol Tür Description
value
 value array of SectionListItem

Sayfa içeriğini alma

İşlem Kimliği:
GetPageContent

HTML sayfası içeriğini alın.

Parametreler

Name Anahtar Gerekli Tür Description
Not Defteri Anahtarı
 notebookKey True string

Not defterini tanımlayan bir anahtar. Bunun API'ye özgü olduğunu ve el ile yazılamadığını unutmayın.
Not defteri bölümü
 sectionId True string

Bölüm sayfalarının API URL'si.
Sayfa Kimliği
 pageId True string

Sayfanın benzersiz kimliği.

Döndürülenler

Sayfa HTML içeriği

response
string

Sayfa içeriğini güncelleştirme

İşlem Kimliği:
UpdatePageContent

HTML sayfası içeriğini güncelleştirin.

Parametreler

Name Anahtar Gerekli Tür Description
Not Defteri Anahtarı
 notebookKey True string

Not defterini tanımlayan bir anahtar. Bunun API'ye özgü olduğunu ve el ile yazılamadığını unutmayın.
Not defteri bölümü
 sectionId True string

Bölüm sayfalarının API URL'si.
Sayfa Kimliği
 pageId True string

Sayfanın benzersiz kimliği.
Target
 target string

Güncelleştirilecek öğe.
Eylem
 action string

Hedef öğede gerçekleştirilecek eylem.
Yer
 position string

Sağlanan içeriğin ekleneceği konum.
Content
 content html

Yeni içerik.

Döndürülenler

Sayfa HTML içeriği

response
string

Son not defterlerini alma

İşlem Kimliği:
GetNotebooks

Son not defterlerini alın.

Döndürülenler

response
array of Notebook

Tetikleyiciler

Bir bölümde yeni bir sayfa oluşturulduğunda

Bölüme yeni bir sayfa eklendiğinde akışı tetikler.
Yeni bir bölüm grubu oluşturulduğunda

Not defterine yeni bölüm grubu eklendiğinde akışı tetikler.
Yeni bir bölüm oluşturulduğunda

Not defterine yeni bölüm eklendiğinde akışı tetikler.

Bir bölümde yeni bir sayfa oluşturulduğunda

İşlem Kimliği:
OnNewPageInSection

Bölüme yeni bir sayfa eklendiğinde akışı tetikler.

Parametreler

Name Anahtar Gerekli Tür Description
Not Defteri Anahtarı
 notebookKey True string

Not defterini tanımlayan bir anahtar. Bunun API'ye özgü olduğunu ve el ile yazılamadığını unutmayın.
Not defteri bölümü
 sectionId True string

Bölüm sayfalarının API URL'si.

Döndürülenler

Yeni bir sayfa için yanıt.

Body
NewPageResponse

Yeni bir bölüm grubu oluşturulduğunda

İşlem Kimliği:
OnNewSectionGroupInNotebook

Not defterine yeni bölüm grubu eklendiğinde akışı tetikler.

Parametreler

Name Anahtar Gerekli Tür Description
Not Defteri Anahtarı
 notebookKey True string

Not defterini tanımlayan bir anahtar. Bunun API'ye özgü olduğunu ve el ile yazılamadığını unutmayın.

Döndürülenler

Yeni bölüm grubu için yanıt.

Body
NewSectionGroupResponse

Yeni bir bölüm oluşturulduğunda

İşlem Kimliği:
OnNewSectionInNotebook

Not defterine yeni bölüm eklendiğinde akışı tetikler.

Parametreler

Name Anahtar Gerekli Tür Description
Not Defteri Anahtarı
 notebookKey True string

Not defterini tanımlayan bir anahtar. Bunun API'ye özgü olduğunu ve el ile yazılamadığını unutmayın.

Döndürülenler

Yeni bölüm için yanıt.

Body
NewSectionResponse

Tanımlar

CreateSectionInNotebookResponse

Name Yol Tür Description
OData bağlamı
 @odata.context string

OData bağlamı.
Adla oluşturuldu
 createdBy string

Adla oluşturulan bu bölüm.
Yaratılış zamanı
 createdTime date-time

Bu bölüm saat oluşturdu.
Not defteri nesne kimliğinde bölüm oluşturma
 id string
Varsayılan bölüm bayrağı
 isDefault boolean

Bunun varsayılan bölüm olup olmadığını gösteren bir bayrak.
Son Değişiklik Yapan
 lastModifiedBy string

Son olarak ada göre değiştirildi.
Son Değiştirme Zamanı
 lastModifiedTime date-time

Bu bölümün son değiştirildiği saat.
Masaüstü istemcisi href
 links.oneNoteClientUrl.href string

OneNote masaüstü istemcisi href.
Web istemcisi href
 links.oneNoteWebUrl.href string

OneNote web istemcisi href.
Bölüm Adı
 name string

Bölümün adı.
Sayfaların Url'si
 pagesUrl string

Sayfaların URL'si.
Not defterinde bölüm oluşturma url'si
 self string

Not defteri grubunda bölüm oluşturma url'si.

Sayfa

Name Yol Tür Description
Sayfa başlığı
 title string

Sayfanın başlığı.
links
 links Link

OneNote sayfasıyla ilişkilendirilmiş bağlantılar.
İçerik Url'si
 contentUrl string

Sayfa içeriğinin url'si.
Son Değiştirme Tarihi
 lastModifiedTime date-time

Sayfanın son değiştirme tarihi.
Oluşturulma Tarihi
 createdTime date-time

Sayfanın oluşturulduğu tarih.
Kimlik
 id string

Sayfanın benzersiz tanımlayıcısı.

Dizüstü bilgisayar

Name Yol Tür Description
DosyaAdı
 FileName string
Key
 Key string

ParentNotebook

Name Yol Tür Description
Üst Not Defteri Anahtarı
 id string

Üst not defterinin benzersiz tanımlayıcısı.
Üst Not Defteri Adı
 name string

Üst not defterinin adı.
Üst Not Defteri Url'si
 self string

Üst not defterine url bağlantısı.

OneNote sayfasıyla ilişkilendirilmiş bağlantılar.

Name Yol Tür Description
oneNoteClientUrl
 oneNoteClientUrl OneNoteClientUrl
oneNoteWebUrl
 oneNoteWebUrl OneNoteWebUrl

OneNoteClientUrl

Name Yol Tür Description
OneNote istemci url'si
 href string

OneNote windows istemcisini kullanan not defteri bağlantısı.

OneNoteWebUrl

Name Yol Tür Description
OneNote web url'si
 href string

OneNote web istemcisini kullanan not defteri bağlantısı.

SectionListItem

Bölüm listesi öğesindeki alanlar.

Name Yol Tür Description
Bölüm adı
 name string

Bölümün adı.
Bölüm anahtarı
 pagesUrl string

Bu bölüme başvurmak için kullanılan anahtar; ayrıca sayfaların url'sini de seçin.
Bölüm Tanımlayıcısı
 id string

Bölümün benzersiz tanımlayıcısı.

SectionResponse

Bir bölümde yer alan alanlar.

Name Yol Tür Description
Oluşturan
 createdBy string

Bölümü oluşturan.
Oluşturma Tarihi
 createdTime date-time

Bölümün oluşturma tarihi ve saati.
Bölüm Tanımlayıcısı
 id string

Bölümün benzersiz tanımlayıcısı.
Son Değişiklik Yapan
 lastModifiedBy string

Bölümü son değiştiren kullanıcı.
Son Değiştirme Tarihi
 lastModifiedTime date-time

Bölümün son değiştirme tarihi ve saati.
Bölüm Adı
 name string

Bölümün adı.
Sayfalar Url'si
 pagesUrl string

Bu bölümdeki sayfaların URL'si.
parentNotebook
 parentNotebook ParentNotebook
Bağlantı
 self string

Bu bölümün URL'si.

SectionGroupResponse

Bölüm grubuna dahil edilen alanlar.

Name Yol Tür Description
Oluşturma tarihi
 createdTime date-time

Bölüm grubunun oluşturma tarihi ve saati.
Oluşturan
 createdBy string

Bölüm grubunun oluşturucusu.
Tanımlayıcı
 id string

Bölüm grubunun benzersiz tanımlayıcısı.
Son değiştirici
 lastModifiedBy string

Bölüm grubunu son değiştiren kullanıcı.
Son değiştirme tarihi
 lastModifiedTime date-time

Bölüm grubunun son değişiklik tarihi ve saati.
İsim
 name string

Bölüm grubunun adı.
Bölümler Url'si
 sectionsUrl string

Bu bölüm grubundaki bölümlerin URL'si.
Bölüm Grubu Url'si
 self string

Bu bölüm grubunun URL'si.

NewSectionResponse

Yeni bölüm için yanıt.

Name Yol Tür Description
Bölümler
 value array of SectionResponse

Her biri belirli bir bölümü temsil eden bir nesne dizisi.

NewSectionGroupResponse

Yeni bölüm grubu için yanıt.

Name Yol Tür Description
Bölüm Grupları
 value array of SectionGroupResponse

Her biri belirli bir bölüm grubunu temsil eden bir nesne dizisi.

NewPageResponse

Yeni bir sayfa için yanıt.

Name Yol Tür Description
Sayfalar
 value array of Page

Her biri belirli bir sayfayı temsil eden bir nesne dizisi.

GetPagesInSectionResponse

Name Yol Tür Description
OData bağlamı
 @odata.context string

OData bağlamı.
Bölüm değeri nesnesindeki sayfalar
 value array of object

value
İçerik Url'si
 value.contentUrl string

İçerik URL'si.
Uygulama kimliği tarafından oluşturuldu
 value.createdByAppId string

Uygulama kimliği tarafından oluşturulan.
Yaratılış zamanı
 value.createdTime date-time

Bu yanıt için oluşturulan saat.
Yanıt için benzersiz tanımlayıcı
 value.id string

Bu yanıtın benzersiz tanımlayıcısı.
Son değiştirme zamanı
 value.lastModifiedTime date-time

Bu nesne için son değiştirme zamanı.
OneNote masaüstü istemcisi href
 value.links.oneNoteClientUrl.href string

OneNote masaüstü istemcisi href.
OneNote web istemcisi href
 value.links.oneNoteWebUrl.href string

OneNote web istemcisi href.
Üst bölüm benzersiz tanımlayıcısı
 value.parentSection.id string

Bu nesne üst bölümü için benzersiz tanımlayıcı.
Üst bölüm adı
 value.parentSection.name string
Bölüm üst bölümündeki sayfalar
 value.parentSection.self string

Bölüm üst bölümündeki sayfaların URL'si.
Üst Bölüm OData bağlamı
 value.parentSection@odata.context string

Üst Bölüm OData bağlamı.
BölümDeki Sayfalar grubu
 value.self string

Bölümdeki Sayfalar grubunun URL'si.
Sayfa başlığı
 value.title string

Sayfa başlığı.

String

Bu, 'string' temel veri türüdür.