Requests

リクエスト

ドキュメントに適用する単一の更新。

JSON 表現
{

  "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)
  },
  "addDocumentTab": {
    object (AddDocumentTabRequest)
  },
  "deleteTab": {
    object (DeleteTabRequest)
  },
  "updateDocumentTabProperties": {
    object (UpdateDocumentTabPropertiesRequest)
  },
  "insertPerson": {
    object (InsertPersonRequest)
  },
  "updateNamedStyle": {
    object (UpdateNamedStyleRequest)
  },
  "insertRichLink": {
    object (InsertRichLinkRequest)
  },
  "insertDate": {
    object (InsertDateRequest)
  },
  "insertComment": {
    object (InsertCommentRequest)
  },
  "addCommentReply": {
    object (AddCommentReplyRequest)
  },
  "updateCommentPost": {
    object (UpdateCommentPostRequest)
  },
  "deleteComment": {
    object (DeleteCommentRequest)
  },
  "deleteCommentReply": {
    object (DeleteCommentReplyRequest)
  },
  "acceptSuggestion": {
    object (AcceptSuggestionRequest)
  },
  "rejectSuggestion": {
    object (RejectSuggestionRequest)
  },
  "deleteSuggestion": {
    object (DeleteSuggestionRequest)
  }
}
フィールド
適用する具体的なリクエスト。フィールドは 1 つだけ必要です。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 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)

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

addDocumentTab

object (AddDocumentTabRequest)

ドキュメント タブを追加します。

deleteTab

object (DeleteTabRequest)

ドキュメント タブを削除します。

updateDocumentTabProperties

object (UpdateDocumentTabPropertiesRequest)

ドキュメント タブのプロパティを更新します。

insertPerson

object (InsertPersonRequest)

ユーザーのメンションを挿入します。

updateNamedStyle

object (UpdateNamedStyleRequest)

名前付きスタイルを更新します。

insertDate

object (InsertDateRequest)

日付を挿入します。

insertComment

object (InsertCommentRequest)

ドキュメントに CommentThread を挿入します。

addCommentReply

object (AddCommentReplyRequest)

CommentThread または SuggestionThread に返信を追加します。

updateCommentPost

object (UpdateCommentPostRequest)

CommentThread または SuggestionThread の既存の投稿(ヘッド投稿または返信)を更新します。

deleteComment

object (DeleteCommentRequest)

CommentThread を削除します。

deleteCommentReply

object (DeleteCommentReplyRequest)

CommentThread または SuggestionThread から返信 Post を削除します。

acceptSuggestion

object (AcceptSuggestionRequest)

候補を承認します。

rejectSuggestion

object (RejectSuggestionRequest)

候補を拒否します。

deleteSuggestion

object (DeleteSuggestionRequest)

候補を削除します。

相互に排他的なフィールドの終了。

ReplaceAllTextRequest

条件に一致するテキストのすべてのインスタンスを replace text に置き換えます。

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

  "containsText": {
    object (SubstringMatchCriteria)
  }
}
フィールド
replaceText

string

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

tabsCriteria

object (TabsCriteria)

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

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

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

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

  • 省略すると、置換は単一のタブに適用されます。

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

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

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

置換するテキストの照合に使用される条件。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 1 つです。
containsText

object (SubstringMatchCriteria)

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

相互に排他的なフィールドの終了。

SubstringMatchCriteria

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

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

string

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

matchCase

boolean

検索で大文字と小文字を区別するかどうかを示します。

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

boolean

省略可。検索値を正規表現として扱う場合は true。パターン内のバックスラッシュはエスケープする必要があります。

  • True : 検索テキストが正規表現として扱われます。
  • False : 検索テキストは、照合用の部分文字列として扱われます。

TabsCriteria

リクエストが実行されるタブを指定する条件。

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

string

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

InsertTextRequest

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

