Almanac (Bağımsız Yayımcı) (Önizleme)

Almanac, insan yaratıcılığına hizmet etmek için işbirliğine dayalı bir altyapı oluşturuyor. En hızlı wiki ve iş akışı aracını kullanarak belgelerinizi güzel, düzenli bir tek gerçeklik kaynağında birleştirin.

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	Troy Taylor
URL	https://www.hitachisolutions.com
E-posta	ttaylor@hitachisolutions.com

Bağlayıcı Meta Verileri
Publisher	Troy Taylor
Web sitesi	https://almanac.io/
Gizlilik ilkesi	https://almanac.io/privacy-policy
Kategoriler	Işbirliği; İçerik ve Dosyalar

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
Çalışma Alanı Kimliği	String	Bu API'nin çalışma alanı kimliği.	Doğru
Erişim Belirteci ('Bearer yourAccessToken' biçiminde)	securestring	Bu API için Erişim Belirteci ('Bearer yourAccessToken' biçiminde).	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

Belge bilgilerini alma	Belgenin meta bilgilerini alma.
Belge bilgilerini değiştirme	Belgenin meta bilgilerini güncelleştirme.
Belge bilgilerini güncelleştirme	Belgenin meta bilgilerini güncelleştirme.
Belge erişimi ekleme	Belgeye erişim ekleyin.
Belge erişimini değiştirme	Belgeye erişimi değiştirin.
Belge erişimini güncelleştirme	Belgeye erişimi güncelleştirin.
Belge erişimini kaldırma	Belgeden erişimi kaldırın.
Belge erişimlerini alma	Belge erişimlerini listeleyin.
Belge özel özelliğini silme	Çalışma alanı düzeyinde bir belge özel özelliğini silin.
Belge özelliklerini alma	Belge özel özelliklerini çalışma alanı düzeyinde listeleyin.
Belge özelliklerini alma	Belge düzeyinde belge özel özelliklerini listeleyin.
Belge özelliği ekleme	Belgeye özel bir özellik ekleyin.
Belge özelliği oluşturma	Çalışma alanı düzeyinde bir belge özelliği oluşturun.
Belge özelliğini silme	Belgeden özel bir özelliği kaldırma.
Belgeleri alma	Çalışma alanı içindeki tüm belgelere ait meta bilgileri alın.
Belgeyi içeri aktarma	Dış kaynaktan belge içeri aktarma.
Dosyaları taşıma	Dosyaları (belgeler ve/veya klasörler) belirli bir klasöre (aynı veya farklı çalışma alanında) taşıyın.
El kitabı öğelerini alma	El kitabı öğelerinin listesini alın.
El kitabı öğesi oluşturma	El kitabına öğe ekleyin.
El kitaplarını alma	Çalışma alanı el kitaplarının listesini alın.
Grupları alma	Kullanıcı gruplarını alma.
İçeri aktarmayı alma	Var olan bir içeri aktarmayla ilgili bilgileri alın.
Klasör bilgilerini alma	Klasör meta bilgilerinin listesini alın.
Klasör bilgilerini değiştir	Klasör meta bilgilerini değiştirin.
Klasör bilgilerini güncelleştirme	Klasör meta bilgilerini güncelleştirin.
Klasör oluştur	Bir klasör oluşturun.
Klasörleri alma	Tüm klasörlerin listesini alın.
Kullanıcıları alma	Kullanıcıların listesini alın.
Kullanıcıları gruba alma	Bir kullanıcı grubunun tüm kullanıcılarını alma.
Çalışma kitabı öğesini silme	El kitabından öğeyi silin.

Belge bilgilerini alma

İşlem Kimliği:

GetDocsId

Belgenin meta bilgilerini alma.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Kimlik	id	True	integer	Tanımlayıcı.

Döndürülenler

Belge Modeli

Doc

Belge bilgilerini değiştirme

İşlem Kimliği:

PutDocsId

Belgenin meta bilgilerini güncelleştirme.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Başlık	doc[title]	True	string	Belgenin başlığı.
Kimlik	id	True	integer	Tanımlayıcı.

Döndürülenler

Belge Modeli

Doc

Belge bilgilerini güncelleştirme

İşlem Kimliği:

PatchDocsId

