Requests

object (CreateSlideRequest)

新しいスライドを作成します。

object (CreateShapeRequest)

新しいシェイプを作成します。

object (CreateTableRequest)

新しいテーブルを作成します。

object (InsertTextRequest)

シェイプまたは表のセルにテキストを挿入します。

object (InsertTableRowsRequest)

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

object (InsertTableColumnsRequest)

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

object (DeleteTableRowRequest)

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

object (DeleteTableColumnRequest)

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

object (ReplaceAllTextRequest)

指定されたテキストのすべてのインスタンスを置き換えます。

object (DeleteObjectRequest)

プレゼンテーションからページまたはページ要素を削除します。

object (UpdatePageElementTransformRequest)

ページ要素の変換を更新します。

object (UpdateSlidesPositionRequest)

プレゼンテーション内の一連のスライドの位置を更新します。

object (DeleteTextRequest)

図形または表のセルからテキストを削除します。

object (CreateImageRequest)

画像を作成します。

object (CreateVideoRequest)

動画を作成します。

object (CreateSheetsChartRequest)

埋め込みの Google スプレッドシートのグラフを作成します。

object (CreateLineRequest)

線を作成します。

object (RefreshSheetsChartRequest)

Google スプレッドシートのグラフを更新します。

object (UpdateShapePropertiesRequest)

Shape のプロパティを更新します。

object (UpdateImagePropertiesRequest)

Image のプロパティを更新します。

object (UpdateVideoPropertiesRequest)

Video のプロパティを更新します。

object (UpdatePagePropertiesRequest)

Page のプロパティを更新します。

object (UpdateTableCellPropertiesRequest)

TableCell のプロパティを更新します。

object (UpdateLinePropertiesRequest)

Line のプロパティを更新します。

object (CreateParagraphBulletsRequest)

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

object (ReplaceAllShapesWithImageRequest)

特定の条件に一致するすべての図形を画像に置き換えます。

object (DuplicateObjectRequest)

スライドまたはページ要素を複製します。

object (UpdateTextStyleRequest)

Shape または Table 内のテキストのスタイル設定を更新します。

object (ReplaceAllShapesWithSheetsChartRequest)

特定の条件に一致するすべての図形を Google スプレッドシートのグラフに置き換えます。

object (DeleteParagraphBulletsRequest)

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

object (UpdateParagraphStyleRequest)

Shape または Table 内の段落のスタイル設定を更新します。

object (UpdateTableBorderPropertiesRequest)

Table のテーブルの枠線のプロパティを更新します。

object (UpdateTableColumnPropertiesRequest)

Table 列のプロパティを更新します。

object (UpdateTableRowPropertiesRequest)

Table 行のプロパティを更新します。

object (MergeTableCellsRequest)

Table のセルを結合します。

object (UnmergeTableCellsRequest)

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

object (GroupObjectsRequest)

ページ要素などのオブジェクトをグループ化します。

object (UngroupObjectsRequest)

groups などのオブジェクトのグループ化を解除します。

object (UpdatePageElementAltTextRequest)

page element の代替テキストのタイトルや説明を更新します。

object (ReplaceImageRequest)

既存の画像を新しい画像に置き換えます。

object (UpdateSlidePropertiesRequest)

スライドのプロパティを更新します。

object (UpdatePageElementsZOrderRequest)

page elements の Z オーダーを更新します。

object (UpdateLineCategoryRequest)

line のカテゴリを更新します。

object (RerouteLineRequest)

接続されたページ要素の最も近い 2 つの接続サイトで接続されるように line を再ルーティングします。

object (InsertCommentRequest)

プレゼンテーションに CommentThread を挿入します。

object (AddCommentReplyRequest)

CommentThread に返信を追加します。

object (UpdateCommentPostRequest)

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

object (DeleteCommentRequest)

CommentThread を削除します。

object (DeleteCommentReplyRequest)

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

string

ユーザー指定のオブジェクト ID。

ID を指定する場合は、プレゼンテーション内のすべてのページとページ要素の中で一意である必要があります。ID は英数字またはアンダースコアで始まり（正規表現 [a-zA-Z0-9_] に一致）、残りの文字には英数字、アンダースコア、ハイフン、コロンを使用できます（正規表現 [a-zA-Z0-9_-:] に一致）。ID の長さは 5 ～ 50 文字にする必要があります。

ID を指定しない場合は、一意の ID が生成されます。

