このセクションでは、Google Docs API を使用してドキュメントを編集する際に理解しておく必要がある動作と制限事項について説明します。
通常、ドキュメント内の要素の無効な構造を引き起こす編集を実行することはできません。各 documents.batchUpdate リクエスト メソッドで、それらのリクエストに適用される制約とルールを確認します。
以降のセクションでは、これらの方法の主要なルールについて説明します。
テキストを挿入
- 改行文字を挿入すると、そのインデックスに
Paragraphが暗黙的に作成されます。新しい段落の段落スタイルは、リストや箇条書きなど、現在の挿入インデックスの段落からコピーされます。 - テキストは既存の
Paragraphの境界内に挿入する必要があります。たとえば、表の先頭のインデックスにテキストを挿入することはできません。テキストは前の段落に挿入する必要があります。 - API は、Unicode 書記素クラスタ内での挿入を防ぐために、場所を暗黙的に調整する場合があります。この場合、テキストはグラフーム クラスタの直後に挿入されます。
- 挿入されたテキストのテキスト スタイルは自動的に決定され、通常は隣接するテキストのスタイルが保持されます。通常、挿入されたテキストのテキスト スタイルは、挿入インデックスの直前のテキストと一致します。
- 一部の制御文字（
U+0000-U+0008, U+000C-U+001F）と Unicode 基本多言語プレーンの私用領域（U+E000-U+F8FF）の文字は、挿入されたテキストから削除されます。 - 詳細については、テキストの挿入、削除、移動をご覧ください。
インライン画像を挿入する
- 画像は、サイズが 50 MB 未満、25 メガピクセル以下で、PNG、JPEG、GIF 形式のいずれかである必要があります。
- 指定する URI は一般公開されており、長さが 2 KB 以下である必要があります。
- 画像は、既存の
Paragraphの境界内に挿入する必要があります。たとえば、テーブルの開始インデックスにテキストを挿入することはできません。 - 脚注や数式内に画像を挿入することはできません。
- 詳しくは、インライン画像を挿入するをご覧ください。
テキストの書式を設定する
- 範囲に段落レベルの書式設定を適用すると、その範囲と部分的にまたは完全に重複する段落に書式設定が適用されます。
- 隣接する改行を含めるように範囲が拡張されることがあります。
- 範囲にリストに属する段落が完全に含まれている場合、段落の箇条書きも一致するテキスト スタイルで更新されます。
- 詳しくは、テキストの書式設定をご覧ください。
段落の箇条書きを作成する
- 指定した範囲と重複するすべての段落に箇条書きを作成します。
- 各段落のネストレベルは、各段落の前に配置されたタブの数によって決まります。
- 箇条書きを作成するときに先頭のタブが削除されるため、テキストの一部のインデックスが変更される可能性があります。
- 対象の段落の直前に、リストの箇条書きと一致する段落の箇条書きを追加すると、その段落はリストに結合されます。
- 詳細については、リストを操作するをご覧ください。
テキストを削除する
段落境界を超えるテキストを削除すると、2 つの段落が統合されるため、段落スタイル、リスト、配置されたオブジェクト、ブックマークが変更される可能性があります。
無効なドキュメント構造の原因となる削除は許可されません。無効な削除リクエストの例を次に示します。
サロゲート ペアの 1 つのコード単位を削除する。
Body、Header、Footer、Footnote、TableCell、TableOfContentsの最後の改行文字を削除する。要素を削除せずに、
Table、TableOfContents、SectionBreakの前にある改行文字を削除する。テーブルの個々の行またはセルを削除する。テーブル セル内のコンテンツの削除は許可されています。
詳細については、テキストの挿入、削除、移動をご覧ください。