Requests

リクエスト

ドキュメントに適用する 1 つの更新。

JSON 表現
{

  // Union field request can be only one of the following:
  "replaceAllText": {
    object (ReplaceAllTextRequest)
  },
  "insertText": {
    object (InsertTextRequest)
  },
  "updateTextStyle": {
    object (UpdateTextStyleRequest)
  },
  "createParagraphBullets": {
    object (CreateParagraphBulletsRequest)
  },
  "deleteParagraphBullets": {
    object (DeleteParagraphBulletsRequest)
  },
  "createNamedRange": {
    object (CreateNamedRangeRequest)
  },
  "deleteNamedRange": {
    object (DeleteNamedRangeRequest)
  },
  "updateParagraphStyle": {
    object (UpdateParagraphStyleRequest)
  },
  "deleteContentRange": {
    object (DeleteContentRangeRequest)
  },
  "insertInlineImage": {
    object (InsertInlineImageRequest)
  },
  "insertTable": {
    object (InsertTableRequest)
  },
  "insertTableRow": {
    object (InsertTableRowRequest)
  },
  "insertTableColumn": {
    object (InsertTableColumnRequest)
  },
  "deleteTableRow": {
    object (DeleteTableRowRequest)
  },
  "deleteTableColumn": {
    object (DeleteTableColumnRequest)
  },
  "insertPageBreak": {
    object (InsertPageBreakRequest)
  },
  "deletePositionedObject": {
    object (DeletePositionedObjectRequest)
  },
  "updateTableColumnProperties": {
    object (UpdateTableColumnPropertiesRequest)
  },
  "updateTableCellStyle": {
    object (UpdateTableCellStyleRequest)
  },
  "updateTableRowStyle": {
    object (UpdateTableRowStyleRequest)
  },
  "replaceImage": {
    object (ReplaceImageRequest)
  },
  "updateDocumentStyle": {
    object (UpdateDocumentStyleRequest)
  },
  "mergeTableCells": {
    object (MergeTableCellsRequest)
  },
  "unmergeTableCells": {
    object (UnmergeTableCellsRequest)
  },
  "createHeader": {
    object (CreateHeaderRequest)
  },
  "createFooter": {
    object (CreateFooterRequest)
  },
  "createFootnote": {
    object (CreateFootnoteRequest)
  },
  "replaceNamedRangeContent": {
    object (ReplaceNamedRangeContentRequest)
  },
  "updateSectionStyle": {
    object (UpdateSectionStyleRequest)
  },
  "insertSectionBreak": {
    object (InsertSectionBreakRequest)
  },
  "deleteHeader": {
    object (DeleteHeaderRequest)
  },
  "deleteFooter": {
    object (DeleteFooterRequest)
  },
  "pinTableHeaderRows": {
    object (PinTableHeaderRowsRequest)
  }
  // End of list of possible types for union field request.
}
フィールド
共用体フィールド request。適用する特定のリクエスト。フィールドが 1 つだけ必要です。 request は次のいずれか 1 つのみを指定できます。
replaceAllText

object (ReplaceAllTextRequest)

指定したテキストをすべて置き換えます。

insertText

object (InsertTextRequest)

指定した場所にテキストを挿入します。

updateTextStyle

object (UpdateTextStyleRequest)

指定した範囲のテキスト スタイルを更新します。

createParagraphBullets

object (CreateParagraphBulletsRequest)

段落の箇条書きを作成します。

deleteParagraphBullets

object (DeleteParagraphBulletsRequest)

段落から箇条書きを削除します。

createNamedRange

object (CreateNamedRangeRequest)

名前付き範囲を作成します。

deleteNamedRange

object (DeleteNamedRangeRequest)

名前付き範囲を削除します。

updateParagraphStyle

object (UpdateParagraphStyleRequest)

指定した範囲の段落スタイルを更新します。

deleteContentRange

object (DeleteContentRangeRequest)

ドキュメントからコンテンツを削除します。

insertInlineImage

object (InsertInlineImageRequest)

指定された場所にインライン画像を挿入します。

insertTable

object (InsertTableRequest)

指定された場所に表を挿入します。

insertTableRow

object (InsertTableRowRequest)

テーブルに空の行を挿入します。

insertTableColumn

object (InsertTableColumnRequest)

テーブルに空の列を挿入します。

deleteTableRow

object (DeleteTableRowRequest)

テーブルから行を削除します。

deleteTableColumn

object (DeleteTableColumnRequest)

テーブルから列を削除します。

insertPageBreak

object (InsertPageBreakRequest)

指定された位置に改ページを挿入します。

deletePositionedObject

object (DeletePositionedObjectRequest)

配置されたオブジェクトをドキュメントから削除します。

updateTableColumnProperties

object (UpdateTableColumnPropertiesRequest)

テーブル内の列のプロパティを更新します。

updateTableCellStyle

object (UpdateTableCellStyleRequest)

表のセルのスタイルを更新します。

updateTableRowStyle

object (UpdateTableRowStyleRequest)

テーブルの行スタイルを更新します。

replaceImage

object (ReplaceImageRequest)

ドキュメント内の画像を置き換えます。

updateDocumentStyle

object (UpdateDocumentStyleRequest)

ドキュメントのスタイルを更新します。

mergeTableCells

object (MergeTableCellsRequest)

表内のセルを結合します。

unmergeTableCells

object (UnmergeTableCellsRequest)

表内のセルの結合を解除します。

createHeader

object (CreateHeaderRequest)

ヘッダーを作成します。

createFootnote

object (CreateFootnoteRequest)

脚注を作成します。

replaceNamedRangeContent

object (ReplaceNamedRangeContentRequest)

名前付き範囲の内容を置き換えます。

updateSectionStyle

object (UpdateSectionStyleRequest)

指定した範囲のセクション スタイルを更新します。

insertSectionBreak

object (InsertSectionBreakRequest)

指定された位置にセクション区切りを挿入します。

deleteHeader

object (DeleteHeaderRequest)

ドキュメントからヘッダーを削除します。

pinTableHeaderRows