Belgenin meta bilgilerini güncelleştirme.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Başlık	doc[title]	True	string	Belgenin başlığı.
Kimlik	id	True	integer	Tanımlayıcı.

Döndürülenler

Belge Modeli

Doc

Belge erişimi ekleme

İşlem Kimliği:

PostDocsDocIdAccesses

Belgeye erişim ekleyin.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
İzin	access[permission]	True	string	İzin.
Erişimci Türü	access[accessor_type]	True	string	Erişimci türü.
Erişimci Kimliği	access[accessor_id]	True	integer	Erişimci tanımlayıcısı.
Belge Kimliği	doc_id	True	integer	Belge tanımlayıcısı.

Döndürülenler

Belge Erişim Modeli

DocAccess

Belge erişimini değiştirme

İşlem Kimliği:

PutDocsDocIdAccessesId

Belgeye erişimi değiştirin.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
İzin	access[permission]	True	string	İzin.
Belge Kimliği	doc_id	True	integer	Belge tanımlayıcısı.
Kimlik	id	True	integer	Tanımlayıcı.

Döndürülenler

Belge Erişim Modeli

DocAccess

Belge erişimini güncelleştirme

İşlem Kimliği:

PatchDocsDocIdAccessesId

Belgeye erişimi güncelleştirin.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
İzin	access[permission]	True	string	İzin.
Belge Kimliği	doc_id	True	integer	Belge tanımlayıcısı.
Kimlik	id	True	integer	Tanımlayıcı.

Döndürülenler

Belge Erişim Modeli

DocAccess

Belge erişimini kaldırma

İşlem Kimliği:

DeleteDocsDocIdAccessesId

Belgeden erişimi kaldırın.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Belge Kimliği	doc_id	True	integer	Belge tanımlayıcısı.
Kimlik	id	True	integer	Tanımlayıcı.

Belge erişimlerini alma

İşlem Kimliği:

GetDocsDocIdAccesses

Belge erişimlerini listeleyin.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Sayfa	page		integer	Getirilecek sayfa uzaklığı.
Eşya	items		integer	Sayfa başına döndürülecek öğe sayısı.
Belge Kimliği	doc_id	True	integer	Belge tanımlayıcısı.

Döndürülenler

response

array of DocAccess

Belge özel özelliğini silme

İşlem Kimliği:

DeletePropertiesId

Çalışma alanı düzeyinde bir belge özel özelliğini silin.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Kimlik	id	True	integer	Tanımlayıcı.

Belge özelliklerini alma

İşlem Kimliği:

GetProperties

Belge özel özelliklerini çalışma alanı düzeyinde listeleyin.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Sayfa	page		integer	Getirilecek sayfa uzaklığı.
Eşya	items		integer	Sayfa başına döndürülecek öğe sayısı.

Döndürülenler

response

array of Property

Belge özelliklerini alma

İşlem Kimliği:

GetDocsDocIdProperties

Belge düzeyinde belge özel özelliklerini listeleyin.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Sayfa	page		integer	Getirilecek sayfa uzaklığı.
Eşya	items		integer	Sayfa başına döndürülecek öğe sayısı.
Belge Kimliği	doc_id	True	integer	Belge tanımlayıcısı.

Döndürülenler

response

array of DocProperty

Belge özelliği ekleme

İşlem Kimliği:

PostDocsDocIdProperties

Belgeye özel bir özellik ekleyin.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Özellik Kimliği	property_id	True	integer	Özellik tanımlayıcısı.
Değer	value		string	Parametre türü value özellik türüne bağlıdır: 'text', 'date', 'number', 'link' => String 'single_select' => { 'selected_item_id': Integer }, PropertyValue#ID 'multi_select' => { 'selected_item_ids': Array[Integer] }, seçilen PropertyValue#IDs 'checkbox' => { 'checked': Boolean } 'document' => { 'doc_id': Integer }, Document#ID 'person' => { 'user_ids': Array[Integer] }, The User#Ids.
Belge Kimliği	doc_id	True	integer	Belge tanımlayıcısı.

Döndürülenler

Doc Özellik Modeli

DocProperty

Belge özelliği oluşturma

İşlem Kimliği:

PostProperties

