Requests

リクエスト

プレゼンテーションに適用する 1 種類の更新。

JSON 表現 
{

  // Union field kind can be only one of the following:
  "createSlide": {
    object (CreateSlideRequest)
  },
  "createShape": {
    object (CreateShapeRequest)
  },
  "createTable": {
    object (CreateTableRequest)
  },
  "insertText": {
    object (InsertTextRequest)
  },
  "insertTableRows": {
    object (InsertTableRowsRequest)
  },
  "insertTableColumns": {
    object (InsertTableColumnsRequest)
  },
  "deleteTableRow": {
    object (DeleteTableRowRequest)
  },
  "deleteTableColumn": {
    object (DeleteTableColumnRequest)
  },
  "replaceAllText": {
    object (ReplaceAllTextRequest)
  },
  "deleteObject": {
    object (DeleteObjectRequest)
  },
  "updatePageElementTransform": {
    object (UpdatePageElementTransformRequest)
  },
  "updateSlidesPosition": {
    object (UpdateSlidesPositionRequest)
  },
  "deleteText": {
    object (DeleteTextRequest)
  },
  "createImage": {
    object (CreateImageRequest)
  },
  "createVideo": {
    object (CreateVideoRequest)
  },
  "createSheetsChart": {
    object (CreateSheetsChartRequest)
  },
  "createLine": {
    object (CreateLineRequest)
  },
  "refreshSheetsChart": {
    object (RefreshSheetsChartRequest)
  },
  "updateShapeProperties": {
    object (UpdateShapePropertiesRequest)
  },
  "updateImageProperties": {
    object (UpdateImagePropertiesRequest)
  },
  "updateVideoProperties": {
    object (UpdateVideoPropertiesRequest)
  },
  "updatePageProperties": {
    object (UpdatePagePropertiesRequest)
  },
  "updateTableCellProperties": {
    object (UpdateTableCellPropertiesRequest)
  },
  "updateLineProperties": {
    object (UpdateLinePropertiesRequest)
  },
  "createParagraphBullets": {
    object (CreateParagraphBulletsRequest)
  },
  "replaceAllShapesWithImage": {
    object (ReplaceAllShapesWithImageRequest)
  },
  "duplicateObject": {
    object (DuplicateObjectRequest)
  },
  "updateTextStyle": {
    object (UpdateTextStyleRequest)
  },
  "replaceAllShapesWithSheetsChart": {
    object (ReplaceAllShapesWithSheetsChartRequest)
  },
  "deleteParagraphBullets": {
    object (DeleteParagraphBulletsRequest)
  },
  "updateParagraphStyle": {
    object (UpdateParagraphStyleRequest)
  },
  "updateTableBorderProperties": {
    object (UpdateTableBorderPropertiesRequest)
  },
  "updateTableColumnProperties": {
    object (UpdateTableColumnPropertiesRequest)
  },
  "updateTableRowProperties": {
    object (UpdateTableRowPropertiesRequest)
  },
  "mergeTableCells": {
    object (MergeTableCellsRequest)
  },
  "unmergeTableCells": {
    object (UnmergeTableCellsRequest)
  },
  "groupObjects": {
    object (GroupObjectsRequest)
  },
  "ungroupObjects": {
    object (UngroupObjectsRequest)
  },
  "updatePageElementAltText": {
    object (UpdatePageElementAltTextRequest)
  },
  "replaceImage": {
    object (ReplaceImageRequest)
  },
  "updateSlideProperties": {
    object (UpdateSlidePropertiesRequest)
  },
  "updatePageElementsZOrder": {
    object (UpdatePageElementsZOrderRequest)
  },
  "updateLineCategory": {
    object (UpdateLineCategoryRequest)
  },
  "rerouteLine": {
    object (RerouteLineRequest)
  }
  // End of list of possible types for union field kind.
}
フィールド
共用体フィールド kind。アップデートの種類。フィールドは 1 つだけ指定する必要があります。kind は次のいずれかになります。
createSlide

object (CreateSlideRequest)

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

createShape

object (CreateShapeRequest)

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

createTable

object (CreateTableRequest)

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

object (InsertTextRequest)

図形または表のセルにテキストを挿入します。
insertTableRows

object (InsertTableRowsRequest)

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

object (InsertTableColumnsRequest)

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

object (DeleteTableRowRequest)

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

deleteTableColumn

object (DeleteTableColumnRequest)

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

object (ReplaceAllTextRequest)

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

deleteObject

object (DeleteObjectRequest)

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

updatePageElementTransform

object (UpdatePageElementTransformRequest)

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

updateSlidesPosition

object (UpdateSlidesPositionRequest)

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

deleteText

object (DeleteTextRequest)

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

createImage

object (CreateImageRequest)

イメージを作成します。
createVideo

object (CreateVideoRequest)

動画を作成します。

createSheetsChart

object (CreateSheetsChartRequest)

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

createLine

object (CreateLineRequest)

ラインを作成します。

