다음을 통해 공유

Almanac(독립 게시자)(미리 보기)

Almanac은 인간의 창의성을 제공하기 위해 공동 작업 인프라를 구축하고 있습니다. 가장 빠른 위키 및 워크플로 도구를 사용하여 문서를 아름답고 조직된 단일 진실 소스로 통합합니다.

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스 클래스 Regions
Copilot Studio Premium 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
논리 앱 스탠다드 다음을 제외한 모든 Logic Apps 지역 :
     - Azure Government 지역
     - Azure 중국 지역
     - 미국 국방부(DoD)
Power Apps Premium 다음을 제외한 모든 Power Apps 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
Power Automate Premium 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
연락처
이름 트로이 테일러
URL https://www.hitachisolutions.com
전자 메일 ttaylor@hitachisolutions.com
커넥터 메타데이터
게시자 트로이 테일러
웹 사이트 https://almanac.io/
개인 정보 보호 정책 https://almanac.io/privacy-policy
카테고리 합작; 콘텐츠 및 파일

연결을 만드는 중

커넥터는 다음 인증 유형을 지원합니다.
기본값 연결을 만들기 위한 매개 변수입니다. 모든 지역 공유할 수 없음

기본값

적용 가능: 모든 지역

연결을 만들기 위한 매개 변수입니다.

공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

이름 유형 Description 필수
작업 영역 ID 문자열 이 API의 작업 영역 ID입니다. 진실
액세스 토큰('Bearer yourAccessToken' 형식) 시큐어스트링 (보안 문자열) 이 API에 대한 액세스 토큰('Bearer yourAccessToken' 형식)입니다. 진실

제한 한도

Name 호출 갱신 기간
연결당 API 호출 100 60초

동작

가져오기 가져오기

기존 가져오기에 대한 정보를 검색합니다.
그룹 가져오기

사용자 그룹을 검색합니다.
그룹에 사용자 가져오기

사용자 그룹의 모든 사용자를 검색합니다.
문서 가져오기

작업 영역에서 모든 문서의 메타 정보를 검색합니다.
문서 가져오기

외부 원본에서 문서를 가져옵니다.
문서 사용자 지정 속성 삭제

작업 영역 수준에서 문서 사용자 지정 속성을 삭제합니다.
문서 속성 가져오기

작업 영역 수준에서 문서 사용자 지정 속성을 나열합니다.
문서 속성 가져오기

문서 수준에서 문서 사용자 지정 속성을 나열합니다.
문서 속성 만들기

작업 영역 수준에서 문서 속성을 만듭니다.
문서 속성 삭제

문서에서 사용자 지정 속성을 제거합니다.
문서 속성 추가

문서에 사용자 지정 속성을 추가합니다.
문서 액세스 가져오기

문서 액세스를 나열합니다.
문서 액세스 바꾸기

문서에 대한 액세스를 대체합니다.
문서 액세스 업데이트

문서에 대한 액세스를 업데이트합니다.
문서 액세스 제거

문서에서 액세스 권한을 제거합니다.
문서 액세스 추가

문서에 대한 액세스를 추가합니다.
문서 정보 가져오기

문서의 메타 정보를 검색합니다.
문서 정보 바꾸기

문서의 메타 정보를 업데이트합니다.
문서 정보 업데이트

문서의 메타 정보를 업데이트합니다.
사용자 가져오기

사용자 목록을 검색합니다.
통합 문서 항목 삭제

핸드북에서 항목을 삭제합니다.
파일 이동

파일(문서 및/또는 폴더)을 특정 폴더(동일하거나 다른 작업 영역)로 이동합니다.
폴더 가져오기

모든 폴더 목록을 검색합니다.
폴더 만들기

폴더를 만듭니다.
폴더 정보 가져오기

폴더 메타 정보 목록을 검색합니다.
폴더 정보 바꾸기

폴더 메타 정보를 대체합니다.
폴더 정보 업데이트

폴더 메타 정보를 업데이트합니다.
핸드북 가져오기

작업 영역 핸드북 목록을 검색합니다.
핸드북 항목 가져오기

핸드북 항목 목록을 검색합니다.
핸드북 항목 만들기