Çalışma alanı düzeyinde bir belge özelliği oluşturun.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Özellik Adı	property[name]	True	string	Çalışma alanı başına benzersiz olması gereken özellik adı.
Özellik Türü	property[type]	True	string	Özellik türü.
Makaleler için Varsayılan	property[default_for_articles]		boolean	Bu özellik yeni makalelere otomatik olarak eklensin mi? Varsayılan değer false'tur.
Veri Biçimi	property[meta][date_format]		string	Tarih türü özellikleri için isteğe bağlı.
Sayı Biçimi	property[meta][number_format]		string	Sayı türü özellikleri için isteğe bağlı.
Birden Çok Kişiden Bahsetmeye İzin Ver	property[meta][allow_mentioning_multiple_people]		boolean	Kişi türü özellikleri için isteğe bağlı.
Kişiye Bildir	property[meta][notify_person]		boolean	Kişi türü özellikleri için isteğe bağlı.
Özellik Değerleri	property[property_values][][value]	True	array	Özellik değerleri.
Renk	property[property_values][][meta][color]		array	Rengi.

Döndürülenler

Özellik Modeli

Property

Belge özelliğini silme

İşlem Kimliği:

DeleteDocsDocIdPropertiesId

Belgeden özel bir özelliği kaldırma.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Belge Kimliği	doc_id	True	integer	Belge tanımlayıcısı.
Kimlik	id	True	integer	Tanımlayıcı.

Belgeleri alma

İşlem Kimliği:

GetDocs

Çalışma alanı içindeki tüm belgelere ait meta bilgileri alın.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Sayfa	page		integer	Getirilecek sayfa uzaklığı.
Eşya	items		integer	Sayfa başına döndürülecek öğe sayısı.
Klasör Kimliği	folder_id		string	İsteğe bağlı filtre: Yalnızca bu klasörün kökündeki belgeleri gösterir.

Döndürülenler

response

array of Doc

Belgeyi içeri aktarma

İşlem Kimliği:

PostImports

Dış kaynaktan belge içeri aktarma.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Dosya	import[file]	True	file	İçeri aktarılacağınız dosya.
Kaynak	import[source]	True	string	Dosyanın kaynağı.

Döndürülenler

Modeli İçeri Aktar

Import

Dosyaları taşıma

İşlem Kimliği:

PostFilesMove

Dosyaları (belgeler ve/veya klasörler) belirli bir klasöre (aynı veya farklı çalışma alanında) taşıyın.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Klasör Kimlikleri	folder_ids[]		array	Klasör tanımlayıcıları.
Belge Kimlikleri	doc_ids[]		array	Belge tanımlayıcıları.
Hedef Klasör Kimliği	destination_folder_id		integer	Hedef klasör tanımlayıcısı.
Hedef Çalışma Alanı Kimliği	destination_workspace_id		integer	Hedef çalışma alanı tanımlayıcısı.

El kitabı öğelerini alma

İşlem Kimliği:

GetHandbooksHandbookIdItems

El kitabı öğelerinin listesini alın.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Sayfa	page		integer	Getirilecek sayfa uzaklığı.
Eşya	items		integer	Sayfa başına döndürülecek öğe sayısı.
El Kitabı Kimliği	handbook_id	True	integer	El kitabı tanımlayıcısı.

Döndürülenler

response

array of HandbookItem

El kitabı öğesi oluşturma

İşlem Kimliği:

PostHandbooksHandbookIdItems

El kitabına öğe ekleyin.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Öğe Türü	handbook_item[type]	True	string	El kitabı öğesi türü.
Öğe Konumu	handbook_item[position]		integer	Sağlanmadıysa öğeyi son konum olarak ekler.
Üst Öğe Kimliği	handbook_item[parent_item_id]		integer	İç içe yerleştirme amacıyla Üst Öğe Kimliği.
Belge Kimliği	handbook_item[doc_id]	True	integer	Yalnızca belge öğeleri için gereklidir.
Öğe Başlığı	handbook_item[title]	True	string	Yalnızca bölüm ve bağlantı öğeleri için gereklidir.
Öğe URL'si	handbook_item[url]	True	string	Yalnızca bağlantı öğeleri için gereklidir.
El Kitabı Kimliği	handbook_id	True	integer	El kitabı tanımlayıcısı.

Döndürülenler

HandbookItem Modeli

HandbookItem

El kitaplarını alma

