ドキュメントの更新(Update Document)

Google Docsの指定のドキュメントを更新します。

オプション

フィールド 定義 タイプ 必須

操作タイプ(Operation Type)

次のいずれかのメソッドを選択します。

  • Find and Replace:ドキュメント内の既存のテキストを新しいテキストに置き換えます。

  • Insert Text:ドキュメントにテキストを挿入します。

  • Update Text Style:ドキュメントのテキストスタイルを更新します。

  • Create Paragraph Bullets:ドキュメントに段落ブレットを作成します。

  • Update Paragraph Style:ドキュメント内の段落を更新します。

  • Insert Inline Image:ドキュメントにインライン画像を挿入します。「Google Docsコネクターに関するガイダンス」の「インライン画像を挿入する」を参照してください。

ドロップダウン

入力

フィールド 定義 タイプ Required (必須)

ドキュメント(Document)

ID

ドキュメントの一意のID。

テキスト

アップデート(Update)

検索(Find)

置き換えの対象となるテキスト。

このフィールドは、操作タイプ(Operation Type)オプションでFind and Replaceを選択した場合に表示されます。

テキスト

置換(Replace With)

検索(Find)の入力で指定された内容を置き換えるテキスト。

このフィールドが空または消去された場合、置き換えテキスト(Text To Replace)フィールドはドキュメントから削除されます。

このフィールドは、操作タイプ(Operation Type)オプションでFind and Replaceを選択した場合に表示されます。

テキスト FALSE

大文字/小文字の一致(Match Case?)

検索で大文字と小文字を指定する場合はTrueを選択します。それ以外の場合は Falseに設定します。

このフィールドは、操作タイプ(Operation Type)オプションでFind and Replaceを選択した場合に表示されます。

True/False FALSE

テキスト(Text)

ドキュメントに挿入するテキスト。

Google Docsコネクターに関するガイダンス」のテキストを参照してください。

このフィールドは、操作タイプ(Operation Type)オプションでInsert Textを選択した場合に表示されます。

テキスト

インデックス(Index)

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

インデックス値は、セグメントID(Segment ID)によって指定されるセグメントの先頭に対して相対的です。セグメントID(Segment ID)の入力なしで使用すると、本文とテキストが本文に設定されます。

Google Docsコネクターに関するガイダンス」のインデックスを参照してください。

このフィールドは、操作タイプ(Operation Type)オプションでInsert TextまたはInsert Inline Imageを選択した場合に表示されます。

テキスト FALSE

開始インデックス(Start Index)

この範囲のゼロベースの開始インデックス。

ドキュメント本文では、開始インデックス(Start Index)および終了インデックス(End Index)プロパティのインデックス値が使用されます。これらはそれぞれ、行の先頭の文字と末尾の文字のインデックスを表します。開始および終了インデックスの取得にはドキュメントの読み取りカードが使用されます。

特定のセグメント(ヘッダー、フッター、脚注)では、終了インデックス(End Index)は行の長さとして使用されます。

開始インデックスは常に0です。

このフィールドは、操作タイプ(Operation Type)オプションでUpdate Text StyleCreate Paragraph Bullets、またはUpdate Paragraph Styleを選択した場合に表示されます。

テキスト

終了インデックス(End Index)

この範囲のゼロベースの終了インデックス(排他的)。

ドキュメント本文では、開始インデックス(Start Index)および終了インデックス(End Index)プロパティのインデックス値が使用されます。これらはそれぞれ、行の先頭の文字と末尾の文字のインデックスを表します。開始および終了インデックスの取得にはドキュメントの読み取りカードが使用されます。

特定のセグメント(ヘッダー、フッター、脚注)では、終了インデックス(End Index)は行の長さとして使用されます。

開始インデックスは常に0です。

このフィールドは、操作タイプ(Operation Type)オプションでUpdate Text StyleCreate Paragraph Bullets、またはUpdate Paragraph Styleを選択した場合に表示されます。

テキスト

セグメントID(Segment ID)

ヘッダー、フッター、または脚注が配置されている場所のID。

空のセグメントID(Segment ID)値は、ドキュメントの本文を使用します。

このフィールドが指定され、インデックス(Index)フィールドが空の場合、使用される場所は本文、ヘッダー、フッター、脚注の末尾となります。それ以外の場合は、ドキュメントセグメント内の最後の改行の直前となります。

Google Docsコネクターに関するガイダンス」のセグメントIDを参照してください。

このフィールドは、操作タイプ(Operation Type)オプションでUpdate Text StyleCreate Paragraph BulletsUpdate Paragraph Style、またはInsert Inline Imageを選択した場合に表示されます。

テキスト FALSE

デフォルトにリセット?(Reset To Default?)