JSON 表現
{
  "text": string,

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
フィールド
text

string

挿入するテキスト。

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

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

挿入されたテキストから、一部の制御文字(U+0000 ~ U+0008、U+000C ~ U+001F)と Unicode 基本多言語面の私用領域(U+E000 ~ U+F8FF)の文字が削除されます。

テキストが挿入される場所。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 1 つです。
location

object (Location)

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

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

endOfSegmentLocation

object (EndOfSegmentLocation)

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

相互に排他的なフィールドの終了。

Location

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

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

string

場所が属するヘッダー、フッター、脚注の ID。セグメント ID が空の場合、ドキュメントの本文を示します。

index

integer

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

インデックスは、segmentId で指定されたセグメントの先頭を基準としています。

tabId

string

場所が属するタブ。省略すると、リクエストは最初のタブに適用されます。

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

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

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

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

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

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

EndOfSegmentLocation

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

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

string

場所が属するヘッダー、フッター、脚注の ID。セグメント ID が空の場合、ドキュメントの本文を示します。

tabId

string

場所が属するタブ。省略すると、リクエストは最初のタブに適用されます。

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

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

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

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

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

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

UpdateTextStyleRequest

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

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

  "range": {
    object (Range)
  }
}
フィールド
textStyle

object (TextStyle)

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

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

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

fields

string (FieldMask format)

更新するフィールド。

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

たとえば、テキスト スタイルを太字に更新するには、fields を "bold" に設定します。

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

テキスト スタイルが更新される範囲のタイプ。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 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 : Unicode U+27a2 コードポイントに対応する 3D シェーディング付きの矢印
  • 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 桁の数字の前に 0 が付いた数字(「01」、「02」、「03」など)。2 桁以上の数字にはゼロは付きません。
  • ROMAN : 小文字のローマ数字(「i」、「ii」、「iii」など)。
  • UPPERROMAN : 大文字のローマ数字(「I」、「II」、「III」など)。
  • LEFTTRIANGLE : 左向きの三角形。Unicode U+25c4 コードポイントに対応します。
列挙型
BULLET_GLYPH_PRESET_UNSPECIFIED 箇条書きのグリフのプリセットが指定されていません。
BULLET_DISC_CIRCLE_SQUARE 最初の 3 つのリストのネストレベルの DISC、CIRCLE、SQUARE の箇条書きグリフを含む箇条書きリスト。
BULLET_DIAMONDX_ARROW3D_SQUARE 最初の 3 つのリストのネストレベルの DIAMONDX、ARROW3D、SQUARE の箇条書きグリフを含む箇条書きリスト。
BULLET_CHECKBOX すべてのリストのネストレベルの CHECKBOX 箇条書きグリフを含む箇条書きリスト。
BULLET_ARROW_DIAMOND_DISC 最初の 3 つのリストのネストレベルの ARROW、DIAMOND、DISC の箇条書きグリフを含む箇条書きリスト。
BULLET_STAR_CIRCLE_SQUARE 最初の 3 つのリストのネストレベルの STAR、CIRCLE、SQUARE の箇条書きグリフを含む箇条書きリスト。
BULLET_ARROW3D_CIRCLE_SQUARE 最初の 3 つのリストのネストレベルの ARROW3D、CIRCLE、SQUARE の箇条書きグリフを含む箇条書きリスト。
BULLET_LEFTTRIANGLE_DIAMOND_DISC 最初の 3 つのリストのネストレベルの LEFTTRIANGLE、DIAMOND、DISC の箇条書きグリフを含む箇条書きリスト。
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE 最初の 3 つのリストのネストレベルの DIAMONDX、HOLLOWDIAMOND、SQUARE の箇条書きグリフを含む箇条書きリスト。
BULLET_DIAMOND_CIRCLE_SQUARE 最初の 3 つのリストのネストレベルの DIAMOND、CIRCLE、SQUARE の箇条書きグリフを含む箇条書きリスト。
NUMBERED_DECIMAL_ALPHA_ROMAN 最初の 3 つのリストのネスト レベルに DECIMAL、ALPHA、ROMAN の数値グリフを使用し、その後にピリオドを続ける番号付きリスト。
NUMBERED_DECIMAL_ALPHA_ROMAN_PARENS 最初の 3 つのリスト ネストレベルに DECIMAL、ALPHA、ROMAN の数値グリフを使用し、その後に括弧を付けた番号付きリスト。
NUMBERED_DECIMAL_NESTED DECIMAL 数値グリフがピリオドで区切られた番号付きリスト。各ネストレベルでは、前のネストレベルのグリフが接頭辞として使用されます。例: 「1.」、'1.1.', '2.', '2.2.'。
NUMBERED_UPPERALPHA_ALPHA_ROMAN 最初の 3 つのリストのネスト レベルに UPPERALPHA、ALPHA、ROMAN の数値グリフを使用し、その後にピリオドを続ける番号付きリスト。
NUMBERED_UPPERROMAN_UPPERALPHA_DECIMAL 最初の 3 つのリストのネスト レベルに UPPERROMAN、UPPERALPHA、DECIMAL の数値グリフを使用し、その後にピリオドを続ける番号付きリスト。
NUMBERED_ZERODECIMAL_ALPHA_ROMAN 最初の 3 つのリストのネスト レベルに ZERODECIMAL、ALPHA、ROMAN の数値グリフを使用し、その後にピリオドを続ける番号付きリスト。