refreshSheetsChart

object (RefreshSheetsChartRequest)

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

object (UpdateShapePropertiesRequest)

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

object (UpdateImagePropertiesRequest)

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

object (UpdateVideoPropertiesRequest)

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

object (UpdatePagePropertiesRequest)

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

object (UpdateTableCellPropertiesRequest)

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

object (UpdateLinePropertiesRequest)

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

object (CreateParagraphBulletsRequest)

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

object (ReplaceAllShapesWithImageRequest)

一部の条件に一致するシェイプをすべて画像に置き換えます。

duplicateObject

object (DuplicateObjectRequest)

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

object (UpdateTextStyleRequest)

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

object (ReplaceAllShapesWithSheetsChartRequest)

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

deleteParagraphBullets

object (DeleteParagraphBulletsRequest)

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

updateParagraphStyle

object (UpdateParagraphStyleRequest)

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

object (UpdateTableBorderPropertiesRequest)

Table のテーブル境界のプロパティを更新します。
updateTableColumnProperties

object (UpdateTableColumnPropertiesRequest)

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

object (UpdateTableRowPropertiesRequest)

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

object (MergeTableCellsRequest)

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

unmergeTableCells

object (UnmergeTableCellsRequest)

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

object (GroupObjectsRequest)

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

object (UngroupObjectsRequest)

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

object (UpdatePageElementAltTextRequest)

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

replaceImage

object (ReplaceImageRequest)

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

object (UpdateSlidePropertiesRequest)

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

updatePageElementsZOrder

object (UpdatePageElementsZOrderRequest)

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

object (UpdateLineCategoryRequest)

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

object (RerouteLineRequest)

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

CreateSlideRequest

スライドを作成します。

JSON 表現 
{
  "objectId": string,
  "insertionIndex": integer,
  "slideLayoutReference": {
    object (LayoutReference)
  },
  "placeholderIdMappings": [
    {
      object (LayoutPlaceholderIdMapping)
    }
  ]
}
フィールド
objectId

string

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

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

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

insertionIndex

integer

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

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

object (LayoutReference)

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

  • 前のスライド インデックスのマスター。
  • insertIndex がゼロの場合、最初のスライドのマスター。
  • プレゼンテーションを行わない（スライドがない場合）

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

レイアウト参照を指定しない場合、事前定義の BLANK レイアウトが使用されます。

placeholderIdMappings[]

object (LayoutPlaceholderIdMapping)

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

LayoutReference

スライド レイアウトのリファレンス。これは次のいずれかを参照できます。

  • 事前定義レイアウト
  • プレゼンテーション内のいずれかのレイアウト。
JSON 表現 
{

  // Union field kind can be only one of the following:
  "predefinedLayout": enum (PredefinedLayout),
  "layoutId": string
  // End of list of possible types for union field kind.
}
フィールド
共用体フィールド kind。LayoutReference の種類。kind は次のいずれかになります。
predefinedLayout

enum (PredefinedLayout)

事前定義レイアウト

layoutId

string

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

事前定義レイアウト

事前定義されたレイアウト タイプ。これらはプレゼンテーションでよく見られるレイアウトです。ただし、これらのレイアウトが、削除されたか、使用中のテーマの一部でなかった可能性があるため、現在のマスターに存在するという保証はありません。また、各レイアウトのプレースホルダが変更された可能性があります。

列挙型
PREDEFINED_LAYOUT_UNSPECIFIED 指定されていないレイアウト。
BLANK プレースホルダのない空白のレイアウト。
CAPTION_ONLY 下部に字幕があるレイアウト。
TITLE タイトルとサブタイトルを含むレイアウト。
TITLE_AND_BODY タイトルと本文を含むレイアウト。
TITLE_AND_TWO_COLUMNS タイトルと 2 つの列があるレイアウト。
TITLE_ONLY タイトルのみのレイアウト。
SECTION_HEADER セクション タイトルを含むレイアウト。
SECTION_TITLE_AND_DESCRIPTION 片側にタイトルと字幕、もう片側に説明文があるレイアウト。
ONE_COLUMN_TEXT タイトルと本文が 1 行で、1 列に配置されたレイアウトです。
MAIN_POINT 要点を含むレイアウト。
BIG_NUMBER 大きな見出しのレイアウト。

LayoutPlaceholdIdMapping

指定したレイアウトからスライド上に作成されるプレースホルダのユーザー指定 ID マッピング。

JSON 表現 
{
  "objectId": string,

  // Union field kind can be only one of the following:
  "layoutPlaceholder": {
    object (Placeholder)
  },
  "layoutPlaceholderObjectId": string
  // End of list of possible types for union field kind.
}
フィールド
objectId

string

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

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

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

共用体フィールド kind。レイアウトのプレースホルダを識別する種類。 kind は次のいずれかになります。
layoutPlaceholder

object (Placeholder)

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

string

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

CreateShapeRequest

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

JSON 表現 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "shapeType": enum (Type)
}
フィールド
objectId