object (PinTableHeaderRowsRequest)

テーブル内の固定されたヘッダー行の数を更新します。

ReplaceAllTextRequest

条件に一致するテキストをすべて置換します replace text

JSON 表現
{
  "replaceText": string,
  "tabsCriteria": {
    object (TabsCriteria)
  },

  // Union field criteria can be only one of the following:
  "containsText": {
    object (SubstringMatchCriteria)
  }
  // End of list of possible types for union field criteria.
}
フィールド
replaceText

string

一致したテキストを置き換えるテキスト。

tabsCriteria

object (TabsCriteria)

省略可。置換を行うタブを指定するために使用する条件。

省略すると、すべてのタブに置換が適用されます。

1 つのタブを含むドキュメントの場合:

  • 指定する場合は、単一のタブの ID と一致する必要があります。

  • 省略すると、1 つのタブに置換が適用されます。

複数のタブを含むドキュメントの場合:

  • 指定した場合、指定したタブに置換が適用されます。

  • 省略すると、すべてのタブに置換が適用されます。

共用体フィールド criteria。置換するテキストの照合に使用する条件。 criteria は次のいずれか 1 つのみを指定できます。
containsText

object (SubstringMatchCriteria)

この部分文字列に一致するドキュメント内のテキストを検索します。

SubstringMatchCriteria

ドキュメント内の特定のテキスト文字列に一致する条件。

JSON 表現
{
  "text": string,
  "matchCase": boolean
}
フィールド
text

string

ドキュメント内を検索するテキスト。

matchCase

boolean

大文字と小文字を区別するかどうかを指定します。

  • True : 検索では大文字と小文字が区別されます。
  • False : 検索では大文字と小文字が区別されません。

TabsCriteria

リクエストを実行するタブを指定する基準。

JSON 表現
{
  "tabIds": [
    string
  ]
}
フィールド
tabIds[]

string

リクエストが実行されるタブ ID のリスト。

InsertTextRequest

指定した場所にテキストを挿入します。