DeleteParagraphBulletsRequest

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

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

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

object (Range)

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

CreateNamedRangeRequest

指定された範囲を参照する NamedRange を作成します。

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

string

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

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

range

object (Range)

名前を適用する範囲。

DeleteNamedRangeRequest

NamedRange を削除します。

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

  "namedRangeId": string,
  "name": string
}
フィールド
tabsCriteria

object (TabsCriteria)

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

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

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

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

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

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

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

削除する範囲を決定する値。必ず 1 つ設定する必要があります。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 1 つです。
namedRangeId

string

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

name

string

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

相互に排他的なフィールドの終了。

UpdateParagraphStyleRequest

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

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

  "range": {
    object (Range)
  }
}
フィールド
paragraphStyle

object (ParagraphStyle)

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

一部の段落スタイルの変更は、ドキュメント エディタの動作を反映するために、他の変更を引き起こす可能性があります。詳細については、ParagraphStyle のドキュメントをご覧ください。

fields

string (FieldMask format)

更新するフィールド。

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

たとえば、段落スタイルの配置プロパティを更新するには、fields を "alignment" に設定します。

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

段落スタイルが更新される範囲のタイプ。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 1 つです。
range

object (Range)

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

相互に排他的なフィールドの終了。

DeleteContentRangeRequest

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

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

object (Range)

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

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

特定の範囲を削除しようとすると、ドキュメント構造が無効になり、400 Bad Request エラーが返されることがあります。

無効な削除リクエストの例を次に示します。

  • サロゲート ペアの 1 つのコード単位を削除します。
  • Body、Header、Footer、Footnote、TableCell、TableOfContents の最後の改行文字を削除します。
  • 要素全体を削除せずに、Table、TableOfContents、Equation の開始または終了を削除します。
  • Table、TableOfContents、SectionBreak の前の改行文字を削除します。要素は削除しません。
  • テーブルの個々の行またはセルを削除する。テーブル セル内のコンテンツの削除は許可されます。

InsertInlineImageRequest

指定された場所に画像を含む InlineObject を挿入します。

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

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
フィールド
uri

string

画像 URI。

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

指定された URI は一般公開されており、長さが 2 kB 以下である必要があります。URI 自体は画像とともに保存され、ImageProperties.content_uri フィールドを介して公開されます。

objectSize

object (Size)

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

画像が挿入される場所。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 1 つです。
location

object (Location)

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

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

インライン画像は、脚注や数式の中に挿入できません。

endOfSegmentLocation

object (EndOfSegmentLocation)

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

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

相互に排他的なフィールドの終了。

InsertTableRequest

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

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

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

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
フィールド
rows

integer

テーブル内の行数。

columns

integer

テーブル内の列数。

テーブルが挿入される場所。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 1 つです。
location

object (Location)

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

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

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

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

endOfSegmentLocation

object (EndOfSegmentLocation)

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

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

相互に排他的なフィールドの終了。

InsertTableRowRequest

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

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

object (TableCellLocation)

行が挿入される基準テーブルのセルの位置。

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

insertBelow

boolean

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

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

TableCellLocation

テーブル内の単一のセルの位置。

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 表現
{

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
フィールド
改ページが挿入される位置。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 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 と一致する必要があります。

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

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

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

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

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 Bad Request エラーが返されます。

fields

string (FieldMask format)

更新するフィールド。

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

たとえば、列の幅を更新するには、fields を "width" に設定します。

UpdateTableCellStyleRequest

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

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

  "tableRange": {
    object (TableRange)
  },
  "tableStartLocation": {
    object (Location)
  }
}
フィールド
tableCellStyle

