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