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