다음을 통해 공유

개념(독립 게시자)

개념 커넥터는 API를 사용하여 Notion의 페이지, 데이터베이스 및 사용자에 액세스합니다.

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

서비스 클래스 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://github.com/sekharmalla
전자 메일 chandra.malla@msftcommunity.com
커넥터 메타데이터
게시자 찬드라 세카르 & 하시니 바르마
웹 사이트 https://www.notion.so/
개인 정보 보호 정책 https://www.notion.so/Privacy-Policy-3468d120cf614d4c9014c09f6adc9091
카테고리 생산력; 합작

연결을 만드는 중

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

기본값

적용 가능: 모든 지역

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

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

이름 유형 Description 필수
API 키 시큐어스트링 (보안 문자열) 이 API의 API 키 진실

제한 한도

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

동작

Search

통합과 공유되는 모든 페이지 및 자식 페이지를 검색합니다. 결과에는 데이터베이스가 포함될 수 있습니다.
데이터베이스 검색

지정된 ID를 사용하여 Database 개체를 검색합니다.
데이터베이스 쿼리

요청에 제공된 필터 조건 및 정렬 조건에 따라 필터링 및 정렬된 데이터베이스에 포함된 페이지 목록을 가져옵니다.
메모 검색

페이지 또는 블록에서 확인되지 않은 Comment 개체 목록을 검색합니다.
메모 만들기

페이지 또는 기존 토론 스레드에 메모를 만듭니다.
모든 사용자 목록

작업 영역에 대한 페이지를 매긴 사용자 목록을 반환합니다.
블록 검색

지정된 ID를 사용하여 Block 개체를 검색합니다.
블록 삭제

페이지 블록을 포함한 Block 개체를 보관할 수 있도록 설정합니다. 지정된 ID를 사용하여 true입니다. 참고: Notion UI 애플리케이션에서 블록은 여전히 액세스하고 복원할 수 있는 "휴지통"으로 이동합니다.
블록 업데이트

블록 형식에 따라 지정된 block_id 대한 콘텐츠를 업데이트합니다. 블록 개체 형식에 따라 지원되는 필드
블록 자식 검색

지정된 ID를 사용하여 블록에 포함된 자식 블록 개체의 페이지를 매긴 배열을 반환합니다.
블록 자식 추가

지정된 부모 block_id 새 자식 블록을 만들고 추가합니다.
사용자 검색

지정된 ID를 사용하여 사용자를 검색합니다.
토큰의 봇 사용자 검색

권한 부여 헤더에 제공된 API 토큰과 연결된 봇 사용자를 검색합니다. 봇에는 통합 권한을 부여한 사람에 대한 정보가 포함된 소유자 필드가 있습니다.
페이지 검색

지정한 ID를 사용하여 Page 개체를 검색합니다.
페이지 만들기

지정된 데이터베이스에 새 페이지를 만듭니다. 기존 페이지입니다.
페이지 속성 항목 검색

페이지 속성 항목 검색
작업 ID:
Search

통합과 공유되는 모든 페이지 및 자식 페이지를 검색합니다. 결과에는 데이터베이스가 포함될 수 있습니다.

매개 변수

Name 키 필수 형식 Description
Query
 query True string

제공되면 쿼리를 페이지 제목과 비교하여 반환되는 페이지를 제한합니다.
방향
 direction string

정렬할 방향입니다. 가능한 값은 오름차순 및 내림차순입니다.
시간표시
 timestamp string

정렬할 타임스탬프의 이름입니다. 가능한 값은 last_edited_time 포함합니다.

반환

Name 경로 형식 Description
아이디
 id string

블록의 식별자입니다.
생성 시간
 created_time string

이 페이지를 만든 날짜 및 시간입니다.
마지막으로 편집한 시간
 last_edited_time string

이 페이지가 업데이트된 날짜 및 시간입니다.
일반 텍스트
 plain_text string

주석이 없는 일반 텍스트입니다.
태그들
 Tags object