string

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

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

elementProperties

object (PageElementProperties)

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

shapeType

enum (Type)

シェイプのタイプ。

PageElementProperties

ページ要素の共通プロパティ。

注: 最初に PageElement を作成したとき、API は size と transform の両方の値を変更する可能性がありますが、表示サイズは変更されません。

JSON 表現 
{
  "pageObjectId": string,
  "size": {
    object (Size)
  },
  "transform": {
    object (AffineTransform)
  }
}
フィールド
pageObjectId

string

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

object (Size)

要素のサイズ。

transform

object (AffineTransform)

要素の変換。

CreateTableRequest

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

JSON 表現 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "rows": integer,
  "columns": integer
}
フィールド
objectId

string

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

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

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

elementProperties

object (PageElementProperties)

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

テーブルは指定されたサイズで作成され、最小サイズが適用されます。サイズが指定されていない場合、テーブルのサイズが自動的に調整されます。

テーブル変換では、スケールが 1 で、せん断成分がないようにする必要があります。変換が指定されていない場合、テーブルはページの中央に配置されます。
rows

integer

テーブル内の行数。
columns

integer

テーブル内の列数。

InsertTextRequest

図形または表のセルにテキストを挿入します。

JSON 表現 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "text": string,
  "insertionIndex": integer
}
フィールド
objectId

string

テキストが挿入されるシェイプまたはテーブルのオブジェクト ID。
cellLocation

object (TableCellLocation)

テキストが表のセルに挿入される場合の表のセルの位置（省略可）。オブジェクトが存在する場合、objectId がテーブルを参照している必要があります。
text

string

挿入されるテキスト。

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

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

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

integer

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

インデックスはゼロベースで、文字列の先頭から計算されます。Unicode のグラフィム クラスタ内での挿入を防ぐため、インデックスの調整が行われることがあります。この場合、グラフィム クラスタの直後にテキストが挿入されます。

InsertTableRowsRequest

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

JSON 表現 
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "insertBelow": boolean,
  "number": integer
}
フィールド
tableObjectId

string

行を挿入するテーブル。
cellLocation

object (TableCellLocation)

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

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

boolean

参照セルの場所の下に新しい行を挿入するかどうかを指定します。

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

integer

挿入される行数。1 回のリクエストにつき最大 20 件。

InsertTableColumnsRequest

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

表内の他の列は、新しい列に合わせてサイズ変更されます。

JSON 表現 
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "insertRight": boolean,
  "number": integer
}
フィールド
tableObjectId

string

列を挿入するテーブル。
cellLocation

object (TableCellLocation)

列が挿入される参照テーブルのセルの場所。

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

boolean

参照セルの場所の右側に新しい列を挿入するかどうかを指定します。

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

integer

挿入される列の数。1 回のリクエストにつき最大 20 件。

DeleteTableRowRequest

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

JSON 表現 
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  }
}
フィールド
tableObjectId

string

行を削除するテーブル。
cellLocation

object (TableCellLocation)

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

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

DeleteTableColumnRequest

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

JSON 表現 
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  }
}
フィールド
tableObjectId

string

列を削除するテーブル。
cellLocation

object (TableCellLocation)

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

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

replaceAllTextRequest

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

JSON 表現 
{
  "replaceText": string,
  "pageObjectIds": [
    string
  ],

  // 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

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

string

空でない場合は、指定したページのページ要素のみに一致します。

notes master のページ オブジェクト ID が指定された場合や、そのオブジェクト ID を持つページがプレゼンテーションに存在しない場合は、400 不正なリクエスト エラーを返します。
共用体フィールド criteria。置換するテキストのマッチングに使用する基準。 criteria は次のいずれかになります。
containsText

object (SubstringMatchCriteria)

この部分文字列に一致するシェイプ内のテキストを検索します。

SubstringMatchCriteria

シェイプやテーブルの特定の文字列に一致する基準。

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

string

シェイプまたは表内で検索するテキストです。

matchCase

boolean

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

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

DeleteObjectRequest

プレゼンテーションからオブジェクト（pages または page elements）を削除します。

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

string

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

削除オペレーション後に、group に 1 要素のみ、またはページ要素が含まれていないと、グループも削除されます。

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

UpdatePageElementTransformRequest

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

グループの変換を更新すると、グループ内のページ要素の絶対変換が変更され、外観が変更されます。詳細については、PageElement.transform のドキュメントをご覧ください。

JSON 表現 
{
  "objectId": string,
  "transform": {
    object (AffineTransform)
  },
  "applyMode": enum (ApplyMode)
}
フィールド
objectId

string

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

object (AffineTransform)

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

enum (ApplyMode)

変換更新の適用モード。

ApplyMode

変換更新の適用モード。

列挙型
APPLY_MODE_UNSPECIFIED 未指定モード。
RELATIVE 新しい AffineTransform 行列を既存の行列に適用し、既存の行列を結果として得られる連結に置き換えます。
ABSOLUTE 既存の AffineTransform 行列を新しい行列に置き換えます。

UpdateSlidesPositionRequest

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

JSON 表現 
{
  "slideObjectIds": [
    string
  ],
  "insertionIndex": integer
}
フィールド
slideObjectIds[]

string

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

insertionIndex

integer

移動が行われる前のスライドの配置に基づいて、スライドが挿入されるインデックス。プレゼンテーションのスライドの数を 0 ～ 0 の範囲で指定する必要があります。

DeleteTextRequest

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

JSON 表現 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  }
}
フィールド
objectId