İşlem Kimliği:

GetHandbooks

Çalışma alanı el kitaplarının listesini alın.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Sayfa	page		integer	Getirilecek sayfa uzaklığı.
Eşya	items		integer	Sayfa başına döndürülecek öğe sayısı.

Döndürülenler

response

array of Handbook

Grupları alma

İşlem Kimliği:

GetGroups

Kullanıcı gruplarını alma.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Sayfa	page		integer	Getirilecek sayfa uzaklığı.
Eşya	items		integer	Sayfa başına döndürülecek öğe sayısı.

Döndürülenler

response

array of Group

İçeri aktarmayı alma

İşlem Kimliği:

GetImportsId

Var olan bir içeri aktarmayla ilgili bilgileri alın.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Kimlik	id	True	integer	Tanımlayıcı.

Döndürülenler

Modeli İçeri Aktar

Import

Klasör bilgilerini alma

İşlem Kimliği:

GetFoldersId

Klasör meta bilgilerinin listesini alın.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Kimlik	id	True	string	Tanımlayıcı.

Döndürülenler

Klasör Modeli

Folder

Klasör bilgilerini değiştir

İşlem Kimliği:

PutFoldersId

Klasör meta bilgilerini değiştirin.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Klasör Başlığı	folder[title]	True	string	Klasör başlığı.
Kimlik	id	True	integer	Tanımlayıcı.

Döndürülenler

Klasör Modeli

Folder

Klasör bilgilerini güncelleştirme

İşlem Kimliği:

PatchFoldersId

Klasör meta bilgilerini güncelleştirin.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Klasör Başlığı	folder[title]	True	string	Klasör başlığı.
Kimlik	id	True	integer	Tanımlayıcı.

Döndürülenler

Klasör Modeli

Folder

Klasör oluştur

İşlem Kimliği:

PostFolders

Bir klasör oluşturun.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Klasör Başlığı	folder[title]	True	string	Klasör başlığı.
Üst Klasör Kimliği	folder[parent_folder_id]		integer	Üst klasörün kimliği. Sağlanmadıysa çalışma alanı kökünde oluşturulur.

Döndürülenler

Klasör Modeli

Folder

Klasörleri alma

İşlem Kimliği:

GetFolders

Tüm klasörlerin listesini alın.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Sayfa	page		integer	Getirilecek sayfa uzaklığı.
Eşya	items		integer	Sayfa başına döndürülecek öğe sayısı.
Üst Klasör Kimliği	parent_folder_id		string	İsteğe bağlı filtre: Yalnızca bu üst klasör kimliğine sahip klasörleri gösterir.

Döndürülenler

response

array of Folder

Kullanıcıları alma

İşlem Kimliği:

GetUsers

Kullanıcıların listesini alın.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Sayfa	page		integer	Getirilecek sayfa uzaklığı.
Eşya	items		integer	Sayfa başına döndürülecek öğe sayısı.

Döndürülenler

response

array of User

Kullanıcıları gruba alma

İşlem Kimliği:

GetGroupsGroupIdUsers

Bir kullanıcı grubunun tüm kullanıcılarını alma.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Sayfa	page		integer	Getirilecek sayfa uzaklığı.
Eşya	items		integer	Sayfa başına döndürülecek öğe sayısı.
Grup Kimliği	group_id	True	integer	Grup tanımlayıcısı.

Döndürülenler

response

array of User

Çalışma kitabı öğesini silme

İşlem Kimliği:

DeleteHandbooksHandbookIdItemsId

El kitabından öğeyi silin.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Kimlik	id	True	string	Tanımlayıcı.
El Kitabı Kimliği	handbook_id	True	integer	El kitabı tanımlayıcısı.

Tanımlar

User

Name	Yol	Tür	Description
Kimlik	id	integer	Tanımlayıcı
İlk İsim	first_name	string	Adı.
Soyadı	last_name	string	Soyadı.

Grup

Name	Yol	Tür	Description
Kimlik	id	integer	Tanımlayıcı
İsim	name	string	Adı.
Description	description	string	Açıklama.
Erişilebilirlik	accessibility	string	Erişilebilirlik.

Mülkiyet