integer

スライドを挿入する場所を示す 0 から始まるインデックス（省略可）。

インデックスを指定しない場合、スライドは末尾に作成されます。

object (LayoutReference)

挿入するスライドのレイアウト参照。現在のマスターに基づく。次のいずれかになります。

• 前のスライドのマスター インデックス。
• insertionIndex が 0 の場合、最初のスライドのマスター。
• スライドがない場合、プレゼンテーションの最初のマスター。

LayoutReference が現在のマスターに見つからない場合は、400 の不正なリクエスト エラーが返されます。

レイアウト参照を指定しない場合、スライドは事前定義された BLANK レイアウトを使用します。

object (LayoutPlaceholderIdMapping)

レイアウトの placeholder（複数可）から、指定されたレイアウトからスライドに作成されたプレースホルダへのオブジェクト ID マッピングのオプションのリスト。slideLayoutReference が指定されている場合にのみ使用できます。

enum (PredefinedLayout)

事前定義されたレイアウト。

string

レイアウト ID: プレゼンテーション内のレイアウトのオブジェクト ID。

string

スライド上に作成される上記のプレースホルダのユーザー指定のオブジェクト ID。

ID を指定する場合は、プレゼンテーション内のすべてのページとページ要素の中で一意である必要があります。ID は英数字またはアンダースコアで始まる必要があります（正規表現 [a-zA-Z0-9_] に一致）。残りの文字には、英数字、アンダースコア、ハイフン、コロンを使用できます（正規表現 [a-zA-Z0-9_-:] に一致）。ID の長さは 5 ～ 50 文字にする必要があります。

ID を指定しない場合は、一意の ID が生成されます。

object (Placeholder)

スライドに適用されるレイアウトのプレースホルダ。type と index のみが必要です。たとえば、事前定義された TITLE_AND_BODY レイアウトには通常、インデックス 0 の TITLE プレースホルダとインデックス 0 の BODY プレースホルダがあります。

string

スライドに適用されるレイアウトのプレースホルダのオブジェクト ID。

string

ユーザー指定のオブジェクト ID。

ID を指定する場合は、プレゼンテーション内のすべてのページとページ要素の中で一意である必要があります。ID は英数字またはアンダースコアで始まる必要があります（正規表現 [a-zA-Z0-9_] に一致）。残りの文字には、英数字、アンダースコア、ハイフン、コロンを使用できます（正規表現 [a-zA-Z0-9_-:] に一致）。ID の長さは 5 ～ 50 文字にする必要があります。空の場合、一意の識別子が生成されます。

object (PageElementProperties)

シェイプの要素プロパティ。

enum (Type)

シェイプのタイプ。

string

要素が配置されているページのオブジェクト ID。

object (Size)

要素のサイズ。

object (AffineTransform)

要素の変換。

string

ユーザー指定のオブジェクト ID。

ID を指定する場合は、プレゼンテーション内のすべてのページとページ要素の中で一意である必要があります。ID は英数字またはアンダースコアで始まる必要があります（正規表現 [a-zA-Z0-9_] に一致）。残りの文字には、英数字、アンダースコア、ハイフン、コロンを使用できます（正規表現 [a-zA-Z0-9_-:] に一致）。ID の長さは 5 ～ 50 文字にする必要があります。

ID を指定しない場合は、一意の ID が生成されます。

object (PageElementProperties)

テーブルの要素プロパティ。

テーブルは、最小サイズを条件として、指定されたサイズで作成されます。サイズが指定されていない場合、テーブルのサイズは自動的に設定されます。

テーブル変換のスケールは 1 で、せん断コンポーネントは含めないでください。変換が指定されていない場合、テーブルはページの中央に配置されます。

integer

テーブル内の行数。

integer

テーブル内の列数。

string

テキストが挿入される図形または表のオブジェクト ID。

object (TableCellLocation)

テキストをテーブルセルに挿入する場合の、テーブルセルの位置（省略可）。指定されている場合、objectId はテーブルを参照する必要があります。

string

挿入するテキスト。

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

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

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

integer

TextElement インデックスに基づいて、テキストが挿入されるインデックス（Unicode コード単位）。

インデックスは 0 から始まり、文字列の先頭から計算されます。Unicode 書記素クラスタ内への挿入を防ぐために、インデックスが調整されることがあります。このような場合、テキストは書記素クラスタの直後に挿入されます。

string

行を挿入するテーブル。

