構造の編集ルールと動作

このセクションでは、次の場合に理解する必要がある動作と制限事項について説明します。 Google ドキュメント API を使用してドキュメントを編集します。

一般的に、無効な構造の原因となる編集は実行できません。 ドキュメント内の要素です。各 documents.batchUpdate 適用する制約とルールを指定する リクエスト。

以下のセクションでは、これらのメソッドの主なルールについて説明します。

テキストを挿入

  • 改行文字を暗黙的に挿入すると、 その時点の Paragraph あります。新しい段落の段落スタイルが、その段落からコピーされます。 現在の挿入インデックスの番号（リストや箇条書きを含む）を
  • テキストは既存の Paragraph の境界内に挿入する必要があります。対象 テーブルの開始インデックスにテキストを挿入することはできません。テキストは 挿入されました。
  • API は、内部への挿入を防ぐために場所を暗黙的に調整する場合があります。 Unicode 書記素クラスタ。この場合、テキストは挿入され、 書素クラスタの直後に配置します。
  • 挿入するテキストのテキスト スタイルは、通常は 隣接テキストのスタイルは保持されます通常、このアプリの 挿入されたテキストが、挿入インデックスの直前のテキストと一致する。
  • 一部の制御文字（U+0000-U+0008, U+000C-U+001F）と一部の制御文字 Unicode Basic Multilingual Plane Private Use Area（U+E000-U+F8FF）は、 挿入されたテキストの一部を取り除きます
  • 詳しくは、挿入、削除、移動 text です。

インライン画像を挿入する

  • 画像のサイズは 50 MB 未満、25 メガピクセル以下である必要があります。 PNG、JPEG、GIF のいずれかの形式にします。
  • 指定する URI は一般公開されている必要があり、長さは 2 KB 以下である必要があります。
  • 画像は既存の Paragraph の境界内に挿入する必要があります。対象 テーブルの開始インデックスにテキストを挿入することはできません。
  • 脚注や数式内に画像を挿入することはできません。
  • 詳しくは、インライン画像を挿入するをご覧ください。

テキストの書式を設定する

  • 範囲に段落レベルの書式設定を適用すると、 部分的または完全に重なっている段落に あります。
  • 隣接する改行を含めるように範囲が拡張されることがあります。
  • リストに属する段落が範囲全体に含まれている場合、その段落の 黒丸も一致するテキスト スタイルで更新されます。
  • 詳しくは、テキストの書式設定をご覧ください。

段落箇条書きを作成する

  • 指定した範囲と重複するすべての段落の箇条書きを作成します。
  • 各段落のネストレベルは、先頭に出現する段落の数で 各段落の前にタブを追加します。
  • 箇条書きの作成時に先頭のタブが削除されるため、 インデックスを作成します。
  • リストの箇条書き記号を直前に追加すると、 ターゲットの段落は、リストに結合されます。
  • 詳しくは、リストを操作するをご覧ください。

テキストを削除する

  • 段落の境界を超えるテキストを削除すると、 段落スタイル、リスト、配置オブジェクト、ブックマークの 2 つを 段落が結合されます。

  • 無効なドキュメント構造の原因となる削除は許可されません。一部 無効な削除リクエストの例は次のとおりです。

    • サロゲートペアの 1 つのコード単位を削除する。

    • 最後の改行文字を削除すると、 Body Header、 Footer、 Footnote TableCell TableOfContents

    • 先頭または末尾を削除すると、 Table TableOfContents、または Equation なし 要素全体を削除します。

    • Table、TableOfContents、または SectionBreak 要素を削除する必要はありません。

    • テーブルの個々の行やセルを削除する。コンテンツの削除 使用できます。

  • 詳しくは、挿入、削除、移動 text です。