OneNote(비즈니스)
OneNote는 모든 장치에서 아이디어, 스케치 및 노트를 쉽게 동기화할 수 있게 해주는 Microsoft의 노트 작성 앱입니다. 비즈니스용 OneDrive를 사용하여 Office 365 계정에 연결하여 새 섹션을 추적하고 노트를 만드는 등의 작업을 할 수 있습니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | 스탠다드 | 모든 Power Automate 지역 |
| 논리 앱 | 스탠다드 | 모든 Logic Apps 지역 |
| Power Apps | 스탠다드 | 모든 Power Apps 지역 |
| Power Automate | 스탠다드 | 모든 Power Automate 지역 |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | Microsoft |
| 웹 사이트 | https://products.office.com/onenote/digital-note-taking-app |
이 통합을 사용하려면 비즈니스용 OneDrive에 저장된 OneNote 전자 필기장 액세스 권한이 필요합니다. 연결을 만들려면 로그인을 선택합니다. O365 계정에 비즈니스용 OneDrive를 사용하도록 설정하라는 메시지가 표시됩니다. 화면의 나머지 부분에 따라 연결을 만듭니다.
알려진 문제 및 제한 사항
- 연결을 사용할 때 예상되는 전자 필기장 목록이 표시되지 않는 경우 연결을 만든 계정을 확인하고 다시 시도하세요. 커넥터를 사용하는 동안 오류가 표시되면 오류 코드를 조회하여 자세한 내용을 확인할 수 있습니다.
- 이 통합을 위해서는 "UserRemoteAPIs" 권한이 있는 계정과 연결해야 합니다. "오류: 사용자에게 요청된 리소스에 액세스할 수 있는 권한이 없습니다."라는 오류가 표시되면 계정에 올바른 권한이 없을 수 있습니다. SharePoint 관리자는 사이트 모음으로 이동하여 사이트 설정을 열어 사용 권한 수준을 제어할 수 있습니다. 사이트 사용 권한을 선택한 다음 사용 권한 수준을 선택하여 수준에 포함된 사용 권한(예: 원격 인터페이스 사용)을 확인합니다. 특정 수준에 속하는 사용자에게 필요한 권한이 없는 경우 사용 권한 확인란을 선택하여 수준을 수정하거나 새 사용 권한 수준을 만들고 사용자에게 할당합니다.
- 커넥터는 현재 페이지 만들기 작업에 대한 명시적 입력 매개 변수 페이지 제목을 지원하지 않습니다. 이는 OneNote API 구현에서 발생하는 제한 사항입니다. 그러나 제목/제목태그를 사용하여 HTML에서 페이지 콘텐츠의 일부로 제목><>을 <지정할 수 있습니다.
-
전자 필기장 섹션. Notebook 섹션 매개 변수에 대한 사용자 지정 값을 제공하려면 API URL 형식으로 지정하세요. api url 패턴:
https://www.onenote.com/api/v1.0/myOrganization/siteCollections/{siteCollectionsId}/sites/{SiteId}/notes/sections/{SectionId}/pages. 자세한 내용은 OneNote API 설명서를 참조하세요. -
빠른 노트 작업에서 페이지 만들기 는 다음 지역에서 지원되지 않습니다.
- Logic Apps:
- Azure Government
- Azure 중국 지역
- Power Automate 및 Power Apps:
- 미국 정부 기관용(GCC)
- 미국 정부 기관용(GCC High)
- 21Vianet에서 운영하는 중국 클라우드
- Logic Apps:
- 페이지 콘텐츠 가져오기 작업은 Power Apps에서 지원되지 않습니다. 그러나 이 작업은 Power Automate에서 지원됩니다.
비고
전자 필기장 이름에는 다음 문자가 허용되지 않습니다. *":<>?/|%
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
| 트리거 폴링 빈도 | 1 | 1200초 |
동작
| Notebook에서 섹션 가져오기 |
특정 전자 필기장 섹션을 가져옵니다. |
| Notebook에서 섹션 만들기 |
Notebook에서 섹션을 만듭니다. |
| 빠른 노트에서 페이지 만들기 |
빠른 노트 섹션에서 새 페이지를 만듭니다. |
| 섹션의 페이지 만들기 |
지정된 섹션에서 새 페이지를 만듭니다. |
| 최근 전자 필기장 가져오기 |
최근 전자 필기장을 가져옵니다. |
| 특정 섹션에 대한 페이지 가져오기 |
특정 섹션에 대한 페이지를 가져옵니다. |
| 페이지 삭제 |
페이지를 삭제합니다. |
| 페이지 콘텐츠 가져오기 |
HTML 페이지 콘텐츠를 가져옵니다. |
| 페이지 콘텐츠 업데이트 |
HTML 페이지 콘텐츠를 업데이트합니다. |
Notebook에서 섹션 가져오기
특정 전자 필기장 섹션을 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
Notebook 키
|
notebookKey | True | string |
Notebook을 식별하는 키입니다. 이는 API와 관련이 있으며 직접 입력할 수 없습니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
value
|
value | array of SectionListItem |
Notebook에서 섹션 만들기
Notebook에서 섹션을 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
Notebook 키
|
notebookKey | True | string |
Notebook을 식별하는 키입니다. 이는 API와 관련이 있으며 직접 입력할 수 없습니다. |
|
새 섹션의 이름
|
name | string |
새 섹션의 이름입니다. |
반환
빠른 노트에서 페이지 만들기
빠른 노트 섹션에서 새 페이지를 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
페이지 콘텐츠
|
pageContent | True | html |
페이지 콘텐츠입니다. |
반환
- 몸
- Page
섹션의 페이지 만들기
지정된 섹션에서 새 페이지를 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
Notebook 키
|
notebookKey | True | string |
Notebook을 식별하는 키입니다. 이는 API와 관련이 있으며 직접 입력할 수 없습니다. |
|
전자 필기장 섹션
|
sectionId | True | string |
섹션 페이지의 API URL입니다. |
|
페이지 콘텐츠
|
pageContent | True | html |
페이지 콘텐츠입니다. |
반환
- 몸
- Page
최근 전자 필기장 가져오기
특정 섹션에 대한 페이지 가져오기
특정 섹션에 대한 페이지를 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
Notebook 키
|
notebookKey | True | string |
Notebook을 식별하는 키입니다. 이는 API와 관련이 있으며 직접 입력할 수 없습니다. |
|
전자 필기장 섹션
|
sectionId | True | string |
섹션 페이지의 API URL입니다. |
반환
페이지 삭제
페이지를 삭제합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
Notebook 키
|
notebookKey | True | string |
Notebook을 식별하는 키입니다. 이는 API와 관련이 있으며 직접 입력할 수 없습니다. |
|
전자 필기장 섹션
|
sectionId | True | string |
섹션 페이지의 API URL입니다. |
|
페이지 ID
|
pageId | True | string |
페이지의 고유 ID입니다. |
페이지 콘텐츠 가져오기
HTML 페이지 콘텐츠를 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
Notebook 키
|
notebookKey | True | string |
Notebook을 식별하는 키입니다. 이는 API와 관련이 있으며 직접 입력할 수 없습니다. |
|
전자 필기장 섹션
|
sectionId | True | string |
섹션 페이지의 API URL입니다. |
|
페이지 ID
|
pageId | True | string |
페이지의 고유 ID입니다. |
반환
페이지 HTML 콘텐츠
- response
- string
페이지 콘텐츠 업데이트
HTML 페이지 콘텐츠를 업데이트합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
Notebook 키
|
notebookKey | True | string |
Notebook을 식별하는 키입니다. 이는 API와 관련이 있으며 직접 입력할 수 없습니다. |
|
전자 필기장 섹션
|
sectionId | True | string |
섹션 페이지의 API URL입니다. |
|
페이지 ID
|
pageId | True | string |
페이지의 고유 ID입니다. |
|
목표/타겟
|
target | string |
업데이트할 요소입니다. |
|
|
조치
|
action | string |
대상 요소에 대해 수행할 작업입니다. |
|
|
위치
|
position | string |
제공된 콘텐츠를 추가할 위치입니다. |
|
|
Content
|
content | html |
새 콘텐츠입니다. |
반환
페이지 HTML 콘텐츠
- response
- string
트리거
| 새 섹션 그룹이 만들어지는 경우 |
새 섹션 그룹이 Notebook에 추가되면 흐름을 트리거합니다. |
| 새 섹션이 만들어지는 경우 |
새 섹션이 Notebook에 추가되면 흐름을 트리거합니다. |
| 섹션에 새 페이지가 만들어지는 경우 |
섹션에 새 페이지가 추가되면 흐름을 트리거합니다. |
새 섹션 그룹이 만들어지는 경우
새 섹션 그룹이 Notebook에 추가되면 흐름을 트리거합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
Notebook 키
|
notebookKey | True | string |
Notebook을 식별하는 키입니다. 이는 API와 관련이 있으며 직접 입력할 수 없습니다. |
반환
새 섹션 그룹에 대한 응답입니다.
새 섹션이 만들어지는 경우
새 섹션이 Notebook에 추가되면 흐름을 트리거합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
Notebook 키
|
notebookKey | True | string |
Notebook을 식별하는 키입니다. 이는 API와 관련이 있으며 직접 입력할 수 없습니다. |
반환
새 섹션에 대한 응답입니다.
섹션에 새 페이지가 만들어지는 경우
섹션에 새 페이지가 추가되면 흐름을 트리거합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
Notebook 키
|
notebookKey | True | string |
Notebook을 식별하는 키입니다. 이는 API와 관련이 있으며 직접 입력할 수 없습니다. |
|
전자 필기장 섹션
|
sectionId | True | string |
섹션 페이지의 API URL입니다. |
반환
새 페이지에 대한 응답입니다.
정의
CreateSectionInNotebookResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
OData 컨텍스트
|
@odata.context | string |
OData 컨텍스트입니다. |
|
이름으로 생성됨
|
createdBy | string |
이름으로 만든 이 섹션입니다. |
|
생성 시간
|
createdTime | date-time |
이 섹션에서는 시간을 만들었습니다. |
|
Notebook 개체 ID에서 섹션 만들기
|
id | string | |
|
기본 섹션 플래그
|
isDefault | boolean |
기본 섹션인지를 나타내는 플래그입니다. |
|
마지막으로 수정한 사람
|
lastModifiedBy | string |
이름으로 마지막으로 수정했습니다. |
|
마지막으로 수정한 시간
|
lastModifiedTime | date-time |
이 섹션이 마지막으로 수정된 시간입니다. |
|
데스크톱 클라이언트 href
|
links.oneNoteClientUrl.href | string |
OneNote 데스크톱 클라이언트 href. |
|
웹 클라이언트 href
|
links.oneNoteWebUrl.href | string |
OneNote 웹 클라이언트 href. |
|
섹션 이름
|
name | string |
섹션의 이름입니다. |
|
페이지 URL
|
pagesUrl | string |
페이지의 URL입니다. |
|
Notebook에서 섹션을 만드는 URL
|
self | string |
전자 필기장 그룹에서 섹션을 만들 URL입니다. |
페이지
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
페이지 제목
|
title | string |
페이지의 제목입니다. |
|
links
|
links | Link |
OneNote 페이지와 연결된 링크입니다. |
|
콘텐츠 URL
|
contentUrl | string |
페이지 콘텐츠에 대한 URL입니다. |
|
마지막으로 수정한 날짜
|
lastModifiedTime | date-time |
페이지의 마지막 수정 날짜입니다. |
|
생성 날짜
|
createdTime | date-time |
페이지를 만든 날짜입니다. |
|
아이디
|
id | string |
페이지의 고유 식별자입니다. |
Notebook
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
파일명
|
FileName | string | |
|
Key
|
Key | string |
ParentNotebook
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
부모 전자 필기장 키
|
id | string |
부모 Notebook의 고유 식별자입니다. |
|
부모 전자 필기장 이름
|
name | string |
부모 전자 필기장의 이름입니다. |
|
부모 전자 필기장 URL
|
self | string |
부모 Notebook에 대한 URL 링크입니다. |
Link
OneNote 페이지와 연결된 링크입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
oneNoteClientUrl
|
oneNoteClientUrl | OneNoteClientUrl | |
|
oneNoteWebUrl
|
oneNoteWebUrl | OneNoteWebUrl |
OneNoteClientUrl
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
OneNote 클라이언트 URL
|
href | string |
OneNote Windows 클라이언트를 사용하는 전자 필기장 링크입니다. |
OneNoteWebUrl
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
OneNote 웹 URL
|
href | string |
OneNote 웹 클라이언트를 사용하는 전자 필기장 링크입니다. |
SectionListItem
섹션 목록 항목에 포함된 필드입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
섹션 이름
|
name | string |
섹션의 이름입니다. |
|
섹션 키
|
pagesUrl | string |
이 섹션을 참조하는 데 사용되는 키입니다. 은 페이지에 대한 URL이기도 합니다. |
|
섹션 식별자
|
id | string |
섹션의 고유 식별자입니다. |
SectionResponse
섹션에 포함된 필드입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
작성자
|
createdBy | string |
섹션의 작성자입니다. |
|
만든 날짜
|
createdTime | date-time |
섹션의 생성 날짜 및 시간입니다. |
|
섹션 식별자
|
id | string |
섹션의 고유 식별자입니다. |
|
마지막으로 수정한 사람
|
lastModifiedBy | string |
섹션을 마지막으로 수정한 사용자입니다. |
|
마지막으로 수정한 날짜
|
lastModifiedTime | date-time |
섹션의 마지막으로 수정된 날짜 및 시간입니다. |
|
섹션 이름
|
name | string |
섹션의 이름입니다. |
|
페이지 URL
|
pagesUrl | string |
이 섹션의 페이지에 대한 URL입니다. |
|
parentNotebook
|
parentNotebook | ParentNotebook | |
|
웹 주소
|
self | string |
이 섹션의 URL입니다. |
SectionGroupResponse
섹션 그룹에 포함된 필드입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
만든 날짜
|
createdTime | date-time |
섹션 그룹의 생성 날짜 및 시간입니다. |
|
작성자
|
createdBy | string |
섹션 그룹의 작성자입니다. |
|
식별자
|
id | string |
섹션 그룹의 고유 식별자입니다. |
|
마지막 한정자
|
lastModifiedBy | string |
섹션 그룹을 마지막으로 수정한 사용자입니다. |
|
마지막으로 수정한 날짜
|
lastModifiedTime | date-time |
섹션 그룹의 마지막 수정 날짜 및 시간입니다. |
|
이름
|
name | string |
섹션 그룹의 이름입니다. |
|
섹션 URL
|
sectionsUrl | string |
이 섹션 그룹 내의 섹션 URL입니다. |
|
섹션 그룹 URL
|
self | string |
이 섹션 그룹의 URL입니다. |
NewSectionResponse
새 섹션에 대한 응답입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Sections
|
value | array of SectionResponse |
각각 특정 섹션을 나타내는 개체의 배열입니다. |
NewSectionGroupResponse
새 섹션 그룹에 대한 응답입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
섹션 그룹
|
value | array of SectionGroupResponse |
각각 특정 섹션 그룹을 나타내는 개체의 배열입니다. |
NewPageResponse
새 페이지에 대한 응답입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
페이지
|
value | array of Page |
각각 특정 페이지를 나타내는 개체의 배열입니다. |
GetPagesInSectionResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
OData 컨텍스트
|
@odata.context | string |
OData 컨텍스트입니다. |
|
섹션 값 개체의 Pages
|
value | array of object |
value |
|
콘텐츠 URL
|
value.contentUrl | string |
콘텐츠 URL입니다. |
|
앱 ID로 생성됨
|
value.createdByAppId | string |
앱 ID로 만든 것입니다. |
|
생성 시간
|
value.createdTime | date-time |
이 응답에 대해 만든 시간입니다. |
|
응답에 대한 고유 식별자
|
value.id | string |
이 응답의 고유 식별자입니다. |
|
마지막으로 수정한 시간
|
value.lastModifiedTime | date-time |
이 개체에 대해 마지막으로 수정한 시간입니다. |
|
OneNote 데스크톱 클라이언트 href
|
value.links.oneNoteClientUrl.href | string |
OneNote 데스크톱 클라이언트 href. |
|
OneNote 웹 클라이언트 href
|
value.links.oneNoteWebUrl.href | string |
OneNote 웹 클라이언트 href. |
|
부모 섹션 고유 식별자
|
value.parentSection.id | string |
이 개체 부모 섹션의 고유 식별자입니다. |
|
부모 섹션 이름
|
value.parentSection.name | string | |
|
섹션 부모 섹션의 페이지
|
value.parentSection.self | string |
섹션 부모 섹션의 페이지에 대한 URL입니다. |
|
부모 섹션 OData 컨텍스트
|
value.parentSection@odata.context | string |
부모 섹션 OData 컨텍스트입니다. |
|
섹션 그룹의 페이지
|
value.self | string |
섹션 내 페이지 그룹의 URL입니다. |
|
페이지 제목
|
value.title | string |
페이지 제목입니다. |
문자열
기본 데이터 형식 'string'입니다.