string

テキストを削除するシェイプまたはテーブルのオブジェクト ID です。

cellLocation

object (TableCellLocation)

表のセルからテキストを削除する場合は、オプションのセルセルの場所です。オブジェクトが存在する場合、objectId がテーブルを参照している必要があります。
textRange

object (Range)

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

シェイプまたは表のセルのテキストの末尾には削除できない改行文字が常にあります。 Range.Type.ALL では正しい境界が使用されますが、範囲タイプ FROM_START_INDEX および FIXED_RANGE に明示的な境界を指定する場合は慎重に行う必要があります。たとえば、テキストが「ABC」で、その後に暗黙的な改行が続く場合、最大値は textRange.start_index が 2、textRange.end_index が 3 になります。

段落の境界線を越えるテキストを削除すると、2 つの段落が結合される際に、段落のスタイルやリストが変更されることがあります。

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

範囲

インデックス付きコレクションの連続する範囲（テキスト内の文字など）を指定します。

JSON 表現 
{
  "startIndex": integer,
  "endIndex": integer,
  "type": enum (Type)
}
フィールド
startIndex

integer

コレクションの先頭を示す、0 から始まるインデックス（省略可）。FIXED_RANGE と FROM_START_INDEX の範囲では必須。
endIndex

integer

コレクションの末尾を示す 0 から始まるインデックス（省略可）。FIXED_RANGE の範囲では必須です。
type

enum (Type)

範囲のタイプ。

型

範囲のタイプ。

列挙型
RANGE_TYPE_UNSPECIFIED 不明な範囲タイプです。この値は使用しないでください。
FIXED_RANGE 固定範囲。startIndex と endIndex の両方を指定する必要があります。
FROM_START_INDEX 範囲は startIndex から開始し、収集が終了するまで継続します。endIndex は指定できません。
ALL 範囲をコレクションの全長に設定します。startIndex と endIndex の両方は指定できません。

CreateImageRequest

イメージを作成します。

JSON 表現 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },

  // Union field image_source can be only one of the following:
  "url": string
  // End of list of possible types for union field image_source.
}
フィールド
objectId

string

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

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

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

elementProperties

object (PageElementProperties)

画像の要素プロパティ。

指定されたサイズのアスペクト比が画像のアスペクト比と一致しない場合、画像はアスペクト比を維持しながら拡大、縮小されます。指定された変換は、この操作の後に適用されます。

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

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

共用体フィールド image_source。画像ソースの種類。image_source は次のいずれかになります。
url

string

画像の URL。

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

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

CreateVideoRequest

動画を作成します。

注: Google ドライブから動画を作成するには、リクエスト元のアプリに drive、readonly、drive.file のいずれかの OAuth スコープが必要です。

JSON 表現 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "source": enum (Source),
  "id": string
}
フィールド
objectId

string

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

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

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

elementProperties

object (PageElementProperties)

動画の要素プロパティ。

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

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

enum (Source)

動画のソース。

id

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 ヘッダーにリソースキーを追加する必要があります。詳細については、リソースキーを使用してリンク共有ファイルにアクセスするをご覧ください。

CreateSheetsChartRequest

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

注: グラフを作成するには、spreadsheet.readonly、spreadsheet、drive.readonly、drive.file、drive のいずれかの OAuth スコープが必要です。

JSON 表現 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "spreadsheetId": string,
  "chartId": integer,
  "linkingMode": enum (LinkingMode)
}
フィールド
objectId

string

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

指定する場合は、プレゼンテーション内のすべてのページとページ要素で、一意の ID を指定する必要があります。ID の先頭は [a-zA-Z0-9_] にします。その後に任意の数の文字 [a-zA-Z0-9_-:] を続ける必要があります。ID の長さは 5 以上 50 以下である必要があります。空の場合、一意の識別子が生成されます。

elementProperties

object (PageElementProperties)

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

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

string

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

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

integer

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

linkingMode

enum (LinkingMode)

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

LinkingMode

グラフを元のスプレッドシートにリンクするモード。

列挙型
NOT_LINKED_IMAGE グラフはソース スプレッドシートに関連付けられておらず、更新できません。リンクされていないグラフは画像として挿入されます。
LINKED グラフをリンクするとグラフが更新され、他の共同編集者にはスプレッドシートへのリンクが表示されます。

CreateLineRequest

ラインを作成します。