選択した入力をデフォルト値にリセットする場合はTrueを選択します。それ以外の場合は Falseに設定します。

入力をデフォルト値に更新するには、それを入力フィールドとして選択します。

次のフィールドはデフォルト値に設定できず、無視されます。

  • Font Weight

  • Link

  • Link Type

このフィールドは、操作タイプ(Operation Type)オプションでUpdate Text StyleまたはUpdate Paragraph Styleを選択した場合に表示されます。

True/False FALSE

太字(Bold)

テキストを太字で表示するには、Trueを選択します。それ以外の場合は Falseに設定します。

このフィールドは、操作タイプ(Operation Type)オプションでUpdate Text Styleを選択した場合に表示されます。

True/False FALSE

斜体(Italic)

テキストを斜体で表示するには、Trueを選択します。それ以外の場合は Falseに設定します。

このフィールドは、操作タイプ(Operation Type)オプションでUpdate Text Styleを選択した場合に表示されます。

True/False FALSE

下線(Underline)

テキストを下線付きで表示するには、Trueを選択します。それ以外の場合は Falseに設定します。

このフィールドは、操作タイプ(Operation Type)オプションでUpdate Text Styleを選択した場合に表示されます。

True/False FALSE

取り消し線(Strikethrough)

テキストに取り消し線を表示するには、Trueを選択します。それ以外の場合は Falseに設定します。

このフィールドは、操作タイプ(Operation Type)オプションでUpdate Text Styleを選択した場合に表示されます。

True/False FALSE

スモールキャップ(Small Caps)

小型の大文字を使用してテキストをレンダリングするには、Trueを選択します。それ以外の場合は Falseに設定します。

このフィールドは、操作タイプ(Operation Type)オプションでUpdate Text Styleを選択した場合に表示されます。

True/False FALSE

背景色(Background Color)

テキストの背景色。

RGBまたはHEXの色の値。

各色の値の形式は、次のいずれかでなければなりません。

  • RGB:255,10,34

  • HEX:#ff00d3または#fff

このフィールドは、操作タイプ(Operation Type)オプションでUpdate Text Styleを選択した場合に表示されます。

テキスト FALSE

前景色(Foreground Color)

テキストの前景色。

RGBまたはHEXの色の値。

各色の値の形式は、次のいずれかでなければなりません。

  • RGB:255,10,34

  • HEX:#ff00d3または#fff

このフィールドは、操作タイプ(Operation Type)オプションでUpdate Text Styleを選択した場合に表示されます。

テキスト FALSE

フォントサイズ(Font Size)

テキストのフォントサイズ。

単位はポイントで1/72インチに相当します。

デフォルトサイズは11です。

このフィールドは、操作タイプ(Operation Type)オプションでUpdate Text Styleを選択した場合に表示されます。

テキスト FALSE

フォントファミリー(Font Family)

テキストのフォントファミリー。

Google DocsのフォントメニューまたはGoogle Docsからの任意のフォントが受け付けられます。

デフォルトフォントはArialです。

このフィールドは、操作タイプ(Operation Type)オプションでUpdate Text Styleを選択した場合に表示されます。

ドロップダウン FALSE

フォントの太さ(Font Weight)

フォントの太さ。

このフィールドには、100から900までの100の倍数の値を指定できます。この範囲は、CSS 2.1仕様の15.6節に記載された数値に対応し、数値以外の値は許可されません。

デフォルト値は400(標準)です。

このフィールドは、フォントファミリー(Font Family)フィールドと併用する必要があり、そうでない場合はカードがエラーを返します。

Google Docsコネクターに関するガイダンス(Font Weight)フォントの太さを参照してください。

このフィールドは、操作タイプ(Operation Type)オプションでUpdate Text Styleを選択した場合に表示されます。

ドロップダウン FALSE

ベースラインオフセット(Baseline Offset)

通常の位置からのテキストの垂直オフセット。

  • Unspecified:テキストのベースラインオフセットは、親から継承されます。
  • None:テキストは垂直にオフセットされません。
  • Superscript(上付き):テキストは上方向に垂直にオフセットされます(上付き)。
  • Subscript(下付き):テキストは下方向に垂直にオフセットされます(下付き)。

このフィールドは、操作タイプ(Operation Type)オプションでUpdate Text Styleを選択した場合に表示されます。

ドロップダウン FALSE

リンク

ドキュメントの別の部分または外部URLリソースへの参照。

このフィールドに値が取り込まれているときは、リンクタイプ(Link Type)フィールドを含める必要があります。

このフィールドは、操作タイプ(Operation Type)オプションでUpdate Text Styleを選択した場合に表示されます。

ドロップダウン FALSE

リンクタイプ(Link Type)