JSON 表現
{
  "text": string,

  // Union field insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}
フィールド
text

string

挿入するテキスト。

改行文字を挿入すると、暗黙的に改行文字が Paragraph 表示されます。新しい段落の段落スタイルは、リストや箇条書きを含め、現在の挿入インデックスの段落からコピーされます。

挿入するテキストのテキスト スタイルは自動的に決定され、通常は隣接するテキストのスタイルが維持されます。ほとんどの場合、挿入されるテキストのテキスト スタイルは、挿入インデックスの直前のテキストと一致します。

挿入されたテキストからは、一部の制御文字(U+0000-U+0008、U+000C-U+001F)と Unicode Basic Multilingual Plane Private Use Area(U+E000-U+F8FF)の文字が取り除かれます。

共用体フィールド insertion_location。テキストを挿入する場所。 insertion_location は次のいずれか 1 つのみを指定できます。
location

object (Location)

ドキュメント内の特定のインデックスにテキストを挿入します。

テキストは既存の Paragraph。たとえば、表の開始インデックス(表と前の段落の間)にテキストを挿入することはできません。テキストは前の段落に挿入する必要があります。

endOfSegmentLocation

object (EndOfSegmentLocation)

ヘッダー、フッター、脚注、またはドキュメント本文の末尾にテキストを挿入します。

位置情報

ドキュメント内の特定の場所。

JSON 表現
{
  "segmentId": string,
  "index": integer,
  "tabId": string
}
フィールド
segmentId

string

ビジネス情報を含むヘッダー、フッター、脚注の ID。セグメント ID が空の場合は、ドキュメントの本文を示します。

index

integer

UTF-16 コード単位のゼロベースのインデックス。

インデックスは、 segmentId

tabId

string

ビジネスがあるタブ。省略すると、リクエストは最初のタブに適用されます。

1 つのタブを含むドキュメントの場合:

  • 指定する場合は、単一のタブの ID と一致する必要があります。

  • 省略すると、リクエストは 1 つのタブに適用されます。

複数のタブを含むドキュメントの場合:

  • 指定した場合、リクエストは指定したタブに適用されます。

  • 省略すると、リクエストはドキュメントの最初のタブに適用されます。

EndOfSegmentLocation

本文、ヘッダー、フッター、脚注の最後の場所。位置は、ドキュメント セグメントの最後の改行の直前です。

JSON 表現
{
  "segmentId": string,
  "tabId": string
}
フィールド
segmentId

string

ビジネス情報を含むヘッダー、フッター、脚注の ID。セグメント ID が空の場合は、ドキュメントの本文を示します。

tabId

string

ビジネスがあるタブ。省略すると、リクエストは最初のタブに適用されます。

1 つのタブを含むドキュメントの場合:

  • 指定する場合は、単一のタブの ID と一致する必要があります。

  • 省略すると、リクエストは 1 つのタブに適用されます。

複数のタブを含むドキュメントの場合:

  • 指定した場合、リクエストは指定したタブに適用されます。

  • 省略すると、リクエストはドキュメントの最初のタブに適用されます。

UpdateTextStyleRequest

テキストのスタイルを更新します。

JSON 表現
{
  "textStyle": {
    object (TextStyle)
  },
  "fields": string,

  // Union field insertion_location can be only one of the following:
  "range": {
    object (Range)
  }
  // End of list of possible types for union field insertion_location.
}
フィールド
textStyle

object (TextStyle)

テキストに設定するスタイル。

特定のスタイルの値が親の値と一致する場合、そのスタイルは継承に設定されます。

テキスト スタイルを変更すると、ドキュメント エディタの動作を反映させるために、他の変更が行われる場合があります。詳しくは、 TextStyle をご覧ください。

fields

string (FieldMask format)

更新対象のフィールド。

少なくとも 1 つのフィールドを指定する必要があります。ルート textStyle 暗黙的に指定され、指定しないでください。単一の "*" すべてのフィールドをリストするための省略形として使用できます。

たとえば、テキスト スタイルを太字に更新するには、 fields から "bold"

プロパティをデフォルト値にリセットするには、フィールド マスクにフィールド名を含め、フィールド自体は未設定のままにします。

共用体フィールド insertion_location。テキスト スタイルの更新に使用する範囲のタイプ。 insertion_location は次のいずれか 1 つのみを指定できます。
range

object (Range)

スタイルを設定するテキストの範囲。

隣接する改行を含めるように範囲を拡張することもできます。

範囲にリストに属する段落が完全に含まれている場合、その段落の箇条書きも一致するテキスト スタイルで更新されます。

相対的な UpdateTextStyleRequest 内に範囲を挿入することはできません。

CreateParagraphBulletsRequest

指定した範囲と重複するすべての段落の箇条書きを作成します。

各段落のネストレベルは、各段落の前にある先頭タブを数えることで決定されます。箇条書きと対応する段落との間の余分なスペースを避けるため、このリクエストではこれらの先頭タブが削除されます。これにより、テキストの部分のインデックスが変わる場合があります。

更新される段落の直前の段落が、プリセットに一致するリストに含まれている場合、更新対象の段落はその前のリストに追加されます。

JSON 表現
{
  "range": {
    object (Range)
  },
  "bulletPreset": enum (BulletGlyphPreset)
}
フィールド
range

object (Range)

箇条書きのプリセットを適用する範囲です。

bulletPreset

enum (BulletGlyphPreset)

使用する箇条書きのグリフの種類。

BulletGlyphPreset

リストの箇条書きグリフのプリセット パターン。

これらのパターンでは、次のような記号を使用します。

  • ARROW : Unicode U+2794 コードポイントに対応する矢印
  • ARROW3D : 3D シェーディング付きの矢印、Unicode U+27a2 コードポイントに対応
  • CHECKBOX : 白抜きの正方形。Unicode の U+274f コードポイントに対応します。
  • CIRCLE : 白抜きの円。Unicode U+25cb コードポイントに対応します。
  • DIAMOND : 丸いひし形。Unicode U+25c6 コードポイントに対応します。
  • DIAMONDX : 「x」が付いたひし形。Unicode U+2756 コードポイントに対応します。
  • HOLLOWDIAMOND : 白抜きのひし形。Unicode U+25c7 コードポイントに対応します。
  • DISC : 実線の円。Unicode U+25cf コードポイントに対応します。
  • SQUARE : 実線の正方形。Unicode U+25a0 コードポイントに対応します。
  • STAR : Unicode U+2605 コードポイントに対応する星
  • ALPHA : 小文字(「a」、「b」、「c」など)。
  • UPPERALPHA : 大文字(「A」、「B」、「C」など)。
  • DECIMAL : 数字(「1」、「2」、「3」など)。
  • ZERODECIMAL : 1 桁の数字の前にゼロが付いた数値(「01」、「02」、「03」など)。数字が複数ある場合は、先頭に 0 は付きません。
  • ROMAN : 小文字のローマ数字(「i」、「ii」、「iii」など)。
  • UPPERROMAN : 大文字のローマ数字(「I」、「II」、「III」など)。
  • LEFTTRIANGLE : 左を指す三角形。Unicode U+25c4 コードポイントに対応します。
列挙型
BULLET_GLYPH_PRESET_UNSPECIFIED 箇条書きのグリフのプリセットが指定されていません。
BULLET_DISC_CIRCLE_SQUARE 箇条書きに DISC, CIRCLE および SQUARE リストの最初の 3 つのネスト レベルの箇条書きグリフ。
BULLET_DIAMONDX_ARROW3D_SQUARE 箇条書きに DIAMONDX, ARROW3D および SQUARE リストの最初の 3 つのネスト レベルの箇条書きグリフ。
BULLET_CHECKBOX 箇条書きに CHECKBOX すべてのリストのネスト レベルでの箇条書きのグリフ。
BULLET_ARROW_DIAMOND_DISC 箇条書きに ARROW, DIAMOND および DISC リストの最初の 3 つのネスト レベルの箇条書きグリフ。
BULLET_STAR_CIRCLE_SQUARE 箇条書きに STAR, CIRCLE および SQUARE リストの最初の 3 つのネスト レベルの箇条書きグリフ。
BULLET_ARROW3D_CIRCLE_SQUARE 箇条書きに ARROW3D, CIRCLE および SQUARE リストの最初の 3 つのネスト レベルの箇条書きグリフ。
BULLET_LEFTTRIANGLE_DIAMOND_DISC 箇条書きに LEFTTRIANGLE, DIAMOND および DISC リストの最初の 3 つのネスト レベルの箇条書きグリフ。
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE 箇条書きに DIAMONDX, HOLLOWDIAMOND および SQUARE リストの最初の 3 つのネスト レベルの箇条書きグリフ。
BULLET_DIAMOND_CIRCLE_SQUARE 箇条書きに DIAMOND, CIRCLE および SQUARE リストの最初の 3 つのネスト レベルの箇条書きグリフ。
NUMBERED_DECIMAL_ALPHA_ROMAN 番号付きリスト DECIMAL, ALPHA および ROMAN 最初の 3 つのネスト レベルには数値グリフを使用し、その後にピリオドを付けます。
NUMBERED_DECIMAL_ALPHA_ROMAN_PARENS 番号付きリスト DECIMAL, ALPHA および ROMAN 最初の 3 つのリストネスト レベルには数値グリフを使用し、その後に括弧が続きます。
NUMBERED_DECIMAL_NESTED 番号付きリスト DECIMAL ピリオドで区切られた数値グリフ。各ネスト レベルは、前のネスト レベルのグリフを接頭辞として使用します。例: 「1.」、'1.1.'、'2.'、'2.2.'.
NUMBERED_UPPERALPHA_ALPHA_ROMAN 番号付きリスト UPPERALPHA, ALPHA および ROMAN 最初の 3 つのネスト レベルには数値グリフを使用し、その後にピリオドを付けます。
NUMBERED_UPPERROMAN_UPPERALPHA_DECIMAL 番号付きリスト UPPERROMAN, UPPERALPHA および DECIMAL 最初の 3 つのネスト レベルには数値グリフを使用し、その後にピリオドを付けます。
NUMBERED_ZERODECIMAL_ALPHA_ROMAN 番号付きリスト ZERODECIMAL, ALPHA および ROMAN 最初の 3 つのネスト レベルには数値グリフを使用し、その後にピリオドを付けます。

DeleteParagraphBulletsRequest

指定した範囲と重複するすべての段落から箇条書きを削除します。

各段落のネストレベルは、対応する段落の先頭にインデントを追加することで視覚的に維持されます。

JSON 表現
{
  "range": {
    object (Range)
  }
}
フィールド
range

object (Range)

箇条書きを削除する範囲です。

CreateNamedRangeRequest

変数を NamedRange 参照します。

JSON 表現
{
  "name": string,
  "range": {
    object (Range)
  }
}
フィールド
name

string

NamedRange の名前。名前は一意である必要はありません。

名前は UTF-16 コード単位で測定し、1 文字以上、256 文字以下にする必要があります。

range

object (Range)

名前を適用する範囲。

DeleteNamedRangeRequest

削除 NamedRange

JSON 表現
{
  "tabsCriteria": {
    object (TabsCriteria)
  },

  // Union field named_range_reference can be only one of the following:
  "namedRangeId": string,
  "name": string
  // End of list of possible types for union field named_range_reference.
}
フィールド
tabsCriteria

object (TabsCriteria)

省略可。範囲を削除するタブを指定するために使用する条件。省略すると、範囲の削除はすべてのタブに適用されます。

1 つのタブを含むドキュメントの場合:

  • 指定する場合は、単一のタブの ID と一致する必要があります。

  • 省略すると、範囲の削除は単一のタブに適用されます。

複数のタブを含むドキュメントの場合:

  • 指定した場合、範囲の削除は指定したタブに適用されます。

  • 指定しない場合、範囲の削除はすべてのタブに適用されます。

共用体フィールド named_range_reference。削除する範囲を決定する値。1 つのみを設定する必要があります。 named_range_reference は次のいずれか 1 つのみを指定できます。
namedRangeId

string

削除する名前付き範囲の ID。

name

string

削除する範囲の名前。指定した名前の名前付き範囲がすべて削除されます。

UpdateParagraphStyleRequest

指定した範囲と重複するすべての段落のスタイルを更新します。

JSON 表現
{
  "paragraphStyle": {
    object (ParagraphStyle)
  },
  "fields": string,

  // Union field insertion_location can be only one of the following:
  "range": {
    object (Range)
  }
  // End of list of possible types for union field insertion_location.
}
フィールド
paragraphStyle

object (ParagraphStyle)

段落に設定するスタイル。

段落のスタイルを変更すると、ドキュメント エディタの動作を反映させるために、他の変更が行われる場合があります。詳しくは、 ParagraphStyle をご覧ください。

fields

string (FieldMask format)

更新対象のフィールド。

少なくとも 1 つのフィールドを指定する必要があります。ルート paragraphStyle 暗黙的に指定され、指定しないでください。単一の "*" すべてのフィールドをリストするための省略形として使用できます。

たとえば、段落スタイルのアライメント プロパティを更新するには、 fields から "alignment"

プロパティをデフォルト値にリセットするには、フィールド マスクにフィールド名を含め、フィールド自体は未設定のままにします。

共用体フィールド insertion_location。段落スタイルの更新に使用する範囲のタイプ。 insertion_location は次のいずれか 1 つのみを指定できます。
range

object (Range)

スタイルを設定する段落と重なる範囲。

DeleteContentRangeRequest

ドキュメントからコンテンツを削除します。

JSON 表現
{
  "range": {
    object (Range)
  }
}
フィールド
range

object (Range)

削除するコンテンツの範囲。

段落の境界を越えるテキストを削除すると、2 つの段落が統合されるため、段落のスタイル、リスト、配置オブジェクト、ブックマークが変更されることがあります。

特定の範囲を削除しようとすると、無効なドキュメント構造が返されることがあり、その場合は 400 不正なリクエスト エラーが返されます。

無効な削除リクエストには次のようなものがあります。

  • サロゲートペアの 1 つのコード単位を削除する。
  • 最後の改行文字を削除すると、 Body, Header, Footer, Footnote, TableCell または TableOfContents
  • 先頭または末尾を削除すると、 Table, TableOfContents または Equation 要素全体を削除する必要はありません。
  • 先頭にある改行文字を削除すると、 Table, TableOfContents または SectionBreak 要素を削除する必要はありません。
  • テーブルの個々の行やセルを削除する。表のセル内のコンテンツは削除できます。

InsertInlineImageRequest

挿入 InlineObject 生成します。

JSON 表現
{
  "uri": string,
  "objectSize": {
    object (Size)
  },

  // Union field insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}
フィールド
uri

string

イメージの URI。

画像は挿入時に一度取得され、ドキュメント内に表示するためにコピーが保存されます。画像は、サイズが 50 MB 未満、25 メガピクセル以下で、PNG、JPEG、GIF 形式のいずれかである必要があります。

指定する URI は一般公開されている必要があり、長さは 2 KB 以下である必要があります。URI 自体は画像と一緒に保存され、 ImageProperties.content_uri 表示されます。

objectSize

object (Size)

ドキュメントでの画像の表示サイズ。このプロパティは省略可能で、ドキュメント内の画像の最終的なサイズは次のルールによって決まります。* 幅と高さのどちらも指定されていない場合、画像のデフォルトのサイズは解像度に基づいて計算されます。* 一方の寸法を指定すると、もう一方の寸法は画像のアスペクト比を維持して計算されます。* 幅と高さの両方が指定されている場合、画像はアスペクト比を維持しながら、指定されたサイズ内に収まるように調整されます。

共用体フィールド insertion_location。画像が挿入される場所。 insertion_location は次のいずれか 1 つのみを指定できます。
location

object (Location)

ドキュメント内の特定のインデックスに画像を挿入します。

画像は、既存の Paragraph。たとえば、テーブルの開始インデックス(テーブルとその前の段落の間)に挿入することはできません。

脚注や数式内にインライン画像を挿入することはできません。

endOfSegmentLocation

object (EndOfSegmentLocation)

ヘッダー、フッター、またはドキュメント本文の末尾にテキストを挿入します。

脚注の中にインライン画像を挿入することはできません。

InsertTableRequest

指定された場所に表を挿入します。

挿入した表の前に改行文字が挿入されます。

JSON 表現
{
  "rows": integer,
  "columns": integer,

  // Union field insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}
フィールド
rows

integer

テーブル内の行数。

columns

integer

テーブル内の列の数。

共用体フィールド insertion_location。テーブルが挿入される場所。 insertion_location は次のいずれか 1 つのみを指定できます。
location

object (Location)

特定のモデル インデックスにテーブルを挿入します。

挿入されたテーブルの前に改行文字が挿入されるため、テーブルの開始インデックスは指定された場所インデックス + 1 に配置されます。

テーブルは、既存のリソースの境界内に挿入する必要があります。 Paragraph。たとえば、テーブルの開始インデックス(既存のテーブルとその前の段落の間)に挿入することはできません。

脚注や数式内に表を挿入することはできません。

endOfSegmentLocation

object (EndOfSegmentLocation)

指定したヘッダー、フッター、ドキュメント本文の末尾に表を挿入します。挿入した表の前に改行文字が挿入されます。

脚注の中に表を挿入することはできません。

InsertTableRowRequest

テーブルに空の行を挿入します。

JSON 表現
{
  "tableCellLocation": {
    object (TableCellLocation)
  },
  "insertBelow": boolean
}
フィールド
tableCellLocation

object (TableCellLocation)

行の挿入元となる参照テーブルのセルの場所。

参照セルがある行の上(または下)に新しい行が挿入されます。参照セルが結合されたセルである場合、結合されたセルの上(または下)に新しい行が挿入されます。

insertBelow

boolean

参照セルの位置の下に新しい行を挿入するかどうか。

  • True : セルの下に挿入します。
  • False : セルの上に挿入します。

TableCellLocation

表内の 1 つのセルの位置。

JSON 表現
{
  "tableStartLocation": {
    object (Location)
  },
  "rowIndex": integer,
  "columnIndex": integer
}
フィールド
tableStartLocation

object (Location)

ドキュメント内の表の開始位置。

rowIndex

integer

ゼロベースの行インデックス。たとえば、テーブルの 2 番目の行の行インデックスは 1 です。

columnIndex

integer

ゼロベースの列インデックス。たとえば、テーブルの 2 番目の列の列インデックスは 1 です。

InsertTableColumnRequest

テーブルに空の列を挿入します。

JSON 表現
{
  "tableCellLocation": {
    object (TableCellLocation)
  },
  "insertRight": boolean
}
フィールド
tableCellLocation

object (TableCellLocation)

列の挿入元となる参照テーブルのセルの場所。

新しい列が、参照セルがある列の左(または右)に挿入されます。参照セルが結合されたセルである場合、新しい列が結合されたセルの左(または右)に挿入されます。

insertRight

boolean

新しい列を参照セルの位置の右側に挿入するかどうか。

  • True : 右側に挿入します。
  • False : 左側に挿入します。

DeleteTableRowRequest

テーブルから行を削除します。

JSON 表現
{
  "tableCellLocation": {
    object (TableCellLocation)
  }
}
フィールド
tableCellLocation

object (TableCellLocation)

行を削除する参照テーブルのセルの場所。

このセルにまたがる行が削除されます。複数の行にまたがる結合したセルの場合、そのセルにまたがるすべての行が削除されます。この削除後もテーブルに行が残っていない場合は、テーブル全体が削除されます。

DeleteTableColumnRequest

テーブルから列を削除します。

JSON 表現
{
  "tableCellLocation": {
    object (TableCellLocation)
  }
}
フィールド
tableCellLocation

object (TableCellLocation)

列を削除する参照テーブルのセルの場所。

このセルにまたがる列が削除されます。複数の列にまたがる結合したセルの場合、そのセルがまたがっている列はすべて削除されます。この削除後もテーブルに列が残らなければ、テーブル全体が削除されます。

InsertPageBreakRequest

指定された位置に改ページを挿入し、その後に改行を挿入します。

JSON 表現
{

  // Union field insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}
フィールド
共用体フィールド insertion_location。改ページを挿入する位置。 insertion_location は次のいずれか 1 つのみを指定できます。
location

object (Location)

ドキュメント内の特定のインデックスに改ページを挿入します。

改ページは、既存の Paragraph。たとえば、テーブルの開始インデックス(テーブルとその前の段落の間)に挿入することはできません。

表、数式、脚注、ヘッダー、フッター内に改ページを挿入することはできません。改ページは本文内にのみ挿入できるため、 segment ID フィールドは空にする必要があります。

endOfSegmentLocation

object (EndOfSegmentLocation)

ドキュメント本文の末尾に改ページを挿入します。

脚注、ヘッダー、フッター内に改ページを挿入することはできません。改ページは本文内にのみ挿入できるため、 segment ID フィールドは空にする必要があります。

DeletePositionedObjectRequest

削除 PositionedObject ハイライト表示されます。

JSON 表現
{
  "objectId": string,
  "tabId": string
}
フィールド
objectId

string

削除する位置決めオブジェクトの ID。

tabId

string

削除対象のオブジェクトがあるタブ。省略すると、リクエストは最初のタブに適用されます。

1 つのタブを含むドキュメントの場合:

  • 指定する場合は、単一のタブの ID と一致する必要があります。

  • 省略すると、リクエストは 1 つのタブに適用されます。

複数のタブを含むドキュメントの場合:

  • 指定した場合、リクエストは指定したタブに適用されます。

  • 省略すると、リクエストはドキュメントの最初のタブに適用されます。

UpdateTableColumnPropertiesRequest

更新 TableColumnProperties 使用できます。

JSON 表現
{
  "tableStartLocation": {
    object (Location)
  },
  "columnIndices": [
    integer
  ],
  "tableColumnProperties": {
    object (TableColumnProperties)
  },
  "fields": string
}
フィールド
tableStartLocation

object (Location)

ドキュメント内の表の開始位置。

columnIndices[]

integer

プロパティを更新する必要があるゼロベースの列インデックスのリスト。インデックスが指定されていない場合、すべての列が更新されます。

tableColumnProperties

object (TableColumnProperties)

更新するテーブルの列のプロパティ。

値が tableColumnProperties#width 5 ポイント(5/72 インチ)未満の場合は、400 不正なリクエスト エラーが返されます。

fields

string (FieldMask format)

更新対象のフィールド。

少なくとも 1 つのフィールドを指定する必要があります。ルート tableColumnProperties 暗黙的に指定され、指定しないでください。単一の "*" すべてのフィールドをリストするための省略形として使用できます。

たとえば、列の幅を更新するには、 fields から "width"

UpdateTableCellStyleRequest

表のセル範囲のスタイルを更新します。

JSON 表現
{
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "fields": string,

  // Union field cells can be only one of the following:
  "tableRange": {
    object (TableRange)
  },
  "tableStartLocation": {
    object (Location)
  }
  // End of list of possible types for union field cells.
}
フィールド
tableCellStyle

object (TableCellStyle)

表のセルに設定するスタイル。

枠線の更新時に、セルが隣接するセルと枠線を共有している場合は、隣接するセルの枠線のプロパティも更新されます。結合されて非表示の枠線は更新されません。

同じリクエストで隣接するセルで共有されている枠線を更新すると、枠線の更新で競合が発生する可能性があるため、枠線の更新は次の順序で適用されます。

  • borderRight
  • borderLeft
  • borderBottom
  • borderTop
fields

string (FieldMask format)

更新対象のフィールド。

少なくとも 1 つのフィールドを指定する必要があります。ルート tableCellStyle 暗黙的に指定され、指定しないでください。単一の "*" すべてのフィールドをリストするための省略形として使用できます。

たとえば、表のセルの背景色を更新するには、 fields から "backgroundColor"

プロパティをデフォルト値にリセットするには、フィールド マスクにフィールド名を含め、フィールド自体は未設定のままにします。

共用体フィールド cells。更新するセルです。 cells は次のいずれか 1 つのみを指定できます。
tableRange

object (TableRange)

更新が適用されるテーブルのサブセットを表すテーブル範囲。

tableStartLocation

object (Location)

ドキュメント内の表の開始位置。指定すると、更新がテーブル内のすべてのセルに適用されます。

TableRange

テーブル範囲は、テーブルのサブセットへの参照を表します。

表の範囲で指定するセルは必ずしも四角形を形成するわけではありません。たとえば、最後の行のすべてのセルが結合された 3 x 3 の表があるとします。テーブルは次のようになります。

 [   ][   ][   ]
 [   ][   ][   ]
 [             ]

テーブルのセルの位置 = (tableStartLocation、行 = 0、列 = 0)、行スパン = 3、列スパン = 2 であるテーブル範囲では、次のセルが指定されています。

 [ x ][ x ][   ]
 [ x ][ x ][   ]
 [ x    x    x ]
JSON 表現
{
  "tableCellLocation": {
    object (TableCellLocation)
  },
  "rowSpan": integer,
  "columnSpan": integer
}
フィールド
tableCellLocation

object (TableCellLocation)

表の範囲を開始するセルの位置。

rowSpan

integer

テーブル範囲の行スパン。

columnSpan

integer

テーブル範囲の列スパン。

UpdateTableRowStyleRequest

更新 TableRowStyle 行の数が示されます。

JSON 表現
{
  "tableStartLocation": {
    object (Location)
  },
  "rowIndices": [
    integer
  ],
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "fields": string
}
フィールド
tableStartLocation

object (Location)

ドキュメント内の表の開始位置。

rowIndices[]

integer

スタイルを更新する必要があるゼロベースの行インデックスのリスト。インデックスが指定されていない場合、すべての行が更新されます。

tableRowStyle

object (TableRowStyle)

行に設定するスタイル。

fields

string (FieldMask format)

更新対象のフィールド。

少なくとも 1 つのフィールドを指定する必要があります。ルート tableRowStyle 暗黙的に指定され、指定しないでください。単一の "*" すべてのフィールドをリストするための省略形として使用できます。

たとえば、行の最小の高さを更新するには、 fields から "minRowHeight"

ReplaceImageRequest

既存のイメージを新しいイメージに置き換えます。

画像を置き換えると image effects を既存の画像からコピーして、ドキュメント エディタの動作を反映させます。

JSON 表現
{
  "imageObjectId": string,
  "uri": string,
  "imageReplaceMethod": enum (ImageReplaceMethod),
  "tabId": string
}
フィールド
imageObjectId

string

置き換えられる既存のイメージの ID。ID は、GET リクエストのレスポンスから取得できます。

uri

string

新しい画像の URI。

画像は挿入時に一度取得され、ドキュメント内に表示するためにコピーが保存されます。画像は 50 MB 未満、25 メガピクセル以下で、PNG、JPEG、または GIF 形式である必要があります。

指定する URI は長さが 2 KB を超えないようにしてください。URI は画像とともに保存され、 ImageProperties.source_uri 表示されます。

imageReplaceMethod

enum (ImageReplaceMethod)

置換メソッド。

tabId

string

置換対象の画像があるタブ。省略すると、リクエストは最初のタブに適用されます。

1 つのタブを含むドキュメントの場合:

  • 指定する場合は、単一のタブの ID と一致する必要があります。

  • 省略すると、リクエストは 1 つのタブに適用されます。

複数のタブを含むドキュメントの場合:

  • 指定した場合、リクエストは指定したタブに適用されます。

  • 省略すると、リクエストはドキュメントの最初のタブに適用されます。

ImageReplaceMethod

画像の置換メソッドです。

列挙型
IMAGE_REPLACE_METHOD_UNSPECIFIED 画像の置換メソッドが指定されていません。この値は使用しないでください。
CENTER_CROP 元の画像の境界いっぱいになるように、画像を拡大縮小および中央揃えします。元の画像の境界を埋めるために、画像がトリミングされることがあります。画像のレンダリング サイズは元の画像と同じになります。

UpdateDocumentStyleRequest

更新 DocumentStyle

JSON 表現
{
  "documentStyle": {
    object (DocumentStyle)
  },
  "fields": string,
  "tabId": string
}
フィールド
documentStyle

object (DocumentStyle)

ドキュメントに設定するスタイル。

特定のドキュメント スタイルを変更すると、ドキュメント エディタの動作を反映させるために、他の変更が行われる場合があります。詳しくは、 DocumentStyle をご覧ください。

fields

string (FieldMask format)

更新対象のフィールド。

少なくとも 1 つのフィールドを指定する必要があります。ルート documentStyle 暗黙的に指定され、指定しないでください。単一の "*" すべてのフィールドをリストするための省略形として使用できます。

たとえば、背景を更新するには、 fields から "background"

tabId

string

更新するスタイルを含むタブ。省略すると、リクエストは最初のタブに適用されます。

1 つのタブを含むドキュメントの場合:

  • 指定する場合は、単一のタブの ID と一致する必要があります。

  • 省略すると、リクエストは 1 つのタブに適用されます。

複数のタブを含むドキュメントの場合:

  • 指定した場合、リクエストは指定したタブに適用されます。

  • 指定しなかった場合、リクエストはドキュメントの最初のタブに適用されます。

MergeTableCellsRequest

セルを結合 Table

JSON 表現
{
  "tableRange": {
    object (TableRange)
  }
}
フィールド
tableRange

object (TableRange)

結合する表のセルを指定する表の範囲。

結合されるセル内のテキストはすべて連結されて「ヘッド」に格納されますその範囲のセル。コンテンツの方向が左から右の場合は範囲の左上のセル、それ以外の場合は範囲の右上のセルになります。

範囲が長方形以外の場合(結合済みのセルや表が非長方形のセルが範囲に含まれる場合がある)、400 不正なリクエスト エラーが返されます。

UnmergeTableCellsRequest

セルの結合を解除 Table

JSON 表現
{
  "tableRange": {
    object (TableRange)
  }
}
フィールド
tableRange

object (TableRange)

結合を解除する表のセルを指定する表の範囲。

この範囲の結合したすべてのセルの結合が解除されます。すでに結合が解除されたセルには影響しません。範囲に結合されたセルがない場合、リクエストは行われません。

結合したセルのいずれかにテキストが含まれている場合、そのテキストは「ヘッド」内に残ります。結合解除されたセルからなるブロックのセル。「頭」コンテンツの方向が左から右の場合、セルは左上のセルになり、それ以外の場合は右上のセルになります。

CreateHeaderRequest

変数を Header。新しいヘッダーは SectionStyle Deployment の SectionBreak 指定されていない場合、 DocumentStyle

指定されたタイプのヘッダーがすでに存在する場合、400 不正なリクエスト エラーが返されます。

JSON 表現
{
  "type": enum (HeaderFooterType),
  "sectionBreakLocation": {
    object (Location)
  }
}
フィールド
type

enum (HeaderFooterType)

作成するヘッダーのタイプ。

sectionBreakLocation

object (Location)

アプリケーションの SectionBreak これは、このヘッダーが属するセクションを開始します。「sectionBreakLocation」についてが設定されていない場合、またはドキュメント本文の最初のセクション区切りを参照している場合、ヘッダーは DocumentStyle

HeaderFooterType

作成できるヘッダーとフッターのタイプ。

列挙型
DEFAULT デフォルトのヘッダー/フッター。

CreateFooterRequest

変数を Footer。新しいフッターが SectionStyle Deployment の SectionBreak 指定されていない場合、 DocumentStyle

指定したタイプのフッターがすでに存在する場合は、400 不正なリクエスト エラーが返されます。

JSON 表現
{
  "type": enum (HeaderFooterType),
  "sectionBreakLocation": {
    object (Location)
  }
}
フィールド
type

enum (HeaderFooterType)

作成するフッターのタイプ。

sectionBreakLocation

object (Location)

アプリケーションの SectionBreak そのセクションの直前を SectionStyle 指定するようにします。このポリシーを未設定のままにした場合や、ドキュメントの最初のセクション区切りを参照している場合は、フッターがドキュメント スタイルに適用されます。

CreateFootnoteRequest

変数を Footnote 新しい ReplicaSet が挿入されます FootnoteReference ロールを追加します。

新しい Footnote スペースが含まれ、その後に改行文字が続きます。

JSON 表現
{

  // Union field footnote_reference_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field footnote_reference_location.
}
フィールド
共用体フィールド footnote_reference_location。脚注参照を挿入する位置。 footnote_reference_location は次のいずれか 1 つのみを指定できます。
location

object (Location)

ドキュメント内の特定のインデックスに脚注参照を挿入します。

脚注参照は既存の Paragraph。たとえば、テーブルの開始インデックス(テーブルとその前の段落の間)に挿入することはできません。

計算式、見出し、フッター、脚注の中に脚注の参照を挿入することはできません。脚注の参照は本文にのみ挿入できるため、 segment ID フィールドは空にする必要があります。

endOfSegmentLocation

object (EndOfSegmentLocation)

ドキュメント本文の末尾に脚注参照を挿入します。

ヘッダー、フッター、脚注の中に脚注の参照を挿入することはできません。脚注の参照は本文にのみ挿入できるため、 segment ID フィールドは空にする必要があります。

ReplaceNamedRangeContentRequest

指定された NamedRange または NamedRanges 差し替えます。

なお、 NamedRange 複数の不連続なドメインから構成される場合があり、 ranges。この場合、最初の範囲のコンテンツのみが置き換えられます。他の範囲とその内容は削除されます。

範囲の置換または削除によってドキュメント構造が無効な場合は、400 不正なリクエスト エラーが返されます。

JSON 表現
{
  "tabsCriteria": {
    object (TabsCriteria)
  },

  // Union field replacement_content can be only one of the following:
  "text": string
  // End of list of possible types for union field replacement_content.

  // Union field named_range_reference can be only one of the following:
  "namedRangeId": string,
  "namedRangeName": string
  // End of list of possible types for union field named_range_reference.
}
フィールド
tabsCriteria

object (TabsCriteria)

省略可。置換を行うタブを指定するために使用する条件。省略すると、すべてのタブに置換が適用されます。

1 つのタブを含むドキュメントの場合:

  • 指定する場合は、単一のタブの ID と一致する必要があります。

  • 省略すると、1 つのタブに置換が適用されます。

複数のタブを含むドキュメントの場合:

  • 指定した場合、指定したタブに置換が適用されます。

  • 省略すると、すべてのタブに置換が適用されます。

共用体フィールド replacement_content。名前付き範囲の既存のコンテンツを置き換えるコンテンツ。 replacement_content は次のいずれか 1 つのみを指定できます。
text

string

指定した名前付き範囲の内容を、指定したテキストに置き換えます。

共用体フィールド named_range_reference。コンテンツが置き換えられる名前付き範囲への参照。 named_range_reference は次のいずれか 1 つのみを指定できます。
namedRangeId

string

コンテンツを置き換える名前付き範囲の ID。

指定された ID の名前付き範囲が存在しない場合、400 不正なリクエスト エラーが返されます。

namedRangeName

string

名前 NamedRanges そのコンテンツが置き換えられます

複数の named ranges 指定すると、それぞれの内容が置き換えられます。指定された名前の名前付き範囲がない場合、リクエストは何もしません。

UpdateSectionStyleRequest

更新 SectionStyle

JSON 表現
{
  "range": {
    object (Range)
  },
  "sectionStyle": {
    object (SectionStyle)
  },
  "fields": string
}
フィールド
range

object (Range)

スタイル設定するセクションと重なる範囲。

セクション区切りは本文内にのみ挿入できるため、 segment ID フィールドは空にする必要があります。

sectionStyle

object (SectionStyle)

セクションで設定するスタイル。

セクションのスタイルを変更すると、ドキュメント エディタの動作を反映させるために、他の変更が行われる場合があります。詳しくは、 SectionStyle をご覧ください。

fields

string (FieldMask format)

更新対象のフィールド。

少なくとも 1 つのフィールドを指定する必要があります。ルート sectionStyle 指定しないでください。単一の "*" すべてのフィールドをリストするための省略形として使用できます。

たとえば、左余白を更新するには、 fields から "marginLeft"

InsertSectionBreakRequest

指定された位置にセクション区切りを挿入します。

セクション区切りの前に改行文字が挿入されます。

JSON 表現
{
  "sectionType": enum (SectionType),

  // Union field insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}
フィールド
sectionType

enum (SectionType)

挿入するセクションのタイプ。

共用体フィールド insertion_location。挿入点を挿入する位置。 insertion_location は次のいずれか 1 つのみを指定できます。
location

object (Location)

ドキュメント内の特定のインデックスに改行とセクション区切りを挿入します。

セクション区切りは、既存の Paragraph。たとえば、テーブルの開始インデックス(テーブルとその前の段落の間)に挿入することはできません。

表、数式、脚注、ヘッダー、フッター内にセクション区切りを挿入することはできません。セクション区切りは本文内にのみ挿入できるため、 segment ID フィールドは空にする必要があります。

endOfSegmentLocation

object (EndOfSegmentLocation)

ドキュメント本文の末尾に改行とセクション区切りを挿入します。

脚注、ヘッダー、フッター内にセクション区切りを挿入することはできません。セクション区切りは本文内にのみ挿入できるため、 segment ID フィールドは空にする必要があります。

DeleteHeaderRequest

削除 Header ハイライト表示されます。

JSON 表現
{
  "headerId": string,
  "tabId": string
}
フィールド
headerId

string

削除するヘッダーの ID。このヘッダーが DocumentStyle の場合、このヘッダーへの参照が削除されます。その結果、ドキュメントの最初のセクションでそのタイプのヘッダーはなくなります。このヘッダーが SectionStyle の場合、このヘッダーへの参照は削除され、そのタイプのヘッダーは前のセクションの続きになります。

tabId

string

削除するヘッダーを含むタブ。省略すると、リクエストは最初のタブに適用されます。

1 つのタブを含むドキュメントの場合:

  • 指定する場合は、単一のタブの ID と一致する必要があります。

  • 省略すると、リクエストは 1 つのタブに適用されます。

複数のタブを含むドキュメントの場合:

  • 指定した場合、リクエストは指定したタブに適用されます。

  • 省略すると、リクエストはドキュメントの最初のタブに適用されます。

DeleteFooterRequest

削除 Footer ハイライト表示されます。

JSON 表現
{
  "footerId": string,
  "tabId": string
}
フィールド
footerId

string

削除するフッターの ID。このフッターが DocumentStyle の場合、このフッターへの参照が削除され、ドキュメントの最初のセクションにそのタイプのフッターがなくなります。このフッターが SectionStyle の場合、このフッターへの参照は削除され、そのタイプのフッターは前のセクションから続きます。

tabId

string

削除するフッターを含むタブ。省略すると、リクエストは最初のタブに適用されます。

1 つのタブを含むドキュメントの場合:

  • 指定する場合は、単一のタブの ID と一致する必要があります。

  • 省略すると、リクエストは 1 つのタブに適用されます。

複数のタブを含むドキュメントの場合:

  • 指定した場合、リクエストは指定したタブに適用されます。

  • 省略すると、リクエストはドキュメントの最初のタブに適用されます。

PinTableHeaderRowsRequest

テーブル内の固定されたテーブルのヘッダー行の数を更新します。

JSON 表現
{
  "tableStartLocation": {
    object (Location)
  },
  "pinnedHeaderRowsCount": integer
}
フィールド
tableStartLocation

object (Location)

ドキュメント内の表の開始位置。

pinnedHeaderRowsCount

integer

固定するテーブルの行数。0 は、すべての行の固定が解除されることを意味します。