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 API Google Trang trình bày.

Trang ghi chú và trang ghi chú chính

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ài thuyết trình. Mỗi trang trình bày có một trang ghi chú. Hình dạng trì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 thuyết trình cho trang trình bày đó. Bạn 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 API Trang trình bày. Các thuộc tính khác của hình dạng ghi chú này và phần còn lại của nội dung trang ghi chú đều ở chế độ chỉ đọc.

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

Đọc và ghi 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 cho một trang trình bày, hãy tìm đối tượng ghi chú của trang trình bày đó trong thông báo SlideProperties .presentations.pages 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 cho một trang trình bày, hãy tìm một đối tượng có mã này trên trang ghi chú rồi đọc văn bảncủ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 batchUpdate các yêu cầu văn bản để sửa đổi văn bản bên trong hình dạng ghi chú của người thuyết trình. Trong trường hợp hiếm gặp là hình dạng ghi chú của người thuyết trình không tồn tại, API Trang trình bày 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.