핸드북에 항목을 추가합니다.

가져오기 가져오기

작업 ID:
GetImportsId

기존 가져오기에 대한 정보를 검색합니다.

매개 변수

Name 키 필수 형식 Description
아이디
 id True integer

식별자입니다.

반환

모델 가져오기
Import

그룹 가져오기

작업 ID:
GetGroups

사용자 그룹을 검색합니다.

매개 변수

Name 키 필수 형식 Description
페이지
 page integer

가져올 페이지 오프셋입니다.
아이템
 items integer

페이지당 반환할 항목 수입니다.

반환

response
array of Group

그룹에 사용자 가져오기

작업 ID:
GetGroupsGroupIdUsers

사용자 그룹의 모든 사용자를 검색합니다.

매개 변수

Name 키 필수 형식 Description
페이지
 page integer

가져올 페이지 오프셋입니다.
아이템
 items integer

페이지당 반환할 항목 수입니다.
그룹 아이디
 group_id True integer

그룹 식별자입니다.

반환

response
array of User

문서 가져오기

작업 ID:
GetDocs

작업 영역에서 모든 문서의 메타 정보를 검색합니다.

매개 변수

Name 키 필수 형식 Description
페이지
 page integer

가져올 페이지 오프셋입니다.
아이템
 items integer

페이지당 반환할 항목 수입니다.
폴더 ID
 folder_id string

선택적 필터: 이 폴더의 루트에 있는 문서만 표시합니다.

반환

response
array of Doc

문서 가져오기

작업 ID:
PostImports

외부 원본에서 문서를 가져옵니다.

매개 변수

Name 키 필수 형식 Description
File
 import[file] True file

가져올 파일입니다.
출처
 import[source] True string

파일의 원본입니다.

반환

모델 가져오기
Import

문서 사용자 지정 속성 삭제

작업 ID:
DeletePropertiesId

작업 영역 수준에서 문서 사용자 지정 속성을 삭제합니다.

매개 변수

Name 키 필수 형식 Description
아이디
 id True integer

식별자입니다.

문서 속성 가져오기

작업 ID:
GetProperties

작업 영역 수준에서 문서 사용자 지정 속성을 나열합니다.

매개 변수

Name 키 필수 형식 Description
페이지
 page integer

가져올 페이지 오프셋입니다.
아이템
 items integer

페이지당 반환할 항목 수입니다.

반환

response
array of Property

문서 속성 가져오기

작업 ID:
GetDocsDocIdProperties

문서 수준에서 문서 사용자 지정 속성을 나열합니다.

매개 변수

Name 키 필수 형식 Description
페이지
 page integer

가져올 페이지 오프셋입니다.
아이템
 items integer

페이지당 반환할 항목 수입니다.
문서 ID
 doc_id True integer

문서 식별자입니다.

반환

response
array of DocProperty

문서 속성 만들기

작업 ID:
PostProperties

작업 영역 수준에서 문서 속성을 만듭니다.

매개 변수

Name 키 필수 형식 Description
속성 이름
 property[name] True string

작업 영역당 고유해야 하는 속성 이름입니다.
속성 형식
 property[type] True string

속성 형식입니다.
아티클의 기본값
 property[default_for_articles] boolean

새 문서에 이 속성을 자동으로 추가하시겠습니까? 기본값은 false입니다.
데이터 형식
 property[meta][date_format] string

형식 날짜의 속성에 대한 선택 사항입니다.
숫자 형식
 property[meta][number_format] string

형식 번호의 속성에 대한 선택 사항입니다.
여러 사용자 멘션 허용
 property[meta][allow_mentioning_multiple_people] boolean

형식 사용자의 속성에 대한 선택 사항입니다.
사용자에게 알림
 property[meta][notify_person] boolean

형식 사용자의 속성에 대한 선택 사항입니다.
속성 값
 property[property_values][][value] True array

속성 값입니다.
색깔
 property[property_values][][meta][color] array

색입니다.

반환

속성 모델
Property

문서 속성 삭제

작업 ID:
DeleteDocsDocIdPropertiesId

문서에서 사용자 지정 속성을 제거합니다.

매개 변수