参照するリンクの種類:

  • External URL:外部URL。
  • Bookmark ID:このドキュメント内のブックマークのID。
  • Heading ID:このドキュメント内の見出しのID。

このフィールドに値が取り込まれているときは、リンク(Link)フィールドを含める必要があります。

このフィールドは、操作タイプ(Operation Type)オプションでUpdate Text Styleを選択した場合に表示されます。

ドロップダウン FALSE

段落ブレット作成(Create Paragraph Bullets)

Create Paragraph Bulletsオプションには、次のフィールドが関連します。

セット済みビュレット(Bullet Glyph Preset)

使用するビュレットのタイプ。

  • Disc - Circle - Square

  • DiamondX - Arrow3D - Square

  • Checkbox

  • Arrow - Diamond - Disc

  • Star - Circle - Square

  • Arrow3D - Circle - Square

  • LeftTriangle - Diamond - Disc

  • DiamondX - HollowDiamond - Square

  • Diamond - Circle - Square

  • Decimal - Alpha - Roman

  • Parenthesis - Decimal - Alpha - Roman

  • Numbered - Decimal - Nested

  • UpperAlpha - Alpha - Roman

  • UpperRoman - UpperAlpha - Decimal

  • ZeroDecimal - Alpha - Roman

このフィールドは、操作タイプ(Operation Type)オプションでUpdate Text Styleを選択した場合に表示されます。

ドロップダウン

名前付きスタイルタイプ(Named Style Type)

段落の名前付きスタイルタイプ。

  • Normal Text
  • Title
  • Subtitle
  • Heading 1
  • Heading 2
  • Heading 3
  • Heading 4
  • Heading 5
  • Heading 6

このフィールドは、操作タイプ(Operation Type)オプションでUpdate Paragraph Styleを選択した場合に表示されます。

ドロップダウン FALSE

テキスト配置(Text Alignment)

段落のテキストの配置。

  • Inherited:配置は親から継承されます。

  • Start

  • Center

  • End

  • Justified

このフィールドは、操作タイプ(Operation Type)オプションでUpdate Paragraph Styleを選択した場合に表示されます。

ドロップダウン FALSE

行間(Line Spacing)

行の間のスペースの量。通常を100とした、通常に対する割合として表現します。

テキスト FALSE

テキスト方向(Text Direction)

段落のテキストの方向。

値が未設定の場合、段落の方向は継承されないため、値はデフォルトでLeft to right(左から右)になります。

  • Left to right
  • Right to left

このフィールドは、操作タイプ(Operation Type)オプションでUpdate Paragraph Styleを選択した場合に表示されます。

ドロップダウン FALSE

スペーシングモード(Spacing Mode)

段落のスペーシングモード。

  • Inherited:配置は親から継承されます。
  • Never collapse(折り畳みなし):段落のスペーシングは常に表示されます。
  • Collapse lists(折り畳みリスト):リスト要素間で段落のスペーシングはスキップされます。

このフィールドは、操作タイプ(Operation Type)オプションでUpdate Paragraph Styleを選択した場合に表示されます。

ドロップダウン FALSE

上スペース(Space Above)

段落の上の余分なスペースの量。

値が未設定の場合、親から継承されます。

単位はポイントで1/72インチに相当します。

このフィールドは、操作タイプ(Operation Type)オプションでUpdate Paragraph Styleを選択した場合に表示されます。

テキスト FALSE

下スペース(Space Below)

段落の下の余分なスペースの量。

値が未設定の場合、親から継承されます。

単位はポイントで1/72インチに相当します。

このフィールドは、操作タイプ(Operation Type)オプションでUpdate Paragraph Styleを選択した場合に表示されます。

テキスト FALSE

1行目インデント(First Line Indentation)

段落の最初の行のインデントの量。

値が未設定の場合、親から継承されます。

単位はポイントで1/72インチに相当します。

このフィールドは、操作タイプ(Operation Type)オプションでUpdate Paragraph Styleを選択した場合に表示されます。

テキスト FALSE

開始インデント(Start Indentation)

現在の段落の向きに応じて、テキストの開始位置に対応する側の段落のインデント量。

値が未設定の場合、親から継承されます。

単位はポイントで1/72インチに相当します。

このフィールドは、操作タイプ(Operation Type)オプションでUpdate Paragraph Styleを選択した場合に表示されます。

テキスト FALSE

終了インデント(End Indentation)

現在の段落の向きに応じて、テキストの終了位置に対応する側の段落のインデント量。

値が未設定の場合、親から継承されます。

単位はポイントで1/72インチに相当します。

このフィールドは、操作タイプ(Operation Type)オプションでUpdate Paragraph Styleを選択した場合に表示されます。

テキスト FALSE

行をまとめる?(Keep Lines Together?)

段落のすべての行を可能な限り同じページまたは列にレイアウトする場合は、Trueを選択します。それ以外の場合は Falseに設定します。