tags 개체에는 태그 목록이 포함됩니다.
URL
 url string

개체의 URL입니다.
다음 커서
 next_cursor string

결과의 다음 페이지를 요청하는 데 사용되는 커서가 반환됩니다. 불투명 값으로 처리
더 많은 것이 있습니다.
 has_more boolean

블록에 더 많은 블록이 있는지 여부

데이터베이스 검색

작업 ID:
Retrieve_a_database

지정된 ID를 사용하여 Database 개체를 검색합니다.

매개 변수

Name 키 필수 형식 Description
데이터베이스 ID
 database_id True string

Notion 데이터베이스의 식별자

반환

몸
DatabaseResponse

데이터베이스 쿼리

작업 ID:
Query_a_database

요청에 제공된 필터 조건 및 정렬 조건에 따라 필터링 및 정렬된 데이터베이스에 포함된 페이지 목록을 가져옵니다.

매개 변수

Name 키 필수 형식 Description
데이터베이스 ID
 database_id True string

Notion 데이터베이스의 식별자입니다.

반환

몸
DatabaseResponse

메모 검색

작업 ID:
Retrievecomments

페이지 또는 블록에서 확인되지 않은 Comment 개체 목록을 검색합니다.

매개 변수

Name 키 필수 형식 Description
블록 ID
 block_id True string

개념 블록 또는 페이지의 식별자

반환

몸
CommentResponse

메모 만들기

작업 ID:
Createcomment

페이지 또는 기존 토론 스레드에 메모를 만듭니다.

매개 변수

Name 키 필수 형식 Description
페이지 ID
 page_id string

페이지의 식별자
토론 ID
 discussion_id string

개념 블록의 식별자
Content
 content string

텍스트 콘텐츠입니다. 이 필드에는 텍스트의 실제 내용이 포함되며 가장 자주 사용할 필드일 수 있습니다.

반환

몸
CommentResponse

모든 사용자 목록

작업 ID:
List_of_all_users

작업 영역에 대한 페이지를 매긴 사용자 목록을 반환합니다.

매개 변수

Name 키 필수 형식 Description
페이지 크기
 page_size integer

응답에 원하는 전체 목록의 항목 수입니다. 최대값: 100

반환

Name 경로 형식 Description
아이디
 id string

개념 블록의 식별자
표시 이름
 name string

사용자 이름이 Notion에 표시됩니다.
아바타 URL
 avatar_url string

선택한 아바타 이미지입니다.
유형
 type string

사용자의 유형입니다. 가능한 값은 "person" 및 "bot"입니다.
전자 메일
 email string

사용자의 전자 메일 주소입니다.
다음 커서
 next_cursor string

결과의 다음 페이지를 요청하는 데 사용되는 커서가 반환됩니다. 불투명 값으로 처리
더 많은 것이 있습니다.
 has_more boolean

응답에 목록의 끝이 포함된 경우

블록 검색

작업 ID:
Retrieveablock

지정된 ID를 사용하여 Block 개체를 검색합니다.

매개 변수

Name 키 필수 형식 Description
블록 ID
 blockId True string

블록의 식별자입니다.

반환

Name 경로 형식 Description
객체
 object string

객체
아이디
 id string

블록의 식별자입니다.
생성 시간
 created_time date-time

이 블록을 만든 날짜 및 시간입니다.
마지막으로 편집한 시간
 last_edited_time date-time

이 블록이 마지막으로 업데이트된 날짜 및 시간입니다.
Object
 created_by.object string

항상 "user"
아이디
 created_by.id string

이 사용자의 고유 식별자입니다.
Object
 last_edited_by.object string

마지막으로 편집한 사용자
아이디
 last_edited_by.id string

이 사용자의 고유 식별자입니다.
자식이 있습니다.
 has_children boolean

블록에 자식 블록이 중첩되어 있는지 여부입니다.
Archived
 archived boolean

