このセクションでは、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の前の改行文字を削除する。テーブルの個々の行またはセルを削除する。テーブル セル内のコンテンツの削除は許可されています。
詳細については、テキストの挿入、削除、移動をご覧ください。