발표자 노트로 작업하기
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이 가이드에서는 Google Slides API를 사용하여 발표자 메모를 읽고 수정하는 방법을 설명합니다.
메모 페이지 및 메모 마스터
메모 페이지는 프레젠테이션의 슬라이드용 유인물을 생성하는 데 사용되는 페이지의 일종입니다. 각 슬라이드에는 메모 페이지가 하나씩 있습니다. 슬라이드의 메모 페이지에 있는 첫 번째 BODY 자리표시자 도형에는 슬라이드의 발표자 메모 텍스트가 포함됩니다. 이 메모 모양의 텍스트 콘텐츠만 Slides API에서 수정할 수 있습니다. 다른 속성과 나머지 메모 페이지 콘텐츠는 읽기 전용입니다.
프레젠테이션의 메모 마스터는 메모 페이지에 사용되는 기본 요소와 텍스트 스타일을 정의하는 페이지입니다. 프레젠테이션에는 하나의 메모 마스터만 있습니다. Slides API에서 메모 마스터는 읽기 전용입니다.
발표자 노트 읽기 및 쓰기
슬라이드의 발표자 노트 도형을 찾으려면 SlideProperties 메시지에서 슬라이드의 노트 presentations.pages 객체를 찾습니다. 발표자 메모 텍스트가 포함된 도형은 메모 페이지의 NotesProperties 메시지에 있는 speakerNotesObjectId 필드로 식별됩니다.
슬라이드의 발표자 메모를 읽으려면 메모 페이지에서 이 ID가 있는 객체를 찾아 텍스트를 읽습니다. 드물지만 이 객체가 없을 수 있으며, 이는 슬라이드에 발표자 노트가 없음을 의미합니다.
batchUpdate 텍스트 요청을 사용하여 발표자 메모 도형 내의 텍스트를 수정할 수 있습니다. 드물지만 발표자 메모 모양이 없는 경우 Slides API는 speakerNotesObjectId를 사용하여 유효한 텍스트 작업을 수신할 때 자동으로 만듭니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-29(UTC)
[null,null,["최종 업데이트: 2025-08-29(UTC)"],[],[],null,["# Work with speaker notes\n\nThis guide explains how to read and edit speaker notes using the Google Slides API.\n\nNotes pages and notes masters\n-----------------------------\n\nA notes page is a kind of page used for generating handouts for slides in a\npresentation. Each slide has one notes page. The first `BODY` placeholder shape\non a slide's notes page contains the text of a slide's speaker notes. Only the\ntext content of this notes shape is editable in Slides API. Its other\nproperties and the rest of the notes page contents are read-only.\n\nThe presentation's notes master is a page that defines the default elements and\ntext styles used on notes pages. A presentation only has one notes master. Notes\nmasters are read-only in the Slides API.\n\nRead and write speaker notes\n----------------------------\n\nTo find a slide's speaker note shape, find the slide's notes\n[`presentations.pages`](/workspace/slides/api/reference/rest/v1/presentations.pages)\nobject in its\n[`SlideProperties`](/workspace/slides/api/reference/rest/v1/presentations.pages#slideproperties)\nmessage. The shape containing the speaker notes text is identified by the\n`speakerNotesObjectId` field in the notes page's\n[`NotesProperties`](/workspace/slides/api/reference/rest/v1/presentations.pages#notesproperties)\nmessage.\n\nTo read a slide's speaker notes, find an object with this ID on the notes page\nand read its [text](/workspace/slides/api/concepts/text). In rare cases, this\nobject might not exist which means the slides have no speaker notes.\n\nYou can use [`batchUpdate`](/workspace/slides/api/guides/styling) text requests\nto modify the text inside the speaker notes shape. In the rare case where the\nspeaker notes shape doesn't exist, the Slides API creates it\nautomatically when it receives a valid text operation using a\n`speakerNotesObjectId`."]]