object (TableCellStyle)

テーブルのセルに設定するスタイル。

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

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

  • borderRight
  • borderLeft
  • borderBottom
  • borderTop
fields

string (FieldMask format)

更新するフィールド。

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

たとえば、テーブル セルの背景色を更新するには、fields を "backgroundColor" に設定します。

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

更新されるセル。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 1 つです。
tableRange

object (TableRange)

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

tableStartLocation

object (Location)

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

相互に排他的なフィールドの終了。

TableRange

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

テーブル範囲で指定されたセルが必ずしも長方形を形成するとは限りません。たとえば、最後の行のすべてのセルが結合されている 3 行 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。

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

指定された URI の長さは 2 KB を超えることはできません。URI は画像とともに保存され、ImageProperties.source_uri フィールドを通じて公開されます。

imageReplaceMethod

enum (ImageReplaceMethod)

置換メソッド。

tabId

string

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

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

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

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

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

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

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

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 と一致する必要があります。

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

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

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

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

MergeTableCellsRequest

Table のセルを結合します。

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

object (TableRange)

テーブルのどのセルを結合するかを指定するテーブル範囲。

結合されるセル内のテキストは連結され、範囲の「先頭」セルに保存されます。コンテンツの方向が左から右の場合は範囲の左上のセル、それ以外の場合は範囲の右上のセルです。

範囲が長方形でない場合(範囲がすでに結合されているセルをカバーしている場合や、テーブルが長方形でない場合に発生することがあります)、400 不正なリクエスト エラーが返されます。

UnmergeTableCellsRequest

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

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

object (TableRange)

テーブルのどのセルを結合解除するかを指定するテーブル範囲。

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

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

CreateHeaderRequest

Header を作成します。新しいヘッダーは、指定されている場合は SectionBreak の場所にある SectionStyle に適用されます。指定されていない場合は、DocumentStyle に適用されます。

指定されたタイプのヘッダーがすでに存在する場合は、400 Bad Request エラーが返されます。

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

enum (HeaderFooterType)

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

sectionBreakLocation

object (Location)

このヘッダーが属するセクションの先頭にある SectionBreak の位置。`sectionBreakLocation` が設定されていない場合、またはドキュメント本文の最初のセクション区切りを参照している場合、ヘッダーは DocumentStyle に適用されます。

HeaderFooterType

作成できるヘッダーとフッターの種類。

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

CreateFooterRequest

Footer を作成します。新しいフッターは、 SectionBreak が指定されている場合は SectionBreak の場所にある SectionStyle に適用されます。それ以外の場合は DocumentStyle. に適用されます。

指定したタイプのフッターがすでに存在する場合は、400 Bad Request エラーが返されます。

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

enum (HeaderFooterType)

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

sectionBreakLocation

object (Location)

このフッターが属するセクションの SectionStyle の直前の SectionBreak の位置。これが設定されていない場合、またはドキュメントの最初のセクション区切りを参照している場合、フッターはドキュメント スタイルに適用されます。

CreateFootnoteRequest

Footnote セグメントを作成し、指定された場所に新しい FootnoteReference を挿入します。

新しい Footnote セグメントには、スペースと改行文字が含まれます。

JSON 表現
{

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
フィールド
脚注参照を挿入する場所。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 1 つです。
location

object (Location)

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

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

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

endOfSegmentLocation

object (EndOfSegmentLocation)

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

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

相互に排他的なフィールドの終了。

ReplaceNamedRangeContentRequest

指定された NamedRange または NamedRanges の内容を、指定された置換内容に置き換えます。

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

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

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

  "text": string

  "namedRangeId": string,
  "namedRangeName": string
}
フィールド
tabsCriteria

object (TabsCriteria)

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

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

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

  • 省略すると、置換は単一のタブに適用されます。

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

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

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

名前付き範囲の既存のコンテンツを置き換えるコンテンツ。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 1 つです。
text

string

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

