발표자 노트로 작업하기

이 가이드에서는 Google Slides API를 사용하여 발표자 메모를 읽고 수정하는 방법을 설명합니다.

메모 페이지 및 메모 마스터

메모 페이지는 프레젠테이션의 슬라이드 핸드아웃을 생성하는 데 사용되는 페이지의 한 유형입니다. 각 슬라이드에는 메모 페이지가 하나 있습니다. 슬라이드의 메모 페이지에 있는 첫 번째 BODY 자리표시자 도형에는 슬라이드의 발표자 메모 텍스트가 포함됩니다. 이 메모 도형의 텍스트 콘텐츠만 Slides API에서 수정할 수 있습니다. 다른 속성과 메모 페이지의 나머지 콘텐츠는 읽기 전용입니다.

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

발표자 노트 읽기 및 쓰기

슬라이드의 발표자 메모 도형을 찾으려면 SlideProperties 메시지에서 슬라이드의 메모 presentations.pages 객체를 찾습니다. 발표자 메모 텍스트가 포함된 도형은 메모 페이지의 NotesProperties 메시지에 있는 speakerNotesObjectId 필드로 식별됩니다.

슬라이드의 발표자 메모를 읽으려면 메모 페이지에서 이 ID가 있는 객체를 찾아 텍스트를 읽습니다. 드물지만 이 객체가 존재하지 않을 수 있습니다. 즉, 슬라이드에 발표자 메모가 없는 것입니다.

batchUpdate 텍스트 요청을 사용하여 발표자 메모 도형 내부의 텍스트를 수정할 수 있습니다. 스피커 메모 도형이 없는 드문 경우 Slides API는 speakerNotesObjectId를 사용하여 유효한 텍스트 작업을 수신하면 이를 자동으로 만듭니다.