블록의 보관된 상태입니다.
유형
 type string

형식별 블록 정보를 포함하는 개체

블록 삭제

작업 ID:
Deleteablock

페이지 블록을 포함한 Block 개체를 보관할 수 있도록 설정합니다. 지정된 ID를 사용하여 true입니다. 참고: Notion UI 애플리케이션에서 블록은 여전히 액세스하고 복원할 수 있는 "휴지통"으로 이동합니다.

매개 변수

Name 키 필수 형식 Description
블록 ID
 blockId True string

개념 블록의 식별자

반환

Name 경로 형식 Description
아이디
 id string

블록의 식별자입니다.
생성 시간
 created_time date-time

이 블록을 만든 날짜 및 시간입니다.
마지막으로 편집한 시간
 last_edited_time date-time

이 블록이 마지막으로 업데이트된 날짜 및 시간입니다.
Object
 created_by.object string

항상 "user"
아이디
 created_by.id string

이 사용자의 고유 식별자입니다.
Object
 last_edited_by.object string

마지막으로 편집한 사용자
아이디
 last_edited_by.id string

이 사용자의 고유 식별자입니다.
자식이 있습니다.
 has_children boolean

블록에 자식 블록이 중첩되어 있는지 여부입니다.
Archived
 archived boolean

블록의 보관된 상태입니다.
유형
 type string

형식별 블록 정보를 포함하는 개체

블록 업데이트

작업 ID:
Updateablock

블록 형식에 따라 지정된 block_id 대한 콘텐츠를 업데이트합니다. 블록 개체 형식에 따라 지원되는 필드

매개 변수

Name 키 필수 형식 Description
블록 ID
 blockId True string

개념 블록의 식별자
Content
 content string

텍스트 콘텐츠입니다. 이 필드에는 텍스트의 실제 내용이 포함되며 가장 자주 사용할 필드일 수 있습니다.
색깔
 color string

블록의 색입니다.
Content
 content string

텍스트 콘텐츠입니다. 이 필드에는 텍스트의 실제 내용이 포함되며 가장 자주 사용할 필드일 수 있습니다.
색깔
 color string

블록의 색입니다.
Content
 content string

텍스트 콘텐츠2. 이 필드에는 텍스트의 실제 내용이 포함되며 가장 자주 사용할 필드일 수 있습니다.
색깔
 color string

블록의 색입니다.
Content
 content string

텍스트 콘텐츠입니다. 이 필드에는 텍스트의 실제 내용이 포함되며 가장 자주 사용할 필드일 수 있습니다.
색깔
 color string

색상
Contents1
 content string

텍스트 콘텐츠입니다. 이 필드에는 텍스트의 실제 내용이 포함되며 가장 자주 사용할 필드일 수 있습니다.
색깔
 color string

블록의 색입니다.
Contents1
 content string

텍스트 콘텐츠입니다. 이 필드에는 텍스트의 실제 내용이 포함되며 가장 자주 사용할 필드일 수 있습니다.
색깔
 color string

블록의 색입니다.
Contents1
 content string

텍스트 콘텐츠입니다. 이 필드에는 텍스트의 실제 내용이 포함되며 가장 자주 사용할 필드일 수 있습니다.
체크됨
 checked boolean

to_do 확인되었는지 여부입니다.
색깔
 color string

블록의 색입니다.

블록 자식 검색

작업 ID:
Retrieve_block_children

지정된 ID를 사용하여 블록에 포함된 자식 블록 개체의 페이지를 매긴 배열을 반환합니다.

매개 변수

Name 키 필수 형식 Description
블록 ID
 block_id True string

블록의 식별자
페이지 크기
 page_size integer

응답에 원하는 전체 목록의 항목 수입니다. 최대값: 100

반환

Name 경로 형식 Description
아이디
 items.id string

블록의 식별자입니다.
생성 시간
 items.created_time date-time

이 블록을 만든 날짜 및 시간입니다.
마지막으로 편집한 시간
 items.last_edited_time date-time

