발표자 노트 사용하기

이 페이지에서는 Slides API를 사용하여 발표자 노트를 읽고 수정하는 방법을 설명합니다.

슬라이드 노트 페이지 및 슬라이드 노트 마스터

슬라이드 노트는 프레젠테이션에서 슬라이드용 참고 자료를 생성하기 위해 사용되는 페이지입니다. 슬라이드마다 슬라이드 노트가 한 개씩 있습니다. 슬라이드 발표자 노트의 텍스트는 슬라이드 노트 페이지의 첫 번째 BODY 자리표시자 도형에 포함됩니다. 이 노트 도형의 텍스트 콘텐츠만 Slides API에서 수정할 수 있습니다. 노트 도형의 다른 속성들과 슬라이드 노트 콘텐츠 중 나머지는 읽기 전용입니다.

프레젠테이션의 슬라이드 노트 마스터는 슬라이드 노트에 사용되는 기본 요소와 텍스트 스타일을 정의하는 페이지입니다. 슬라이드 노트 마스터는 프레젠테이션마다 하나씩만 있습니다. 슬라이드 노트 마스터는 Slides API에서 읽기 전용입니다.

발표자 노트 읽기 및 쓰기

슬라이드의 발표자 노트 도형을 찾으려면 SlideProperties 메시지에서 슬라이드의 노트 Page를 찾습니다. 발표자 노트 텍스트를 포함한 도형은 슬라이드 노트의 NotesProperties 메시지에 있는 speakerNotesObjectId 필드로 식별됩니다.

슬라이드의 발표자 노트를 읽으려면 슬라이드 노트에서 이 ID로 객체를 찾아 텍스트를 읽으면 됩니다. 드물게 이 객체가 존재하지 않는 경우도 있는데, 이는 슬라이드에 발표자 노트가 없다는 뜻입니다.

text batchUpdate 요청을 사용하여 발표자 노트 도형 내의 텍스트를 수정할 수 있습니다. 드물긴 하지만 발표자 노트 도형이 존재하지 않는 경우, Slides API는 speakerNotesObjectId를 사용하여 유효한 텍스트 작업 확인 시 자동으로 발표자 노트 도형을 생성합니다.