object (TableCellLocation)

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

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

boolean

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

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

integer

挿入する行数。リクエストあたり最大 20 個。

string

列を挿入するテーブル。

object (TableCellLocation)

列が挿入される基準となる表のセルの位置。

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

boolean

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

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

integer

挿入する列の数。リクエストあたり最大 20 個。

string

行を削除するテーブル。

object (TableCellLocation)

行が削除される参照テーブルのセルの位置。

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

string

列を削除するテーブル。

object (TableCellLocation)

列が削除される参照テーブルのセルの位置。

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

string

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

string

空でない場合、一致を特定のページのページ要素のみに制限します。

notes master のページ オブジェクト ID が指定された場合、またはそのオブジェクト ID のページがプレゼンテーションに存在しない場合は、400 不正なリクエスト エラーを返します。

object (SubstringMatchCriteria)

この部分文字列に一致する図形内のテキストを検索します。

string

図形または表で検索するテキスト。

boolean

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

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

boolean

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

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

string

削除するページまたはページ要素のオブジェクト ID。

削除オペレーションの後に group にページ要素が 1 つ以下しか含まれていない場合、グループも削除されます。

レイアウトでプレースホルダが削除されると、継承された空のプレースホルダも削除されます。

string

更新するページ要素のオブジェクト ID。

object (AffineTransform)

ページ要素の更新に使用される入力変換行列。

enum (ApplyMode)

変換更新の適用モード。

string

移動するプレゼンテーションのスライドの ID。このリストのスライドは、重複のない既存のプレゼンテーションの順序で指定する必要があります。

integer

移動前のスライドの配置に基づく、スライドを挿入するインデックス。0 からプレゼンテーションのスライド数までの整数（0 とスライド数を含む）にする必要があります。

string

テキストが削除される図形またはテーブルのオブジェクト ID。

object (TableCellLocation)

テキストが表のセルから削除される場合、表のセルの位置は省略可能です。指定されている場合、objectId はテーブルを参照する必要があります。

object (Range)

TextElement インデックスに基づく、削除するテキストの範囲。

図形または表のセルのテキストの末尾には、削除できない暗黙的な改行文字が常に存在します。Range.Type.ALL は正しい境界を使用しますが、範囲型 FROM_START_INDEX と FIXED_RANGE の明示的な境界を指定する場合は注意が必要です。たとえば、テキストが「ABC」で、その後に暗黙的な改行がある場合、textRange.start_index の最大値は 2、textRange.end_index の最大値は 3 になります。

段落の境界をまたぐテキストを削除すると、2 つの段落が結合されるため、段落スタイルとリストが変更されることがあります。

サロゲートペアの 1 つのコード単位のみを含む範囲は、両方のコード単位を含むように拡張されます。

integer

コレクションの先頭のオプションのゼロベースのインデックス。FIXED_RANGE 範囲と FROM_START_INDEX 範囲で必須です。

integer

コレクションの末尾のゼロベースのインデックス（省略可）。FIXED_RANGE 範囲で必須です。

enum (Type)

範囲のタイプ。

string

ユーザー指定のオブジェクト ID。

ID を指定する場合は、プレゼンテーション内のすべてのページとページ要素の中で一意である必要があります。ID は英数字またはアンダースコアで始まる必要があります（正規表現 [a-zA-Z0-9_] に一致）。残りの文字には、英数字、アンダースコア、ハイフン、コロンを使用できます（正規表現 [a-zA-Z0-9_-:] に一致）。ID の長さは 5 ～ 50 文字にする必要があります。

ID を指定しない場合は、一意の ID が生成されます。

object (PageElementProperties)

画像の要素プロパティ。

指定されたサイズのアスペクト比が画像のアスペクト比と一致しない場合、アスペクト比を維持するために、画像はサイズに合わせてスケーリングされ、中央に配置されます。指定された変換は、このオペレーションの後に適用されます。

PageElementProperties.size プロパティは省略可能です。サイズを指定しない場合は、画像のデフォルトのサイズが使用されます。

PageElementProperties.transform プロパティは省略可能です。変換を指定しない場合、画像はページの左上隅に配置されます。

string

画像 URL。

画像は挿入時に 1 回取得され、プレゼンテーション内に表示するためにコピーが保存されます。画像は 50 MB 未満、2,500 万ピクセル以下で、PNG、JPEG、GIF のいずれかの形式にする必要があります。

