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