Name	Yol	Tür	Description
Kimlik	id	integer	Tanımlayıcı
İsim	name	string	Adı.
Türü	type	string	Türü.
Makaleler için Varsayılan	default_for_articles	boolean	Makaleler için varsayılan ayar olup olmadığı.
Meta	meta	PropertyMeta
property_values	property_values	array of PropertyValue

PropertyMeta

Name	Yol	Tür	Description
Sayı Biçimi	number_format	string	Yalnızca sayı türü özellikleri için döndürülen &.
Tarih Biçimi	date_format	string	Yalnızca döndürülen & tarih türü özellikleri için uygun
Birden Çok Kişiden Bahsetmeye İzin Ver	allow_mentioning_multiple_people	boolean	Yalnızca kişi türü özellikleri için döndürülen & ilgili.
Kişiye Bildir	notify_person	boolean	Yalnızca kişi türü özellikleri için döndürülen & ilgili.

PropertyValue

Name	Yol	Tür	Description
Kimlik	id	integer	Tanımlayıcı
Özellik Kimliği	property_id	integer	Özellik tanımlayıcısı.
Değer	value	string	Değer.
Meta	meta	PropertyValueMeta

PropertyValueMeta

Name	Yol	Tür	Description
Renk	color	string	Yalnızca single_select ve multi_select türü özellikleri için döndürülen &.

HandbookItem

Name	Yol	Tür	Description
Kimlik	id	integer	Tanımlayıcı
El Kitabı Kimliği	handbook_id	integer	El kitabı tanımlayıcısı.
Türü	type	string	Türü.
Position	position	integer	Konum.
Başlık	title	string	Yalnızca bölüm ve bağlantı öğeleri için geçerlidir.
URL	url	string	Yalnızca bağlantı öğeleri için geçerlidir.
Üst Öğe Kimliği	parent_item_id	integer	Öğe iç içe yerleştirilmişse null olmayan.
Belge Kimliği	doc_id	integer	Yalnızca belge öğeleri için geçerlidir.

El kitabı

Name	Yol	Tür	Description
Kimlik	id	integer	Tanımlayıcı
İsim	name	string	Adı.

Klasör

Name	Yol	Tür	Description
Kimlik	id	integer	Tanımlayıcı
Başlık	title	string	Başlık.
Çalışma Alanı Kimliği	workspace_id	integer	Çalışma alanı tanımlayıcısı.
Üst Klasör Kimliği	parent_folder_id	integer	Üst klasör tanımlayıcısı.

DocAccess

Name	Yol	Tür	Description
Kimlik	id	integer	Tanımlayıcı
Belge Kimliği	doc_id	integer	Belge tanımlayıcısı.
İzin	permission	string	İzin.
Erişimci Türü	accessor_type	string	Erişimci türü.
Erişimci Kimliği	accessor_id	integer	Erişimci tanımlayıcısı.
Devralınan	inherited	boolean	Devralınıp devralınmadığı.

DocProperty

Name	Yol	Tür	Description
Kimlik	id	integer	Tanımlayıcı
Özellik Modeli	property	Property
Değer	value	string	Türü value özellik türüne bağlıdır: 'text', 'date', 'number', 'link' => String 'single_select' => { 'selected_item_id': Integer }, PropertyValue#ID 'multi_select' => { 'selected_item_ids': Array[Integer] }, seçilen PropertyValue#Ids 'checkbox' => { 'checked': Boolean } 'document' => { 'doc_id': Integer }, Document#ID 'person' => { 'user_ids': Array[Integer] }, Kullanıcı#Kimlikleri.

Doktor

Name	Yol	Tür	Description
Kimlik	id	integer	Tanımlayıcı
Başlık	title	string	Başlık.
Çalışma Alanı Kimliği	workspace_id	integer	Çalışma alanı tanımlayıcısı.
Klasör Kimliği	folder_id	integer	Klasör tanımlayıcısı.
Sahip Kimliği	owner_id	integer	Belge sahibinin kullanıcı kimliği.
Oluşturma Tarihi	created_at	string	Biçimlendirilmiş tarih saat ISO8601.
Güncelleştirme Tarihi:	updated_at	string	Biçimlendirilmiş tarih saat ISO8601.

İthalat

Name	Yol	Tür	Description
Kimlik	id	integer	Tanımlayıcı
statü	status	string
Belge Modeli	doc	Doc