Name 키 필수 형식 Description
문서 ID
 doc_id True integer

문서 식별자입니다.
아이디
 id True integer

식별자입니다.

문서 속성 추가

작업 ID:
PostDocsDocIdProperties

문서에 사용자 지정 속성을 추가합니다.

매개 변수

Name 키 필수 형식 Description
속성 ID
 property_id True integer

속성 식별자입니다.
가치
 value string

매개 변수의 value 형식은 속성 형식에 따라 달라집니다. 'text', 'date', 'number', 'link' => String 'single_select' => { 'selected_item_id': Integer }, PropertyValue#ID 'multi_select' => { 'selected_item_ids': Array[Integer] }, 선택한 PropertyValue#ID 'checkbox' => { 'checked': Boolean } 'document' => { 'doc_id': 정수 }, Document#ID 'person' => { 'user_ids': Array[Integer] }, User#ID.
문서 ID
 doc_id True integer

문서 식별자입니다.

반환

Doc 속성 모델
DocProperty

문서 액세스 가져오기

작업 ID:
GetDocsDocIdAccesses

문서 액세스를 나열합니다.

매개 변수

Name 키 필수 형식 Description
페이지
 page integer

가져올 페이지 오프셋입니다.
아이템
 items integer

페이지당 반환할 항목 수입니다.
문서 ID
 doc_id True integer

문서 식별자입니다.

반환

response
array of DocAccess

문서 액세스 바꾸기

작업 ID:
PutDocsDocIdAccessesId

문서에 대한 액세스를 대체합니다.

매개 변수

Name 키 필수 형식 Description
허가
 access[permission] True string

사용 권한입니다.
문서 ID
 doc_id True integer

문서 식별자입니다.
아이디
 id True integer

식별자입니다.

반환

Doc Access 모델
DocAccess

문서 액세스 업데이트

작업 ID:
PatchDocsDocIdAccessesId

문서에 대한 액세스를 업데이트합니다.

매개 변수

Name 키 필수 형식 Description
허가
 access[permission] True string

사용 권한입니다.
문서 ID
 doc_id True integer

문서 식별자입니다.
아이디
 id True integer

식별자입니다.

반환

Doc Access 모델
DocAccess

문서 액세스 제거

작업 ID:
DeleteDocsDocIdAccessesId

문서에서 액세스 권한을 제거합니다.

매개 변수

Name 키 필수 형식 Description
문서 ID
 doc_id True integer

문서 식별자입니다.
아이디
 id True integer

식별자입니다.

문서 액세스 추가

작업 ID:
PostDocsDocIdAccesses

문서에 대한 액세스를 추가합니다.

매개 변수

Name 키 필수 형식 Description
허가
 access[permission] True string

사용 권한입니다.
접근자 유형
 access[accessor_type] True string

접근자 형식입니다.
접근자 ID
 access[accessor_id] True integer

접근자 식별자입니다.
문서 ID
 doc_id True integer

문서 식별자입니다.

반환

Doc Access 모델
DocAccess

문서 정보 가져오기

작업 ID:
GetDocsId

문서의 메타 정보를 검색합니다.

매개 변수

Name 키 필수 형식 Description
아이디
 id True integer

식별자입니다.

반환

문서 모델
Doc

문서 정보 바꾸기

작업 ID:
PutDocsId

문서의 메타 정보를 업데이트합니다.

매개 변수

Name 키 필수 형식 Description
제목
 doc[title] True string

문서의 제목입니다.
아이디
 id True integer

식별자입니다.

반환

문서 모델
Doc

문서 정보 업데이트

작업 ID:
PatchDocsId

문서의 메타 정보를 업데이트합니다.

매개 변수

Name 키 필수 형식 Description
제목
 doc[title] True string

문서의 제목입니다.
아이디
 id True integer

식별자입니다.

반환

문서 모델
Doc

사용자 가져오기

작업 ID:
GetUsers

사용자 목록을 검색합니다.

매개 변수

Name 키 필수 형식 Description
페이지
 page integer

가져올 페이지 오프셋입니다.
아이템
 items integer

페이지당 반환할 항목 수입니다.

반환

response
array of User

통합 문서 항목 삭제