이 블록이 마지막으로 업데이트된 날짜 및 시간입니다.
자식이 있습니다.
 items.has_children boolean

블록에 자식 블록이 중첩되어 있는지 여부입니다.
Archived
 items.archived boolean

블록의 보관된 상태입니다.
유형
 items.type string

블록의 형식입니다. 가능한 값
일반 텍스트
 plain_text string

단락 블록 plain_text 일반 텍스트
다음 커서
 next_cursor string

결과의 다음 페이지를 요청하는 데 사용되는 커서가 반환됩니다. 불투명 값으로 처리
더 많은 것이 있습니다.
 has_more boolean

블록에 더 많은 블록이 있는지 여부

블록 자식 추가

작업 ID:
Appendblockchildren

지정된 부모 block_id 새 자식 블록을 만들고 추가합니다.

매개 변수

Name 키 필수 형식 Description
블록 ID
 block_id True string

블록의 식별자
객체
 object string

객체
type
 type string

type
type
 type string

type
내용
 content string

내용
type
 type string

type
내용
 content string

내용
url
 url string

url

사용자 검색

작업 ID:
Retrieveuser

지정된 ID를 사용하여 사용자를 검색합니다.

매개 변수

Name 키 필수 형식 Description
사용자 ID
 user_id True string

이 사용자의 고유 식별자입니다.

반환

Name 경로 형식 Description
아이디
 id string

개념 사용자에 대한 식별자
사용자 이름
 name string

사용자의 이름
아바타 URL
 avatar_url string

선택한 아바타 이미지
전자 메일
 email string

사용자의 전자 메일 주소입니다.

토큰의 봇 사용자 검색

작업 ID:
RetrieveYourTokensBotUser

권한 부여 헤더에 제공된 API 토큰과 연결된 봇 사용자를 검색합니다. 봇에는 통합 권한을 부여한 사람에 대한 정보가 포함된 소유자 필드가 있습니다.

반환

Name 경로 형식 Description
아이디
 id string

이 사용자의 고유 식별자입니다.
이름
 name string

Notion에 표시된 사용자 이름입니다.
아바타 URL
 avatar_url string

선택한 아바타 이미지입니다.
유형
 type string

사용자의 유형입니다. 가능한 값은 "person" 및 "bot"입니다.
소유자 유형
 bot.owner.type string

소유자 유형입니다. "작업 영역" 또는 "사용자"입니다.

페이지 검색

작업 ID:
Retrieveapage

지정한 ID를 사용하여 Page 개체를 검색합니다.

매개 변수

Name 키 필수 형식 Description
페이지 ID
 page_id True string

개념 페이지의 식별자

반환

Name 경로 형식 Description
아이디
 id string

페이지의 고유 식별자입니다.
생성 시간
 created_time string

이 페이지를 만든 날짜 및 시간입니다. ISO 8601 날짜 시간 문자열로 서식이 지정됩니다.
마지막으로 편집한 시간
 last_edited_time string

이 페이지가 업데이트된 날짜 및 시간입니다. ISO 8601 날짜 시간 문자열로 서식이 지정됩니다.
아이디
 created_by.id string

이 사용자의 고유 식별자입니다.
아이디
 last_edited_by.id string

이 사용자의 고유 식별자입니다.
url
 cover.url string

외부에 호스트된 이미지에 연결합니다.
이모지
 icon.emoji string

이모지 문자입니다.
데이터베이스_아이디
 parent.database_id string

데이터베이스_아이디
보관
 archived boolean

페이지의 보관된 상태입니다.
URL
 url string

개념 페이지의 URL입니다.

페이지 만들기

작업 ID:
CreateaPage

지정된 데이터베이스에 새 페이지를 만듭니다. 기존 페이지입니다.

매개 변수

Name 키 필수 형식 Description
데이터베이스 ID
 database_id True string

데이터베이스의 고유 식별자입니다.
이모티콘
 emoji string

