이 가이드에서는 Google Slides API를 사용하여 발표자 노트를 읽고 수정하는 방법을 설명합니다.
노트 페이지 및 노트 마스터
노트 페이지는 프레젠테이션의 슬라이드에 대한 유인물을 생성하는 데 사용되는 페이지의 한 종류입니다. 각 슬라이드에는 노트 페이지가 하나씩 있습니다. 슬라이드의 노트 페이지에 있는 첫 번째 BODY 자리표시자 도형에는 슬라이드의 발표자 노트 텍스트가 포함됩니다. 이 노트 도형의 텍스트 콘텐츠만 Slides API에서 수정할 수 있습니다. 다른 속성과 나머지 노트 페이지 콘텐츠는 읽기 전용입니다.
프레젠테이션의 노트 마스터는 노트 페이지에 사용되는 기본 요소와 텍스트 스타일을 정의하는 페이지입니다. 프레젠테이션에는 노트 마스터가 하나만 있습니다. 노트 마스터는 Slides API에서 읽기 전용입니다.
발표자 노트 읽기 및 쓰기
슬라이드의 발표자 노트 도형을 찾으려면 슬라이드의 노트
presentations.pages
객체를
SlideProperties
메시지에서 찾습니다. 발표자 노트 텍스트가 포함된 도형은 노트 페이지의
speakerNotesObjectId 필드에 있는
NotesProperties
메시지로 식별됩니다.
슬라이드의 발표자 노트를 읽으려면 노트 페이지에서 이 ID가 있는 객체를 찾아 텍스트를 읽습니다. 드물지만 이 객체가 존재하지 않을 수 있습니다. 즉, 슬라이드에 발표자 노트가 없는 것입니다.
batchUpdate 텍스트 요청
을 사용하여 발표자 노트 도형 내의 텍스트를 수정할 수 있습니다. 발표자 노트 도형이 없는 드문 경우, Slides API는 speakerNotesObjectId를 사용하여 유효한 텍스트 작업을 수신할 때 자동으로 도형을 만듭니다.