작업 ID:
DeleteHandbooksHandbookIdItemsId

핸드북에서 항목을 삭제합니다.

매개 변수

Name 키 필수 형식 Description
아이디
 id True string

식별자입니다.
핸드북 ID
 handbook_id True integer

핸드북 식별자입니다.

파일 이동

작업 ID:
PostFilesMove

파일(문서 및/또는 폴더)을 특정 폴더(동일하거나 다른 작업 영역)로 이동합니다.

매개 변수

Name 키 필수 형식 Description
폴더 ID
 folder_ids[] array

폴더 식별자입니다.
문서 ID
 doc_ids[] array

문서 식별자입니다.
대상 폴더 ID
 destination_folder_id integer

대상 폴더 식별자입니다.
대상 작업 영역 ID
 destination_workspace_id integer

대상 작업 영역 식별자입니다.

폴더 가져오기

작업 ID:
GetFolders

모든 폴더 목록을 검색합니다.

매개 변수

Name 키 필수 형식 Description
페이지
 page integer

가져올 페이지 오프셋입니다.
아이템
 items integer

페이지당 반환할 항목 수입니다.
부모 폴더 ID
 parent_folder_id string

선택적 필터: 이 부모 폴더 ID가 있는 폴더만 표시합니다.

반환

response
array of Folder

폴더 만들기

작업 ID:
PostFolders

폴더를 만듭니다.

매개 변수

Name 키 필수 형식 Description
폴더 제목
 folder[title] True string

폴더 제목입니다.
부모 폴더 ID
 folder[parent_folder_id] integer

부모 폴더의 ID입니다. 제공되지 않은 경우 작업 영역 루트에서 만들어집니다.

반환

폴더 모델
Folder

폴더 정보 가져오기

작업 ID:
GetFoldersId

폴더 메타 정보 목록을 검색합니다.

매개 변수

Name 키 필수 형식 Description
아이디
 id True string

식별자입니다.

반환

폴더 모델
Folder

폴더 정보 바꾸기

작업 ID:
PutFoldersId

폴더 메타 정보를 대체합니다.

매개 변수

Name 키 필수 형식 Description
폴더 제목
 folder[title] True string

폴더 제목입니다.
아이디
 id True integer

식별자입니다.

반환

폴더 모델
Folder

폴더 정보 업데이트

작업 ID:
PatchFoldersId

폴더 메타 정보를 업데이트합니다.

매개 변수

Name 키 필수 형식 Description
폴더 제목
 folder[title] True string

폴더 제목입니다.
아이디
 id True integer

식별자입니다.

반환

폴더 모델
Folder

핸드북 가져오기

작업 ID:
GetHandbooks

작업 영역 핸드북 목록을 검색합니다.

매개 변수

Name 키 필수 형식 Description
페이지
 page integer

가져올 페이지 오프셋입니다.
아이템
 items integer

페이지당 반환할 항목 수입니다.

반환

response
array of Handbook

핸드북 항목 가져오기

작업 ID:
GetHandbooksHandbookIdItems

핸드북 항목 목록을 검색합니다.

매개 변수

Name 키 필수 형식 Description
페이지
 page integer

가져올 페이지 오프셋입니다.
아이템
 items integer

페이지당 반환할 항목 수입니다.
핸드북 ID
 handbook_id True integer

핸드북 식별자입니다.

반환

response
array of HandbookItem

핸드북 항목 만들기

작업 ID:
PostHandbooksHandbookIdItems

핸드북에 항목을 추가합니다.

매개 변수

Name 키 필수 형식 Description
항목 유형
 handbook_item[type] True string

핸드북 항목 유형입니다.
항목 위치
 handbook_item[position] integer

항목을 제공하지 않으면 마지막 위치로 추가합니다.
부모 항목 ID
 handbook_item[parent_item_id] integer

중첩을 위한 부모 항목 ID입니다.
문서 ID
 handbook_item[doc_id] True integer

문서 항목에만 필요합니다.
항목 제목
 handbook_item[title] True string

섹션 및 링크 항목에만 필요합니다.
항목 URL
 handbook_item[url] True string

링크 항목에만 필요합니다.
핸드북 ID
 handbook_id True integer