JSON 表現 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "lineCategory": enum (Category),
  "category": enum (LineCategory)
}
フィールド
objectId

string

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

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

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

elementProperties

object (PageElementProperties)

線の要素プロパティ。

lineCategory
(deprecated)

enum (Category)

作成する行のカテゴリ。

非推奨 : 代わりに category を使用します。

作成される line type は、カテゴリと、他のページ要素に接続する方法に基づいて決まります。

category と lineCategory を両方とも指定した場合、category が優先されます。
category

enum (LineCategory)

作成する行のカテゴリ。

作成される line type は、カテゴリと、他のページ要素に接続する方法に基づいて決まります。

category と lineCategory を両方とも指定した場合、category が優先されます。

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

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

カテゴリ

線のカテゴリ。

列挙型
STRAIGHT ストレート コネクタ（ストレート コネクタ 1 を含む）指定しない場合のデフォルトは、カテゴリです。
BENT 曲がったコネクタ（曲がったコネクタ 2 ～ 5 を含む）。
CURVED 曲線コネクタ（曲線コネクタ 2 ～ 5 を含む）。

RefreshSheetsChartRequest

埋め込んだ Google スプレッドシートを、最新バージョンの Google スプレッドシートのグラフで置き換えて更新します。

注: グラフを更新するには、spreadsheet.readonly、spreadsheet、drive.readonly、または drive OAuth スコープの少なくとも 1 つが必要です。

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

string

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

UpdateShapePropertiesRequest

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

JSON 表現 
{
  "objectId": string,
  "shapeProperties": {
    object (ShapeProperties)
  },
  "fields": string
}
フィールド
objectId

string

更新を適用するシェイプのオブジェクト ID。
shapeProperties

object (ShapeProperties)

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

fields

string (FieldMask format)

更新するフィールド。

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

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

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

UpdateImagePropertiesRequest

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

JSON 表現 
{
  "objectId": string,
  "imageProperties": {
    object (ImageProperties)
  },
  "fields": string
}
フィールド
objectId

string

アップデートが適用されるイメージのオブジェクト ID。
imageProperties

object (ImageProperties)

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

fields

string (FieldMask format)

更新するフィールド。

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

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

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

UpdateVideoPropertiesRequest

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

JSON 表現 
{
  "objectId": string,
  "videoProperties": {
    object (VideoProperties)
  },
  "fields": string
}
フィールド
objectId

string

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

object (VideoProperties)

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

fields

string (FieldMask format)

更新するフィールド。

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

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

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

UpdatePagePropertiesRequest

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

JSON 表現 
{
  "objectId": string,
  "pageProperties": {
    object (PageProperties)
  },
  "fields": string
}
フィールド
objectId

string

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

object (PageProperties)

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

fields

string (FieldMask format)

更新するフィールド。

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

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

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

UpdateTableCellPropertiesRequest

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

JSON 表現 
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  },
  "tableCellProperties": {
    object (TableCellProperties)
  },
  "fields": string
}
フィールド
objectId

string

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

object (TableRange)

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

object (TableCellProperties)

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

string (FieldMask format)

更新するフィールド。

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

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

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

TableRange

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

テーブル範囲で指定されたセルが必ずしも長方形を形成するわけではないことにご注意ください。たとえば、最終行のすべてのセルがマージされた 3 行 × 3 列のテーブルがあるとします。テーブルは次のようになります。

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

ロケーションが 0（0）、行スパンが 3、列スパンが 2 のテーブル範囲には、以下のセルを指定します。

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

object (TableCellLocation)

テーブル範囲の開始位置。
rowSpan

integer

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

integer

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

UpdateLinePropertiesRequest

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

JSON 表現 
{
  "objectId": string,
  "lineProperties": {
    object (LineProperties)
  },
  "fields": string
}
フィールド
objectId

string

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

object (LineProperties)

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

string (FieldMask format)

更新するフィールド。

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

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

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

CreateParagraphBulletsRequest

指定されたテキスト インデックス範囲と重複するすべての段落に箇条書きを作成します。

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

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

JSON 表現 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  },
  "bulletPreset": enum (BulletGlyphPreset)
}
フィールド
objectId

string

箇条書きを追加するテキストを含むシェイプまたはテーブルのオブジェクト ID。
cellLocation

object (TableCellLocation)

変更するテキストが表のセルにある場合、表のセルの位置を指定します（省略可）。オブジェクトが存在する場合、objectId がテーブルを参照している必要があります。
textRange

object (Range)

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

enum (BulletGlyphPreset)

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

BulletGlyphPreset

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