指定する URL は一般公開されており、長さが 2 KB 以下である必要があります。URL は画像とともに保存され、Image.source_url フィールドを通じて公開されます。

string

ユーザー指定のオブジェクト ID。

ID を指定する場合は、プレゼンテーション内のすべてのページとページ要素の中で一意である必要があります。ID は英数字またはアンダースコアで始まる必要があります（正規表現 [a-zA-Z0-9_] に一致）。残りの文字には、英数字、アンダースコア、ハイフン、コロンを使用できます（正規表現 [a-zA-Z0-9_-:] に一致）。ID の長さは 5 ～ 50 文字にする必要があります。

ID を指定しない場合は、一意の ID が生成されます。

object (PageElementProperties)

動画の要素プロパティ。

PageElementProperties.size プロパティは省略可能です。サイズを指定しない場合、サーバーによってデフォルトのサイズが選択されます。

PageElementProperties.transform プロパティは省略可能です。変換にせん断コンポーネントを含めることはできません。変換を指定しない場合、動画はページの左上隅に配置されます。

enum (Source)

動画のソース。

string

この動画の動画ソースの固有識別子。

例: YouTube 動画 https://www.youtube.com/watch?v=7U3axjORYZ0 の場合、ID は 7U3axjORYZ0 です。Google ドライブの動画（https://drive.google.com/file/d/1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q）の場合、ID は 1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q です。

Google ドライブの動画ファイルにアクセスするには、一部の古いファイルについて、HTTP ヘッダーにリソースキーを追加する必要がある場合があります。詳細については、リソースキーを使用してリンク共有ファイルにアクセスするをご覧ください。

string

ユーザー指定のオブジェクト ID。

指定する場合、ID はプレゼンテーション内のすべてのページとページ要素の中で一意である必要があります。ID は、単語文字 [a-zA-Z0-9_] で始まり、その後に [a-zA-Z0-9_-:] の文字が続く必要があります。ID の長さは 5 ～ 50 文字にする必要があります。空の場合、一意の識別子が生成されます。

object (PageElementProperties)

グラフの要素プロパティ。

指定されたサイズのアスペクト比がグラフのアスペクト比と一致しない場合、アスペクト比を維持するために、グラフはサイズに合わせてスケーリングされ、中央に配置されます。指定された変換は、このオペレーションの後に適用されます。

string

グラフを含む Google スプレッドシートの ID。

古いファイルの一部について、HTTP ヘッダーにリソースキーを追加する必要がある場合があります。詳細については、リソースキーを使用してリンク共有ファイルにアクセスするをご覧ください。

integer

Google スプレッドシートの特定のグラフの ID。

enum (LinkingMode)

グラフがソースのスプレッドシートにリンクされているモード。指定しない場合、グラフはリンクされていない画像になります。

string

ユーザー指定のオブジェクト ID。

ID を指定する場合は、プレゼンテーション内のすべてのページとページ要素の中で一意である必要があります。ID は英数字またはアンダースコアで始まる必要があります（正規表現 [a-zA-Z0-9_] に一致）。残りの文字には、英数字、アンダースコア、ハイフン、コロンを使用できます（正規表現 [a-zA-Z0-9_-:] に一致）。ID の長さは 5 ～ 50 文字にする必要があります。

ID を指定しない場合は、一意の ID が生成されます。

object (PageElementProperties)

線の要素プロパティ。

enum (Category)

作成する行のカテゴリ。

非推奨 : 代わりに category を使用してください。

作成される line type の正確な内容は、カテゴリと、他のページ要素に接続するためにどのようにルーティングされるかに基づいて決定されます。

category と lineCategory の両方を指定すると、category が優先されます。

enum (LineCategory)

作成する行のカテゴリ。

作成される line type の正確な内容は、カテゴリと、他のページ要素に接続するためにどのようにルーティングされるかに基づいて決定されます。

category と lineCategory の両方を指定すると、category が優先されます。

category の値を指定せずに lineCategory の値を指定すると、指定した lineCategory の値が使用されます。

どちらも指定しない場合は、STRAIGHT が使用されます。

string

更新するグラフのオブジェクト ID。

string

更新が適用されるシェイプのオブジェクト ID。

object (ShapeProperties)

更新するシェイプ プロパティ。

string (FieldMask format)

更新するフィールド。

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

たとえば、図形の背景の単色塗りつぶしの色を更新するには、fields を "shapeBackgroundFill.solidFill.color" に設定します。

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

