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