これらのパターンでは、次のリスト項目が使用されます。

  • ARROW: Unicode U+2794 コードポイントに対応する矢印
  • ARROW3D: Unicode U+27a2 コードポイントに対応する 3D 網掛けの矢印
  • CHECKBOX: Unicode U+274f コードポイントに対応する中が空洞の正方形
  • CIRCLE: Unicode U+25cb コードポイントに対応する中抜きの円
  • DIAMOND: Unicode U+25c6 コードポイントに対応する実線のひし形
  • DIAMONDX: Unicode U+2756 コードポイントに対応する「x」の付いたひし形
  • HOLLOWDIAMOND: Unicode U+25c7 コードポイントに対応する中空のひし形
  • DISC: Unicode U+25cf コードポイントに対応する実線の円
  • SQUARE: Unicode U+25a0 コードポイントに対応する実線の正方形
  • STAR: Unicode U+2605 コードポイントに対応するスター
  • ALPHA : 'a'、'b'、'c' などの小文字。
  • UPPERALPHA : 「A」、「B」、「C」などの大文字。
  • DIGIT: 「1」、「2」、「3」などの数字。
  • ZERODIGIT : 先頭に 0 で始まる 0 桁の数字（「01」、「02」、「03」など）。複数の数字を持つ番号には、先頭にゼロは含まれません。
  • ROMAN : 小文字の数字（「i」、「ii」、「iii」など）。
  • UPPERROMAN: 'I'、'II'、'III' などの大文字のローマ数字。
  • LEFTTRIANGLE: Unicode U+25c4 コードポイントに対応する左向きの三角形
列挙型
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_DIGIT_ALPHA_ROMAN 最初の 3 つのリストのネストレベルにピリオド、その後にピリオドが付いた、DIGIT、ALPHA、ROMAN の数値グリフを含む番号付きリスト。
NUMBERED_DIGIT_ALPHA_ROMAN_PARENS 最初の 3 つのリストのネストレベルを表す数字のグリフ、DIGIT、ALPHA、ROMAN、その後に丸括弧を続ける番号付きのリスト。
NUMBERED_DIGIT_NESTED DIGIT 数値のグリフをピリオドで区切った番号付きのリスト。各ネストレベルでは、以前のネストレベルのグリフがプレフィックスとして使用されます。例: '1.'、'1.1.'、'2.'、「2.2.」
NUMBERED_UPPERALPHA_ALPHA_ROMAN 最初の 3 つのリストのネストレベルにピリオド、その後にピリオドが付いた、UPPERALPHA、ALPHA、ROMAN の数値グリフを含む番号付きリスト。
NUMBERED_UPPERROMAN_UPPERALPHA_DIGIT 最初の 3 つのリストのネストレベルにピリオド、その後にピリオドが付いた、UPPERROMAN、UPPERALPHA、DIGIT の数値グリフを含む番号付きリスト。
NUMBERED_ZERODIGIT_ALPHA_ROMAN 最初の 3 つのリストのネストレベルにピリオド、その後にピリオドが付いた、ZERODIGIT、ALPHA、ROMAN の数値グリフを含む番号付きリスト。

AllShapesWithImageRequest を置き換える

指定した条件に一致するすべてのシェイプを指定された画像に置き換えます。

図形を置き換える画像は、プレゼンテーションに挿入されると長方形になります。図形の形状は取りません。

JSON 表現 
{
  "replaceMethod": enum (ReplaceMethod),
  "imageReplaceMethod": enum (ImageReplaceMethod),
  "pageObjectIds": [
    string
  ],

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

  // Union field image_source can be only one of the following:
  "imageUrl": string
  // End of list of possible types for union field image_source.
}
フィールド
replaceMethod
(deprecated)

enum (ReplaceMethod)

replace メソッド。

非推奨 : 代わりに imageReplaceMethod を使用します。

replaceMethod と imageReplaceMethod を両方とも指定した場合、imageReplaceMethod が優先されます。
imageReplaceMethod

enum (ImageReplaceMethod)

画像置換メソッド。

replaceMethod と imageReplaceMethod を両方とも指定した場合、imageReplaceMethod が優先されます。

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

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

pageObjectIds[]

string

空でない場合は、指定したページのページ要素のみに一致します。

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

共用体フィールド criteria。図形を置き換える条件。criteria は次のいずれかになります。
containsText

object (SubstringMatchCriteria)

設定すると、指定したテキストを含むすべてのシェイプがこのリクエストに置き換えられます。

共用体フィールド image_source。画像ソースの種類。image_source は次のいずれかになります。
imageUrl

string

画像の URL。

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

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

replaceMethod

replace メソッド。

列挙型
CENTER_INSIDE 元のシェイプの境界内に収まるように画像を調整、中央揃えし、画像のアスペクト比を維持します。画像のレンダリング サイズがシェイプのサイズよりも小さい場合があります。このパラメータが指定されていない場合、これがデフォルトの方法です。
CENTER_CROP 元のシェイプの境界に合うように画像を拡大縮小します。図形を埋めるために画像がトリミングされる場合があります。画像のレンダリング サイズは、元のシェイプと同じになります。

ImageReplaceMethod

画像置換メソッド。