string

更新が適用される画像のオブジェクト ID。

object (ImageProperties)

更新する画像プロパティ。

string (FieldMask format)

更新するフィールド。

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

たとえば、画像の輪郭の色を更新するには、fields を "outline.outlineFill.solidFill.color" に設定します。

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

string

更新が適用される動画のオブジェクト ID。

object (VideoProperties)

更新する動画のプロパティ。

string (FieldMask format)

更新するフィールド。

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

たとえば、動画の枠線の色を更新するには、fields を "outline.outlineFill.solidFill.color" に設定します。

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

string

更新が適用されるページのオブジェクト ID。

object (PageProperties)

更新するページ プロパティ。

string (FieldMask format)

更新するフィールド。

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

たとえば、ページの背景の単色塗りつぶしの色を更新するには、fields を "pageBackgroundFill.solidFill.color" に設定します。

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

string

テーブルのオブジェクト ID。

object (TableRange)

更新が適用されるテーブルのサブセットを表すテーブル範囲。テーブル範囲が指定されていない場合、更新はテーブル全体に適用されます。

object (TableCellProperties)

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

string (FieldMask format)

更新するフィールド。

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

たとえば、表のセルの背景の単色塗りつぶしの色を更新するには、fields を "tableCellBackgroundFill.solidFill.color" に設定します。

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

object (TableCellLocation)

表範囲の開始位置。

integer

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

integer

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

string

更新が適用される行のオブジェクト ID。

object (LineProperties)

更新する行のプロパティ。

string (FieldMask format)

更新するフィールド。

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

たとえば、線の単色塗りつぶしの色を更新するには、fields を "lineFill.solidFill.color" に設定します。

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

string

箇条書きを追加するテキストを含む図形または表のオブジェクト ID。

object (TableCellLocation)

変更するテキストが表のセルにある場合の、表のセルの位置（省略可）。指定されている場合、objectId はテーブルを参照する必要があります。

object (Range)

TextElement インデックスに基づいて、箇条書きのプリセットを適用するテキストの範囲。

enum (BulletGlyphPreset)

使用する箇条書きのグリフの種類。デフォルトは BULLET_DISC_CIRCLE_SQUARE プリセットです。

enum (ReplaceMethod)

置換メソッド。

非推奨 : 代わりに imageReplaceMethod を使用してください。

replaceMethod と imageReplaceMethod の両方を指定すると、imageReplaceMethod が優先されます。

enum (ImageReplaceMethod)

画像の置換メソッド。

replaceMethod と imageReplaceMethod の両方を指定すると、imageReplaceMethod が優先されます。

imageReplaceMethod の値を指定せずに replaceMethod の値を指定すると、指定した replaceMethod の値が使用されます。

どちらも指定しない場合は、CENTER_INSIDE が使用されます。

string

空でない場合、一致を特定のページのページ要素のみに制限します。

notes page または notes master のページ オブジェクト ID が指定された場合、またはそのオブジェクト ID のページがプレゼンテーションに存在しない場合は、400 不正なリクエスト エラーを返します。

object (SubstringMatchCriteria)

設定されている場合、このリクエストは、指定されたテキストを含むすべての図形を置き換えます。

string

画像 URL。

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

指定する URL の長さは最大 2 KB です。URL 自体は画像とともに保存され、Image.source_url フィールドを介して公開されます。

string

複製するオブジェクトの ID。

map (key: string, value: string)

複製されるオブジェクトには、他のオブジェクトが含まれている場合があります（スライドやグループ ページ要素を複製する場合など）。このマップは、重複するオブジェクトの ID がどのように生成されるかを定義します。キーは元のオブジェクトの ID で、値は対応する重複オブジェクトに割り当てられる ID です。このマップでは、ソース オブジェクトの重複の ID も指定できます。その場合、objectId フィールドの同じ値をキーとして使用し、新たに必要な ID を値として使用します。

すべてのキーは、プレゼンテーション内の既存の ID に対応している必要があります。すべての値はプレゼンテーション内で一意である必要があり、英数字またはアンダースコアで始まる必要があります（正規表現 [a-zA-Z0-9_] と一致）。残りの文字には、英数字、アンダースコア、ハイフン、コロンを使用できます（正規表現 [a-zA-Z0-9_-:] と一致）。新しい ID の長さは 5 文字以上 50 文字以下にする必要があります。