相互に排他的なフィールドの終了。
コンテンツが置き換えられる名前付き範囲への参照。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 1 つです。
namedRangeId

string

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

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

namedRangeName

string

コンテンツが置き換えられる NamedRanges の名前。

指定された名前の named ranges が複数ある場合は、それぞれの内容が置き換えられます。指定された名前の範囲名が存在しない場合、リクエストは no-op になります。

相互に排他的なフィールドの終了。

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),

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
フィールド
sectionType

enum (SectionType)

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

ブレークが挿入される場所。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 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 と一致する必要があります。

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

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

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

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

DeleteFooterRequest

ドキュメントから Footer を削除します。

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

string

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

tabId

string

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

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

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

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

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

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

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

PinTableHeaderRowsRequest

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

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

object (Location)

ドキュメント内でテーブルが始まる位置。

pinnedHeaderRowsCount

integer

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

AddDocumentTabRequest

ドキュメント タブを追加します。指定されたインデックスにタブが追加されると、それ以降のすべてのタブのインデックスが増加します。

JSON 表現
{
  "tabProperties": {
    object (TabProperties)
  }
}
フィールド
tabProperties

object (TabProperties)

追加するタブのプロパティ。すべてのプロパティは省略可能です。

DeleteTabRequest

タブを削除します。タブに子タブがある場合は、子タブも削除されます。

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

string

削除するタブの ID。

UpdateDocumentTabPropertiesRequest

ドキュメント タブのプロパティを更新します。

JSON 表現
{
  "tabProperties": {
    object (TabProperties)
  },
  "fields": string
}
フィールド
tabProperties

object (TabProperties)

更新するタブのプロパティ。

fields

string (FieldMask format)

更新するフィールド。

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

InsertPersonRequest

ユーザーのメンションを挿入します。