値が未設定の場合、親から継承されます。

このフィールドは、操作タイプ(Operation Type)オプションでUpdate Paragraph Styleを選択した場合に表示されます。

True/False FALSE

次の段落と分離しない?(Keep With Next?)

少なくともこの段落の一部を次の段落と可能な限り同じページまたは列にレイアウトする場合は、Trueを選択します。それ以外の場合は Falseに設定します。

値が未設定の場合、親から継承されます。

このフィールドは、操作タイプ(Operation Type)オプションでUpdate Paragraph Styleを選択した場合に表示されます。

True/False FALSE

シェーディング(Shading)

段落の網掛けの色。

RGBまたはHEXの色の値。

各色の値の形式は、次のいずれかでなければなりません。

  • RGB:255,10,34

  • HEX:#ff00d3または#fff

このフィールドは、操作タイプ(Operation Type)オプションでUpdate Paragraph Styleを選択した場合に表示されます。

テキスト FALSE

画像URL(Image URL)

画像のUniform Resource Indicator(URI)。画像は挿入時に取得され、ドキュメント内に表示するためにコピーが保存されます。

画像は50 MB未満、2,500万画素以下、PNG、JPEG、またはGIF形式でなければなりません。

指定するURIの長さは2 KB以内にします。URIは画像とともに保存され、ImageProperties.content_uriフィールドを通じて公開されます。

このフィールドは、操作タイプ(Operation Type)オプションでInsert Inline Imageを選択した場合に表示されます。

テキスト

画像高さ(Image Height)

画像の高さ。

単位はポイントで1/72インチに相当します。

Google Docsコネクターに関するガイダンス」の画像高さを参照してください。

このフィールドは、操作タイプ(Operation Type)オプションでInsert Inline Imageを選択した場合に表示されます。

テキスト FALSE

画像幅(Image Width)

画像の幅。

単位はポイントで1/72インチに相当します。

Google Docsコネクターに関するガイダンス」の画像幅を参照してください。

このフィールドは、操作タイプ(Operation Type)オプションでInsert Inline Imageを選択した場合に表示されます。

テキスト FALSE

書き込み制御(Write Control)

リビジョンID(Revision ID)

リビジョンの一意のID。

テキスト FALSE

リビジョンタイプ(Revision Type)

リビジョンのタイプを選択します。

  • Required:書き込みリクエストが適用されるドキュメントの任意のリビジョンID。これがドキュメントの最新リビジョンでない場合、リクエストは処理されず、400エラーが返されます。

    必要なリビジョンIDが応答で返された場合、それはリクエスト適用後のドキュメントのリビジョンIDを示します。

  • Target:書き込みリクエストが適用されるドキュメントの任意のターゲットリビジョンID。

    APIを使用してドキュメントを読み込んだ後に共同作業者が変更を加えた場合、この更新リクエストによって生成された変更が、共同作業者の変更に対して適用されます。この結果、共同作業者の変更とこの変更リクエストの両方が反映された新しいリビジョンのドキュメントが作成されます。変更の競合はGoogle Docsサーバーによって解決されます。ターゲットリビジョンIDを使用する場合、APIクライアントはドキュメントのもう1人の共同作業者として機能します。

    ターゲットリビジョンIDは、ドキュメントの最近のバージョンに書き込む場合にのみ使用できます。ターゲットリビジョンが最新リビジョンから大きく外れている場合、リクエストは処理されず、400エラーが返されます。最新バージョンのドキュメントを取得した後に、再度リクエストを試みます。通常、リビジョンIDは読み込まれてから数分間はターゲットリビジョンとして有効ですが、頻繁に編集されるドキュメントでは、この時間より短くなる可能性があります。

ドロップダウン FALSE

出力

フィールド 定義 タイプ

結果(Result)

必須リビジョンID(Required Revision ID)

ドキュメントのリビジョンID。

更新リクエスト内でリビジョンIDを使用して更新適用先ドキュメントのリビジョンを指定し、そのリビジョン以降にドキュメントが編集されていた場合のリクエストの振る舞いを指定します。

このフィールドは、操作タイプ(Operation Type)オプションでInsert TextUpdate Text StyleCreate Paragraph Bullets、またはUpdate Paragraph Styleを選択した場合に表示されます。

テキスト

変更数(Occurrences Changed)

カードによって変更されるパターンの数。

このフィールドは、操作タイプ(Operation Type)オプションでFind and Replaceを選択した場合に表示されます。

数値

インライン画像オブジェクトID(Inline Image Object ID)

挿入された画像オブジェクトのID。

このフィールドは、操作タイプ(Operation Type)オプションでInsert Inline Imageを選択した場合に表示されます。

テキスト