ทำงานกับบันทึกของผู้บรรยาย
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
คู่มือนี้อธิบายวิธีอ่านและแก้ไขบันทึกของผู้บรรยายโดยใช้ Google Slides API
หน้าโน้ตและต้นแบบโน้ต
หน้าหมายเหตุเป็นหน้าประเภทหนึ่งที่ใช้สร้างเอกสารประกอบสำหรับสไลด์ในงานนำเสนอ สไลด์แต่ละรายการจะมีหน้าหมายเหตุ 1 หน้า รูปร่างตัวยึดตำแหน่ง BODY
แรก
ในหน้าหมายเหตุของสไลด์จะมีข้อความของหมายเหตุสำหรับผู้พูดของสไลด์ คุณจะแก้ไขได้เฉพาะ
เนื้อหาข้อความของรูปร่างโน้ตนี้ใน Slides API ส่วนพร็อพเพอร์ตี้อื่นๆ
และเนื้อหาที่เหลือของหน้าบันทึกจะเป็นแบบอ่านอย่างเดียว
มาสเตอร์โน้ตของงานนำเสนอคือหน้าที่กำหนดองค์ประกอบเริ่มต้นและ
รูปแบบข้อความที่ใช้ในหน้าโน้ต งานนำเสนอมีต้นแบบโน้ตได้เพียงรายการเดียว หมายเหตุ
มาสเตอร์จะอ่านอย่างเดียวใน Slides API
อ่านและเขียนบันทึกของผู้บรรยาย
หากต้องการค้นหารูปร่างของบันทึกของผู้บรรยายของสไลด์ ให้ค้นหาโน้ตของสไลด์
presentations.pages
ออบเจ็กต์ในข้อความ
SlideProperties
รูปร่างที่มีข้อความหมายเหตุของผู้พูดจะระบุโดยฟิลด์
speakerNotesObjectId
ในข้อความ
NotesProperties
ของหน้าหมายเหตุ
หากต้องการอ่านหมายเหตุของผู้พูดของสไลด์ ให้ค้นหาออบเจ็กต์ที่มีรหัสนี้ในหน้าหมายเหตุ
แล้วอ่านข้อความของออบเจ็กต์ ในบางกรณีที่เกิดขึ้นไม่บ่อยนัก
ออบเจ็กต์นี้อาจไม่มีอยู่ ซึ่งหมายความว่าสไลด์ไม่มีบันทึกของผู้บรรยาย
คุณใช้คำขอข้อความ batchUpdate
เพื่อแก้ไขข้อความภายในรูปร่างหมายเหตุของผู้พูดได้ ในกรณีที่หายากซึ่งไม่มี
รูปร่างหมายเหตุของผู้พูด Slides API จะสร้างรูปร่างดังกล่าว
โดยอัตโนมัติเมื่อได้รับข้อความที่ถูกต้องโดยใช้
speakerNotesObjectId
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ 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`."]]