JSON 表現
{
  "personProperties": {
    object (PersonProperties)
  },

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
フィールド
personProperties

object (PersonProperties)

挿入する人物メンションのプロパティ。

ユーザーのメンションが挿入される場所。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 1 つです。
location

object (Location)

ドキュメントの特定のインデックスにユーザーメンションを挿入します。

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

数式内にユーザーメンションを挿入することはできません。

endOfSegmentLocation

object (EndOfSegmentLocation)

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

相互に排他的なフィールドの終了。

UpdateNamedStyleRequest

名前付きスタイルを更新します。

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

object (NamedStyle)

更新するドキュメント スタイル。

fields

string (FieldMask format)

更新する NamedStyle フィールド。

少なくとも namedStyleType を指定する必要があります。ルート namedStyle は暗黙的に指定されるため、指定しないでください。単一の "*" は、すべてのフィールドを一覧表示する短縮形として使用できます。

たとえば、テキストのスタイルを太字に更新するには、fields を "textStyle" と "textStyle.bold" を含むように設定します。段落スタイルの配置プロパティを更新するには、fields を設定して "paragraphStyle" と "paragraphStyle.alignment" を含めます。

プロパティをデフォルト値にリセットするには、フィールド マスクにフィールド名を含めますが、フィールド自体は設定しないままにします。空の TextStyle または ParagraphStyle で "textStyle" または "paragraphStyle" を指定すると、ネストされたすべてのフィールドがリセットされます。

tabId

string

更新するドキュメント タブ。デフォルトでは、更新は最初のタブに適用されます。

InsertRichLinkRequest

指定した場所に RichLink を挿入します。

JSON 表現
{
  "richLinkProperties": {
    object (RichLinkProperties)
  },

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
フィールド
リッチリンクが挿入される場所。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 1 つです。
location

object (Location)

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

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

リッチリンクを数式内に挿入することはできません。

endOfSegmentLocation

object (EndOfSegmentLocation)

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

相互に排他的なフィールドの終了。

InsertDateRequest

指定した場所に日付を挿入します。

JSON 表現
{
  "dateElementProperties": {
    object (DateElementProperties)
  },

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
フィールド
dateElementProperties

object (DateElementProperties)

挿入する日付のプロパティ。

日付が挿入される場所。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 1 つです。
location

object (Location)

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

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

endOfSegmentLocation

object (EndOfSegmentLocation)

指定されたヘッダー、フッター、またはドキュメント本文の末尾に日付を挿入します。

相互に排他的なフィールドの終了。

InsertCommentRequest

ドキュメントに CommentThread を挿入します。

JSON 表現
{
  "content": string,
  "assigneeEmailAddress": string,

  "range": {
    object (Range)
  }
}
フィールド
content

string

コメントのテキスト(書式なしテキスト)。

このテキスト コンテンツは、ドキュメント エディタで作成されたコメントと同様に処理されます。書式設定や通知などについても同様の動作をします。

このフィールドは空にできず、2, 048 UTF-8 コード単位を超えてはなりません。

assigneeEmailAddress

string

省略可。コメントの割り当て先のメールアドレス。

割り当てられていないコメントの場合は空欄のままにします。

2,048 UTF-8 コード単位を超えてはなりません。

このコメントに関連付けられているドキュメント内の位置。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 1 つです。
range

object (Range)

このコメントに関連付けられているドキュメント内の Range。

相互に排他的なフィールドの終了。

AddCommentReplyRequest

CommentThread または SuggestionThread に返信 Post を挿入します。

JSON 表現
{
  "post": {
    object (Post)
  },

  "commentId": string,
  "suggestionId": string
}
フィールド
post

object (Post)

返信を表す Post。

返信を追加するスレッドの ID。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 1 つです。
commentId

string

返信を追加する CommentThread の ID。

suggestionId

string

返信を追加する SuggestionThread の ID。

相互に排他的なフィールドの終了。

UpdateCommentPostRequest

CommentThread または SuggestionThread の Post を更新します。

次の場合は、400 不正なリクエスト エラーを返します。

  • 投稿は SuggestionThread の headPost です。

  • リクエストしているユーザーが投稿の作成者ではありません。

JSON 表現
{
  "postId": string,
  "content": string,

  "commentId": string,
  "suggestionId": string
}
フィールド
postId

string

更新される投稿の ID。

content

string

コメントの新しいテキスト(書式なしテキスト)。

このテキスト コンテンツは、ドキュメント エディタで作成されたコメントと同様に処理されます。書式設定や通知などについても同様の動作をします。

このフィールドは空にできず、2, 048 UTF-8 コード単位を超えてはなりません。

投稿が属するスレッドの ID。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 1 つです。
commentId

string

投稿が属する CommentThread の ID。

suggestionId

string

投稿が属する SuggestionThread の ID。

相互に排他的なフィールドの終了。

DeleteCommentRequest

CommentThread を削除します。

リクエストを行ったユーザーが headPost の作成者でない場合は、400 Bad Request エラーを返します。

JSON 表現
{
  "commentId": string
}
フィールド
commentId

string

削除される CommentThread の ID。

DeleteCommentReplyRequest

CommentThread または SuggestionThread から返信 Post を削除します。

次の場合は、400 不正なリクエスト エラーを返します。

  • リクエストしているユーザーが投稿の作成者ではありません。

  • 返信投稿には [アクション][google.apps.docs.v1.Post.action] が含まれています。

  • 返信投稿には assignee が含まれています。

JSON 表現
{
  "postId": string,

  "commentId": string,
  "suggestionId": string
}
フィールド
postId

string

削除される返信 Post の ID。

投稿が属するスレッドの ID。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 1 つです。
commentId

string

投稿が属する CommentThread の ID。

suggestionId

string

投稿が属する SuggestionThread の ID。

相互に排他的なフィールドの終了。

AcceptSuggestionRequest

候補を承認します。

リクエストしているユーザーにドキュメントの編集権限がない場合は、403 Forbidden エラーを返します。

JSON 表現
{
  "suggestionId": string
}
フィールド
suggestionId

string

候補の ID。

RejectSuggestionRequest

候補を拒否します。

リクエストを行ったユーザーがドキュメントの編集権限を持っておらず、提案の作成者でもない場合は、403 Forbidden エラーを返します。

JSON 表現
{
  "suggestionId": string
}
フィールド
suggestionId

string

候補の ID。

DeleteSuggestionRequest

候補を削除します。

リクエストを行ったユーザーが提案の作成者でない場合は、403 Forbidden エラーを返します。

JSON 表現
{
  "suggestionId": string
}
フィールド
suggestionId

string

候補の ID。