핸드북 식별자입니다.

반환

HandbookItem 모델
HandbookItem

정의

사용자

Name 경로 형식 Description
아이디
 id integer

식별자
이름 (First Name)
 first_name string

이름입니다.
성 이름
 last_name string

성입니다.

그룹

Name 경로 형식 Description
아이디
 id integer

식별자
이름
 name string

이름입니다.
Description
 description string

설명입니다.
접근성
 accessibility string

접근성입니다.

재산

Name 경로 형식 Description
아이디
 id integer

식별자
이름
 name string

이름입니다.
유형
 type string

형식입니다.
아티클의 기본값
 default_for_articles boolean

아티클의 기본값인지 여부입니다.
메타
 meta PropertyMeta
property_values
 property_values array of PropertyValue

PropertyMeta

Name 경로 형식 Description
숫자 형식
 number_format string

형식 번호의 속성에 대해서만 반환됩니다.
날짜 형식
 date_format string

형식 날짜의 속성에 대해서만 반환됨 및 관련
여러 사용자 멘션 허용
 allow_mentioning_multiple_people boolean

형식 사용자의 속성에 대해서만 반환됩니다.
사용자에게 알림
 notify_person boolean

형식 사용자의 속성에 대해서만 반환됩니다.

PropertyValue

Name 경로 형식 Description
아이디
 id integer

식별자
속성 ID
 property_id integer

속성 식별자입니다.
가치
 value string

값입니다.
메타
 meta PropertyValueMeta

PropertyValueMeta

Name 경로 형식 Description
색깔
 color string

형식 single_select 및 multi_select 속성에 대해서만 반환됩니다.

HandbookItem

Name 경로 형식 Description
아이디
 id integer

식별자
핸드북 ID
 handbook_id integer

핸드북 식별자입니다.
유형
 type string

형식입니다.
Position
 position integer

위치입니다.
제목
 title string

섹션 및 링크 항목에만 관련합니다.
URL
 url string

링크 항목에만 해당합니다.
부모 항목 ID
 parent_item_id integer

항목이 중첩된 경우 null이 아닌 경우
문서 ID
 doc_id integer

문서 항목에만 해당합니다.

편람

Name 경로 형식 Description
아이디
 id integer

식별자
이름
 name string

이름입니다.

폴더

Name 경로 형식 Description
아이디
 id integer

식별자
제목
 title string

제목입니다.
작업 영역 ID
 workspace_id integer

작업 영역 식별자입니다.
부모 폴더 ID
 parent_folder_id integer

부모 폴더 식별자입니다.

DocAccess

Name 경로 형식 Description
아이디
 id integer

식별자
문서 ID
 doc_id integer

문서 식별자입니다.
허가
 permission string

사용 권한입니다.
접근자 유형
 accessor_type string

접근자 형식입니다.
접근자 ID
 accessor_id integer

접근자 식별자입니다.
상속됨
 inherited boolean

상속 여부입니다.

DocProperty

Name 경로 형식 Description
아이디
 id integer

식별자
속성 모델
 property Property
가치
 value string

형식은 value 속성 형식에 따라 달라집니다. 'text', 'date', 'number', 'link' => String 'single_select' => { 'selected_item_id': Integer }, PropertyValue#ID 'multi_select' => { 'selected_item_ids': Array[Integer] }, 선택한 PropertyValue#ID 'checkbox' => { 'checked': Boolean } 'document' => { 'doc_id': Integer }, Document#ID 'person' => { 'user_ids': Array[Integer] }, User#IDs.

문서

Name 경로 형식 Description
아이디
 id integer

식별자
제목
 title string

제목입니다.
작업 영역 ID
 workspace_id integer

작업 영역 식별자입니다.
폴더 ID
 folder_id integer

폴더 식별자입니다.
담당자 ID
 owner_id integer

문서 소유자의 사용자 ID입니다.
만든 위치에서
 created_at string

서식이 지정된 datetime을 ISO8601.
업데이트 날짜
 updated_at string

서식이 지정된 datetime을 ISO8601.

Import

Name 경로 형식 Description
아이디
 id integer

식별자
status
 status string
문서 모델
 doc Doc