Làm việc với ghi chú của người thuyết trình

Hướng dẫn này giải thích cách đọc và chỉnh sửa ghi chú của người thuyết trình bằng Google Slides API.

Trang ghi chú và mẫu ghi chú

Trang ghi chú là một loại trang dùng để tạo tài liệu phát cho các trang trình bày trong một bản trình bày. Mỗi trang chiếu có một trang ghi chú. Hình giữ chỗ BODY đầu tiên trên trang ghi chú của một trang trình bày chứa văn bản của ghi chú của người nói trong trang trình bày. Chỉ có thể chỉnh sửa nội dung văn bản của hình dạng ghi chú này trong Slides API. Các thuộc tính khác của đối tượng này và phần còn lại của nội dung trang ghi chú ở chế độ chỉ đọc.

Mẫu ghi chú của bản trình bày là một trang xác định các phần tử và kiểu văn bản mặc định được dùng trên các trang ghi chú. Một bản trình bày chỉ có một mẫu ghi chú. Ghi chú mẫu chỉ có thể đọc trong Slides API.

Đọc và ghi chú của người thuyết trình

Để tìm hình dạng ghi chú của người thuyết trình trong một trang trình bày, hãy tìm đối tượng ghi chú presentations.pages của trang trình bày đó trong thông báo SlideProperties. Hình dạng chứa văn bản ghi chú của người thuyết trình được xác định bằng trường speakerNotesObjectId trong thông báo NotesProperties của trang ghi chú.

Để đọc ghi chú của người thuyết trình trong một trang trình bày, hãy tìm một đối tượng có mã nhận dạng này trên trang ghi chú rồi đọc văn bản của đối tượng đó. Trong một số ít trường hợp, đối tượng này có thể không tồn tại, tức là các trang trình bày không có ghi chú của người thuyết trình.

Bạn có thể sử dụng yêu cầu văn bản batchUpdate để sửa đổi văn bản bên trong hình dạng ghi chú của người nói. Trong trường hợp hiếm gặp khi hình dạng ghi chú của người thuyết trình không tồn tại, Slides API sẽ tự động tạo hình dạng đó khi nhận được một thao tác văn bản hợp lệ bằng cách sử dụng speakerNotesObjectId.