このガイドでは、Google スライド API を使用して発表者ノートを読み取り、編集する方法について説明します。
ノートページとノートマスター
ノートページは、プレゼンテーションのスライドの配布資料を生成するために使用されるページの一種です。各スライドには 1
つのノートページがあります。スライドのノートページの最初の BODY プレースホルダ
シェイプには、スライドの発表者ノートのテキストが含まれています。スライド API
では、このノートシェイプのテキスト コンテンツのみを編集できます。その他のプロパティとノートページの残りのコンテンツは読み取り専用です。
プレゼンテーションのノートマスターは、ノートページで使用されるデフォルトの要素とテキスト スタイルを定義するページです。プレゼンテーションには 1 つのノートマスターしかありません。ノートマスターはスライド API では読み取り専用です。
発表者ノートの読み取りと書き込み
スライドの発表者ノートのシェイプを見つけるには、スライドのノート
presentations.pages
オブジェクトを
SlideProperties
メッセージで見つけます。発表者ノートのテキストを含むシェイプは、ノートページの
speakerNotesObjectIdフィールドで識別されます。NotesProperties
スライドの発表者ノートを読み取るには、ノートページでこの ID のオブジェクトを見つけて テキストを読み取ります。まれに、このオブジェクトが存在しないことがあります。これは、スライドにスピーカー ノートがないことを意味します。
batchUpdate テキスト リクエスト
を使用して、発表者ノートのシェイプ内のテキストを変更できます。発表者ノートのシェイプが存在しない場合、speakerNotesObjectId
を使用して有効なテキスト オペレーションを受信すると、スライド API によって自動的に作成されます。