ソース オブジェクトの ID がマップから省略されている場合は、新しいランダムな ID が割り当てられます。マップが空の場合、または設定されていない場合、すべての重複オブジェクトに新しいランダムな ID が割り当てられます。

string

スタイル設定するテキストを含む図形または表のオブジェクト ID。

object (TableCellLocation)

スタイル設定するテキストを含むテーブル内のセルの位置。objectId がテーブルを参照している場合、cellLocation には値を設定する必要があります。それ以外の場合は、そうであってはなりません。

object (TextStyle)

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

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

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

object (Range)

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

範囲は、隣接する改行を含むように拡張されることがあります。

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

string (FieldMask format)

更新するフィールド。

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

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

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

object (SubstringMatchCriteria)

置き換えられるためにシェイプが満たす必要がある条件。リクエストは、指定されたテキストを含むすべての図形を置き換えます。

string

グラフを含む Google スプレッドシートの ID。

integer

Google スプレッドシートの特定のグラフの ID。

enum (LinkingMode)

グラフがソースのスプレッドシートにリンクされているモード。指定しない場合、グラフはリンクされていない画像になります。

string

空でない場合、一致を特定のページのページ要素のみに制限します。

notes page または notes master のページ オブジェクト ID が指定された場合、またはそのオブジェクト ID のページがプレゼンテーションに存在しない場合は、400 不正なリクエスト エラーを返します。

string

箇条書きを削除するテキストを含む図形または表のオブジェクト ID。

object (TableCellLocation)

変更するテキストが表のセルにある場合の、表のセルの位置（省略可）。指定されている場合、objectId はテーブルを参照する必要があります。

object (Range)

TextElement インデックスに基づいて、箇条書きを削除するテキストの範囲。

string

スタイル設定するテキストを含む図形または表のオブジェクト ID。

object (TableCellLocation)

スタイル設定する段落を含むテーブル内のセルの位置。objectId がテーブルを参照している場合、cellLocation には値を設定する必要があります。それ以外の場合は、そうであってはなりません。

object (ParagraphStyle)

段落のスタイル。

object (Range)

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

string (FieldMask format)

更新するフィールド。

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

たとえば、段落の配置を更新するには、fields を "alignment" に設定します。

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

string

テーブルのオブジェクト ID。

object (TableRange)

更新が適用されるテーブルのサブセットを表すテーブル範囲。テーブル範囲が指定されていない場合、更新はテーブル全体に適用されます。

enum (BorderPosition)

更新を適用するテーブル範囲の境界の位置。枠線の位置が指定されていない場合、更新は表の範囲内のすべての枠線に適用されます。

object (TableBorderProperties)

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

string (FieldMask format)

更新するフィールド。

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

たとえば、テーブルの枠線の単色塗りつぶしの色を更新するには、fields を "tableBorderFill.solidFill.color" に設定します。

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

string

テーブルのオブジェクト ID。

integer

更新する列を指定するゼロベースのインデックスのリスト。インデックスが指定されていない場合、テーブル内のすべての列が更新されます。

object (TableColumnProperties)

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

リクエストの tableColumnProperties#columnWidth の値が 406,400 EMU（32 ポイント）未満の場合、400 Bad Request エラーが返されます。

string (FieldMask format)

更新するフィールド。

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

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

フィールド マスクに「columnWidth」が含まれていても、プロパティが設定されていない場合、列幅はデフォルトの 406,400 EMU（32 ポイント）になります。

string

テーブルのオブジェクト ID。

integer

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

object (TableRowProperties)

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

string (FieldMask format)

更新するフィールド。

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

たとえば、最小行の高さを更新するには、fields を "minRowHeight" に設定します。

フィールド マスクに「minRowHeight」が含まれていても、プロパティが設定されていない場合、最小行の高さはデフォルトで 0 になります。

string

テーブルのオブジェクト ID。

object (TableRange)

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

結合されるセル内のテキストは連結され、範囲の左上（「先頭」）のセルに保存されます。範囲が長方形でない場合（範囲にすでに結合されているセルが含まれている場合に発生することがあります）、400 不正なリクエスト エラーが返されます。

string

テーブルのオブジェクト ID。

object (TableRange)

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

この範囲内の結合されたセルはすべて結合が解除されます。すでに結合が解除されているセルは影響を受けません。範囲に結合されたセルがない場合、リクエストは何も行いません。結合されたセルにテキストが含まれている場合、そのテキストは結合解除されたセルのブロックの左上（「先頭」）のセルに残ります。

