Requests

リクエスト

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

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 は英数字またはアンダースコアで始まり(正規表現 [a-zA-Z0-9_] に一致)、残りの文字には英数字、アンダースコア、ハイフン、コロンを使用できます(正規表現 [a-zA-Z0-9_-:] に一致)。ID の長さは 5 ~ 50 文字にする必要があります。

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

insertionIndex

integer

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

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

slideLayoutReference

object (LayoutReference)

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

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

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

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

placeholderIdMappings[]

object (LayoutPlaceholderIdMapping)

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

LayoutReference

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

  • 事前定義されたレイアウト
  • プレゼンテーションのレイアウトの 1 つ。
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。

PredefinedLayout

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

列挙型
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 大きな数字の見出しがあるレイアウト。

LayoutPlaceholderIdMapping

指定されたレイアウトからスライドに作成されるプレースホルダのユーザー指定の 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 は英数字またはアンダースコアで始まり(正規表現 [a-zA-Z0-9_] に一致)、残りの文字には英数字、アンダースコア、ハイフン、コロンを使用できます(正規表現 [a-zA-Z0-9_-:] に一致)。ID の長さは 5 ~ 50 文字にする必要があります。

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

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

object (Placeholder)

スライドに適用されるレイアウトのプレースホルダ。typeindex のみが必要です。たとえば、事前定義された 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 は英数字またはアンダースコアで始まり(正規表現 [a-zA-Z0-9_] に一致)、残りの文字には英数字、アンダースコア、ハイフン、コロンを使用できます(正規表現 [a-zA-Z0-9_-:] に一致)。ID の長さは 5 文字以上 50 文字以下にする必要があります。空の場合、一意の識別子が生成されます。

elementProperties

object (PageElementProperties)

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

shapeType

enum (Type)

シェイプのタイプ。

PageElementProperties

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