이모지
커버 URL
 url string

페이지 표지 이미지 URL입니다.
속성
 properties object

Notion에 표시되는 데이터베이스 속성의 스키마입니다.

반환

Name 경로 형식 Description
아이디
 id string

페이지의 고유 식별자입니다.
생성 시간
 created_time string

이 페이지를 만든 날짜 및 시간입니다. ISO 8601 날짜 시간 문자열로 서식이 지정됩니다.
마지막으로 편집한 시간
 last_edited_time string

이 페이지가 업데이트된 날짜 및 시간입니다. ISO 8601 날짜 시간 문자열로 서식이 지정됩니다.
아이디
 created_by.id string

이 사용자의 고유 식별자입니다.
아이디
 last_edited_by.id string

이 사용자의 고유 식별자입니다.
url
 cover.url string

외부에 호스트된 이미지에 연결합니다.
이모지
 icon.emoji string

이모지 문자입니다.
데이터베이스_아이디
 parent.database_id string

데이터베이스_아이디
보관
 archived boolean

페이지의 보관된 상태입니다.
URL
 url string

개념 페이지의 URL입니다.

페이지 속성 항목 검색

작업 ID:
Retrieveapagepropertyitem

페이지 속성 항목 검색

매개 변수

Name 키 필수 형식 Description
페이지 ID
 page_id True string

개념 페이지의 식별자
속성 ID
 property_id True string

페이지 속성의 식별자

반환

Name 경로 형식 Description
Object
 object string

항상 나열합니다.
더 많은 것이 있습니다.
 has_more boolean

응답에 목록의 끝이 포함되면 false입니다. 그렇지 않으면 true입니다.

정의

CommentResponse

Name 경로 형식 Description
아이디
 id string

주석의 고유 식별자입니다.
페이지 ID
 parent.page_id string

이 페이지가 속한 페이지의 ID입니다.
토론 ID
 discussion_id string

주석이 연결된 토론 스레드의 고유 식별자입니다.
생성 시간
 created_time string

이 주석이 만들어진 날짜 및 시간입니다.
마지막으로 편집한 시간
 last_edited_time string

이 주석이 업데이트된 날짜 및 시간입니다.
객체
 created_by.object string

객체
아이디
 created_by.id string

아이디
서식 있는 텍스트
rich_text array of object

서식 있는 텍스트 서식, 링크 및 멘션을 지원하는 주석의 콘텐츠입니다.
type
 rich_text.type string

type
Content
 rich_text.text.content string

텍스트 콘텐츠입니다.
Link
 rich_text.text.link string

이 텍스트의 모든 인라인 링크입니다.
일반 텍스트
 rich_text.plain_text string

주석이 없는 일반 텍스트입니다.
href
 rich_text.href string

(선택 사항) 이 텍스트에 있는 링크 또는 내부 개념 멘션의 URL(있는 경우)입니다.

DatabaseResponse

Name 경로 형식 Description
results
 results array of object
Object
 results.object string

페이지 또는 '데이터베이스'
아이디
 results.id string

데이터베이스의 고유 식별자입니다.
생성 시간
 results.created_time string

이 데이터베이스를 만든 날짜 및 시간입니다. ISO 8601 날짜 시간 문자열로 서식이 지정됩니다.
마지막으로 편집한 시간
 results.last_edited_time string

이 데이터베이스가 업데이트된 날짜 및 시간입니다. ISO 8601 날짜 시간 문자열로 서식이 지정됩니다.
Object
 results.created_by.object string

데이터베이스를 만든 사용자입니다.
아이디
 results.created_by.id string

사용자의 고유 식별자
Object
 results.last_edited_by.object string

데이터베이스를 만든 사용자입니다.
아이디
 results.last_edited_by.id string

사용자의 고유 식별자
Archived
 results.archived boolean

데이터베이스의 보관된 상태입니다.
URL
 results.url string

Notion 데이터베이스의 URL