string

作成するグループのユーザー指定のオブジェクト ID。

ID を指定する場合は、プレゼンテーション内のすべてのページとページ要素の中で一意である必要があります。ID は英数字またはアンダースコアで始まる必要があります（正規表現 [a-zA-Z0-9_] に一致）。残りの文字には、英数字、アンダースコア、ハイフン、コロンを使用できます（正規表現 [a-zA-Z0-9_-:] に一致）。ID の長さは 5 ～ 50 文字にする必要があります。

ID を指定しない場合は、一意の ID が生成されます。

string

グループ化するオブジェクトのオブジェクト ID。

グループ化できるのはページ要素のみです。同じページに、別のグループにまだ含まれていないページ要素が 2 つ以上ある必要があります。videos、tables、placeholders などの一部のページ要素はグループ化できません。

string

グループ解除するオブジェクトのオブジェクト ID。

グループ解除できるのは、他の groups 内にない groups のみです。すべてのグループが同じページに表示されるようにします。グループ自体が削除されます。すべての子の視覚的なサイズと位置が保持されます。

string

更新が適用されるページ要素のオブジェクト ID。

string

ページ要素の更新された代替テキストのタイトル。設定しない場合、既存の値が維持されます。タイトルは、スクリーン リーダーやその他のユーザー補助機能のインターフェースに公開されます。ページ要素のコンテンツに関連する人が読める値のみを使用します。

string

ページ要素の更新された代替テキストの説明。設定しない場合、既存の値が維持されます。説明は、スクリーン リーダーやその他のユーザー補助機能のインターフェースに公開されます。ページ要素のコンテンツに関連する人が読める値のみを使用します。

string

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

enum (ImageReplaceMethod)

置換メソッド。

string

画像 URL。

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

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

string

更新が適用されるスライドのオブジェクト ID。

object (SlideProperties)

更新するスライドのプロパティ。

string (FieldMask format)

更新するフィールド。

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

たとえば、スライドをスキップするかどうかを更新するには、fields を "isSkipped" に設定します。

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

string

更新するページ要素のオブジェクト ID。

すべてのページ要素は同じページにあり、グループ化されていない必要があります。

enum (ZOrderOperation)

ページ要素に適用する Z オーダー オペレーション。

複数のページ要素に操作を適用する場合、操作前のこれらのページ要素内の相対的な Z オーダーは維持されます。

string

更新が適用される行のオブジェクト ID。

「コネクタ」を示す category がある行のみを更新できます。

カテゴリを更新すると、線が再ルーティングされることがあります。

enum (LineCategory)

更新する行カテゴリ。

正確な line type は、更新するカテゴリと、他のページ要素に接続するためにどのようにルーティングされるかに基づいて決定されます。

string

再ルーティングする行のオブジェクト ID。

「コネクタ」であることを示す category が含まれる行のみを再ルーティングできます。線の始点と終点は、異なるページ要素に配置する必要があります。

string

コメントのテキスト（書式なしテキスト）。

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

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

string

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

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

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

string

このコメントに関連付けられている Page または PageElement のオブジェクト ID。指定された objectId が Group の場合、コメントはグループの非グループ子孫の最大 100 個にアンカーされます。

object (ShapeTextAnchor)

Shape 内の特定のテキスト範囲にコメントをアンカーします。

object (TableCellTextAnchor)

Table の単一のセル内の特定のテキスト範囲にコメントを固定します。

object (TableAnchor)

Table 内の特定のセル範囲にコメントを固定します。

string

テキストを含むページ要素のオブジェクト ID。

object (Range)

アンカーのテキスト範囲。

string

セルを含むテーブルのオブジェクト ID。

object (TableCellLocation)

表内のセルの位置。

object (Range)

アンカーのテキスト範囲。

string

テーブルのオブジェクト ID。

object (TableRange)

アンカーを適用するテーブル内のセルの範囲。省略すると、テーブル内のすべてのセルがアンカーに使用されます。

string

返信を追加する CommentThread の ID。

object (Post)

返信を表す Post。

string

投稿が属する CommentThread の ID。

string

更新される投稿の ID。

string

コメントの新しいテキスト（書式なしテキスト）。

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

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

string

削除される CommentThread の ID。

string

投稿が属する CommentThread の ID。

string

削除される返信の ID Post。