列挙型
IMAGE_REPLACE_METHOD_UNSPECIFIED 画像の指定方法が指定されていません。この値は使用しないでください。
CENTER_INSIDE 元のシェイプの境界内に収まるように画像を調整、中央揃えし、画像のアスペクト比を維持します。画像のレンダリング サイズがシェイプのサイズよりも小さい場合があります。このパラメータが指定されていない場合、これがデフォルトの方法です。
CENTER_CROP 元のシェイプの境界に合うように画像を拡大縮小します。図形を埋めるために画像がトリミングされる場合があります。画像のレンダリング サイズは、元のシェイプと同じになります。

DuplicateObjectRequest

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

スライドのコピーを作成するときは、指定したスライドの直後に重複するスライドが作成されます。ページ要素を複製すると、重複した要素は最初のページと同じ位置に配置されます。

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

string

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

objectIds

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 が割り当てられます。

UpdateTextStyleRequest

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

JSON 表現 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "style": {
    object (TextStyle)
  },
  "textRange": {
    object (Range)
  },
  "fields": string
}
フィールド
objectId

string

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

cellLocation

object (TableCellLocation)

スタイルを設定するテキストを含むテーブル内のセルの位置。objectId がテーブルを参照する場合、cellLocation には値が必要です。それ以外の場合は、指定しないでください。

style

object (TextStyle)

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

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

テキスト スタイルの変更によっては、スライド エディタの動作を反映する変更が行われる場合があります。詳細については、TextStyle のドキュメントをご覧ください。
textRange

object (Range)

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

隣接する改行が含まれるように、範囲が拡張される場合があります。

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

string (FieldMask format)

更新するフィールド。

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

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

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

AllShapesWithSheetsChartRequest を置き換える

指定した条件に一致するすべてのシェイプを、指定された Google スプレッドシートのグラフに置き換えます。グラフは元の図形の境界内に収まるようにスケーリングされ、中央に配置されます。

注: シェイプをグラフに置き換えるには、spreadsheet.readonly、spreadsheet、drive.readonly、または OAuth スコープのいずれか 1 つが必要です。

JSON 表現 
{
  "containsText": {
    object (SubstringMatchCriteria)
  },
  "spreadsheetId": string,
  "chartId": integer,
  "linkingMode": enum (LinkingMode),
  "pageObjectIds": [
    string
  ]
}
フィールド
containsText

object (SubstringMatchCriteria)

図形を置き換える条件。このリクエストでは、指定されたテキストを含むすべての図形が置き換えられます。
spreadsheetId

string

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

integer

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

linkingMode

enum (LinkingMode)

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

pageObjectIds[]

string

空でない場合は、指定したページのページ要素のみに一致します。

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

LinkingMode

グラフを元のスプレッドシートにリンクするモード。

列挙型
NOT_LINKED_IMAGE グラフはソース スプレッドシートに関連付けられておらず、更新できません。リンクされていないグラフは画像として挿入されます。
LINKED グラフをリンクするとグラフが更新され、他の共同編集者にはスプレッドシートへのリンクが表示されます。

DeleteParagraphBulletsRequest

指定されたテキスト インデックス range と重複するすべての段落から箇条書きを削除します。

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

JSON 表現 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  }
}
フィールド
objectId

string

箇条書きを削除するシェイプまたはテーブルのオブジェクト ID。

cellLocation

object (TableCellLocation)

変更するテキストが表のセルにある場合、表のセルの位置を指定します（省略可）。オブジェクトが存在する場合、objectId がテーブルを参照している必要があります。
textRange

object (Range)

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

UpdateParagraphStyleRequest

指定されたテキスト インデックス範囲と重複する Shape または Table 内のすべての段落のスタイルを更新します。

JSON 表現 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "style": {
    object (ParagraphStyle)
  },
  "textRange": {
    object (Range)
  },
  "fields": string
}
フィールド
objectId

string

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

cellLocation

object (TableCellLocation)

スタイルを設定する段落を含むセル内の場所。objectId がテーブルを参照する場合、cellLocation には値が必要です。それ以外の場合は、指定しないでください。

style

object (ParagraphStyle)

段落のスタイル。

textRange

object (Range)

スタイルを適用する段落を含むテキストの範囲。
fields

string (FieldMask format)

更新するフィールド。

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

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

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

UpdateTableBorderPropertiesRequest

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

JSON 表現 
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  },
  "borderPosition": enum (BorderPosition),
  "tableBorderProperties": {
    object (TableBorderProperties)
  },
  "fields": string
}
フィールド
objectId

string

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

object (TableRange)

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

enum (BorderPosition)

更新を適用する表の範囲内の枠線の位置。枠線の位置を指定しない場合、表の範囲内のすべての枠線にアップデートが適用されます。

tableBorderProperties

object (TableBorderProperties)

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

fields

string (FieldMask format)

更新するフィールド。

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

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

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

BorderPosition

表の枠線の位置。