注: PageElement を最初に作成するときに、API が sizetransform の両方の値を変更することがありますが、視覚的なサイズは変更されません。

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 は英数字またはアンダースコアで始まり(正規表現 [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 基本多言語面私用領域(U+E000 ~ U+F8FF)の文字が削除されます。

insertionIndex

integer

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

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

InsertTableRowsRequest

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

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

string

行を挿入するテーブル。

cellLocation

object (TableCellLocation)

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

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

insertBelow

boolean

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

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

integer

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

InsertTableColumnsRequest

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

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

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

string

列を挿入するテーブル。

cellLocation

object (TableCellLocation)

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

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

insertRight

boolean

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

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

integer

挿入する列の数。リクエストあたり最大 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,
  "searchByRegex": boolean
}
フィールド
text

string

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

matchCase

boolean

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

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

boolean

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

  • 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 からプレゼンテーションのスライド数までの整数(両端の値を含む)にする必要があります。

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_INDEXFIXED_RANGE の明示的な境界を指定する場合は注意が必要です。たとえば、テキストが「ABC」で、その後に暗黙的な改行がある場合、textRange.start_index の最大値は 2、textRange.end_index の最大値は 3 になります。

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

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

範囲

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

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

integer

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

endIndex

integer

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

type

enum (Type)

範囲のタイプ。

タイプ

範囲のタイプ。

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

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 は英数字またはアンダースコアで始まり(正規表現 [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 未満、2,500 万ピクセル以下で、PNG、JPEG、GIF のいずれかの形式にする必要があります。

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

CreateVideoRequest

動画を作成します。

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

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

string

ユーザー指定のオブジェクト 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 スプレッドシートのグラフを作成します。

注: グラフを作成するには、spreadsheets.readonly、spreadsheets、drive.readonly、drive.file、drive のいずれかの OAuth スコープが少なくとも 1 つ必要です。

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 は英数字またはアンダースコアで始まり(正規表現 [a-zA-Z0-9_] に一致)、残りの文字には英数字、アンダースコア、ハイフン、コロンを使用できます(正規表現 [a-zA-Z0-9_-:] に一致)。ID の長さは 5 ~ 50 文字にする必要があります。

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

elementProperties

object (PageElementProperties)

線の要素プロパティ。

lineCategory
(deprecated)

enum (Category)

作成する行のカテゴリ。

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

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

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

category

enum (LineCategory)

作成する行のカテゴリ。

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

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

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

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

カテゴリ

回線のカテゴリ。

列挙型
STRAIGHT ストレート コネクタ(ストレート コネクタ 1 を含む)。カテゴリが指定されていない場合、これがデフォルトのカテゴリになります。
BENT コネクタ 2 ~ 5 を含む、曲がったコネクタ。
CURVED 曲線コネクタ(曲線コネクタ 2 ~ 5 を含む)。

RefreshSheetsChartRequest

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

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

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 は暗黙的に指定されるため、指定しないでください。1 つの "*" は、すべてのフィールドをリストする省略形として使用できます。

たとえば、シェイプの背景の単色塗りつぶしの色を更新するには、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 は暗黙的に指定されるため、指定しないでください。1 つの "*" は、すべてのフィールドをリストする省略形として使用できます。

たとえば、画像の輪郭の色を更新するには、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 は暗黙的に指定されるため、指定しないでください。1 つの "*" は、すべてのフィールドをリストする省略形として使用できます。

たとえば、動画の枠線の色を更新するには、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 は暗黙的に指定されるため、指定しないでください。1 つの "*" は、すべてのフィールドをリストする省略形として使用できます。

たとえば、ページの背景の単色塗りつぶしの色を更新するには、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 は暗黙的に指定されるため、指定しないでください。1 つの "*" は、すべてのフィールドをリストする省略形として使用できます。

たとえば、表のセルの背景の単色塗りつぶしの色を更新するには、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 は暗黙的に指定されるため、指定しないでください。1 つの "*" は、すべてのフィールドをリストする省略形として使用できます。

たとえば、線の単色塗りつぶし色を更新するには、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 : 1 桁の数字の前に 0 が付いた数字(「01」、「02」、「03」など)。2 桁以上の数字の先頭にゼロは付きません。
  • ROMAN : 小文字のローマ数字(「i」、「ii」、「iii」など)。
  • UPPERROMAN : 大文字のローマ数字(「I」、「II」、「III」など)。
  • LEFTTRIANGLE : 左向きの三角形。Unicode U+25c4 コードポイントに対応します。
列挙型
BULLET_DISC_CIRCLE_SQUARE 最初の 3 つのリストのネスト レベルに DISCCIRCLESQUARE の箇条書きグリフを使用した箇条書きリスト。
BULLET_DIAMONDX_ARROW3D_SQUARE 最初の 3 つのリストのネスト レベルに DIAMONDXARROW3DSQUARE の箇条書きグリフを使用した箇条書きリスト。
BULLET_CHECKBOX すべてのリストのネストレベルで CHECKBOX の箇条書きグリフを使用する箇条書きリスト。
BULLET_ARROW_DIAMOND_DISC 最初の 3 つのリストのネスト レベルに ARROWDIAMONDDISC の箇条書きグリフを使用した箇条書きリスト。
BULLET_STAR_CIRCLE_SQUARE 最初の 3 つのリストのネスト レベルに STARCIRCLESQUARE の箇条書きグリフを使用した箇条書きリスト。
BULLET_ARROW3D_CIRCLE_SQUARE 最初の 3 つのリストのネスト レベルに ARROW3DCIRCLESQUARE の箇条書きグリフを使用した箇条書きリスト。
BULLET_LEFTTRIANGLE_DIAMOND_DISC 最初の 3 つのリストのネスト レベルに LEFTTRIANGLEDIAMONDDISC の箇条書きグリフを使用した箇条書きリスト。
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE 最初の 3 つのリストのネスト レベルに DIAMONDXHOLLOWDIAMONDSQUARE の箇条書きグリフを使用した箇条書きリスト。
BULLET_DIAMOND_CIRCLE_SQUARE 最初の 3 つのリストのネスト レベルに DIAMONDCIRCLESQUARE の箇条書きグリフを使用した箇条書きリスト。
NUMBERED_DIGIT_ALPHA_ROMAN 最初の 3 つのリストのネスト レベルに DIGITALPHAROMAN の数値グリフを使用し、その後にピリオドが続く番号付きリスト。
NUMBERED_DIGIT_ALPHA_ROMAN_PARENS 最初の 3 つのリストのネストレベルに DIGITALPHAROMAN の数値グリフを使用し、その後に括弧を付けた番号付きリスト。
NUMBERED_DIGIT_NESTED DIGIT 数値グリフがピリオドで区切られた番号付きリスト。各ネストレベルでは、前のネストレベルのグリフが接頭辞として使用されます。例: 「1.」、'1.1.', '2.', '2.2.'。
NUMBERED_UPPERALPHA_ALPHA_ROMAN 最初の 3 つのリストのネスト レベルに UPPERALPHAALPHAROMAN の数値グリフを使用し、その後にピリオドが続く番号付きリスト。
NUMBERED_UPPERROMAN_UPPERALPHA_DIGIT 最初の 3 つのリストのネスト レベルに UPPERROMANUPPERALPHADIGIT の数値グリフを使用し、その後にピリオドが続く番号付きリスト。
NUMBERED_ZERODIGIT_ALPHA_ROMAN 最初の 3 つのリストのネスト レベルに ZERODIGITALPHAROMAN の数値グリフを使用し、その後にピリオドが続く番号付きリスト。

ReplaceAllShapesWithImageRequest

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

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

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)

置換メソッド。

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

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

imageReplaceMethod

enum (ImageReplaceMethod)

画像置換メソッド。

replaceMethodimageReplaceMethod の両方を指定すると、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。

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

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

ReplaceMethod

置換メソッド。

列挙型
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 は暗黙的に指定されるため、指定しないでください。1 つの "*" は、すべてのフィールドをリストする省略形として使用できます。

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

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

ReplaceAllShapesWithSheetsChartRequest

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

注: 図形をグラフに置き換えるには、少なくとも spreadsheets.readonly、spreadsheets、drive.readonly、drive のいずれかの OAuth スコープが必要です。

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 は暗黙的に指定されるため、指定しないでください。1 つの "*" は、すべてのフィールドをリストする省略形として使用できます。

たとえば、段落の配置を更新するには、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 は暗黙的に指定されるため、指定しないでください。1 つの "*" は、すべてのフィールドをリストする省略形として使用できます。

たとえば、テーブルの枠線の単色塗りつぶしの色を更新するには、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 Bad Request エラーが返されます。

fields

string (FieldMask format)

更新するフィールド。

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

たとえば、列の幅を更新するには、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 は暗黙的に指定されるため、指定しないでください。1 つの "*" は、すべてのフィールドをリストする省略形として使用できます。

たとえば、最小行の高さを更新するには、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 は英数字またはアンダースコアで始まり(正規表現 [a-zA-Z0-9_] に一致)、残りの文字には英数字、アンダースコア、ハイフン、コロンを使用できます(正規表現 [a-zA-Z0-9_-:] に一致)。ID の長さは 5 ~ 50 文字にする必要があります。

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

childrenObjectIds[]

string

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

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

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 は、GET リクエストのレスポンスから取得できます。

imageReplaceMethod

enum (ImageReplaceMethod)

置換メソッド。

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

string

画像 URL。

画像は挿入時に一度だけ取得され、プレゼンテーション内に表示するためにコピーが保存されます。画像は 50 MB 未満、2,500 万ピクセル以下で、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 は暗黙的に指定されるため、指定しないでください。1 つの "*" は、すべてのフィールドをリストする省略形として使用できます。

たとえば、スライドをスキップするかどうかを更新するには、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 が含まれる線のみを再ルーティングできます。線の開始接続と終了接続は、異なるページ要素に配置する必要があります。