列挙型
ALL 範囲内のすべての枠線。
BOTTOM 範囲の下部の枠線。
INNER 範囲内の枠線。
INNER_HORIZONTAL 範囲内の水平枠線。
INNER_VERTICAL 範囲内の垂直の枠線。
LEFT 範囲の左側にある枠線。
OUTER 範囲外の枠線。
RIGHT 範囲の右側の枠線。
TOP 範囲の先頭の枠線。

UpdateTableColumnPropertiesRequest

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

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

string

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

integer

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

object (TableColumnProperties)

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

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

string (FieldMask format)

更新するフィールド。

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

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

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

UpdateTableRowPropertiesRequest

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

JSON 表現 
{
  "objectId": string,
  "rowIndices": [
    integer
  ],
  "tableRowProperties": {
    object (TableRowProperties)
  },
  "fields": string
}
フィールド
objectId

string

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

integer

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

object (TableRowProperties)

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

string (FieldMask format)

更新するフィールド。

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

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

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

MergeTableCellsRequest

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

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

string

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

object (TableRange)

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

結合するセル内のテキストがすべて連結され、範囲の左上（「ヘッド」）のセルに保存されます。範囲が四角形でない場合（範囲が結合済みのセルである場合など）は、400 不正なリクエスト エラーが返されます。

UnmergeTableCellsRequest

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

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

string

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

object (TableRange)

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

この範囲に含まれる結合されたセルはすべて結合が解除され、すでに結合が解除されているセルは影響を受けません。範囲にマージされたセルがない場合、リクエストは何も実行しません。結合したセルのいずれかにテキストがある場合、結合されていないセルで変換されたブロックの左上（「ヘッド」）のセルにテキストが表示されます。

GroupObjectsRequest

オブジェクトをグループ化してオブジェクト グループを作成します。たとえば、PageElements をグループ化して、すべての子と同じページに Group を作成します。

JSON 表現 
{
  "groupObjectId": string,
  "childrenObjectIds": [
    string
  ]
}
フィールド
groupObjectId

string

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

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

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

childrenObjectIds[]

string

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

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

UngroupObjectsRequest

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

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

string

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

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

UpdatePageElementAltTextRequest

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

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

string

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

string

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

description

string

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

ReplaceImageRequest

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

画像を置換すると、既存のイメージから一部の image effects が削除されます。

JSON 表現 
{
  "imageObjectId": string,
  "imageReplaceMethod": enum (ImageReplaceMethod),

  // Union field image_source can be only one of the following:
  "url": string
  // End of list of possible types for union field image_source.
}
フィールド
imageObjectId

string

置き換えられる既存の画像の ID。ID は取得リクエストのレスポンスから取得できます。
imageReplaceMethod

enum (ImageReplaceMethod)

置換メソッド。

共用体フィールド image_source。画像ソースの種類。image_source は次のいずれかになります。
url

string

画像の URL。

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

指定した URL は 2 KB を超えないようにしてください。URL は画像とともに保存され、Image.source_url フィールドを介して公開されます。

UpdateSlidePropertiesRequest

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

JSON 表現 
{
  "objectId": string,
  "slideProperties": {
    object (SlideProperties)
  },
  "fields": string
}
フィールド
objectId

string

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

object (SlideProperties)

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

string (FieldMask format)

更新するフィールド。

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

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

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

UpdatePageElementsZOrderRequest

ページ要素の Z オーダーを更新します。Z オーダーは、ページ上の要素を新しい順に並べます。正面のページ要素が背後の要素を覆っている可能性があります。

JSON 表現 
{
  "pageElementObjectIds": [
    string
  ],
  "operation": enum (ZOrderOperation)
}
フィールド
pageElementObjectIds[]

string

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

ページ要素はすべて同じページにする必要があり、グループ化しないでください。

operation

enum (ZOrderOperation)

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

複数のページ要素にオペレーションを適用する場合、オペレーションを維持する前のページ要素内の相対 Z オーダー。

ZOrderOperation

ページ要素の Z オーダーを更新するオペレーション。

列挙型
Z_ORDER_OPERATION_UNSPECIFIED 未指定のオペレーション。
BRING_TO_FRONT ページ要素をページの一番上に移動します。
BRING_FORWARD 指定されたページ要素の一番上の要素に対し、ページ要素を 1 つ前に移動させます。
SEND_BACKWARD 指定されたページ要素の背後にある要素のうち 1 つ後ろのページ要素を返します。
SEND_TO_BACK ページ要素をページの背面に送信します。

UpdateLineCategoryRequest

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

JSON 表現 
{
  "objectId": string,
  "lineCategory": enum (LineCategory)
}
フィールド
objectId

string

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

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

回線は、カテゴリの更新後に再ルーティングされる場合があります。

lineCategory

enum (LineCategory)

更新する明細のカテゴリ。

正確な line type は、更新するカテゴリと、他のページ要素にルーティングする方法に基づいて決定されます。

RerouteLineRequest

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

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

string

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

経路を変更できるのは、「コネクタ」であることを示す category を含む行のみです。線の始点と終点の接続は、別々のページ要素上に配置する必要があります。