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)

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

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)

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

  • 前のスライド インデックスのマスター。
  • 挿入インデックスが 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 つの本文が 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)

スライドに適用されるレイアウト上のプレースホルダ。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 の先頭は英数字またはアンダースコア（正規表現 [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 の先頭は英数字またはアンダースコア（正規表現 [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 コード単位）。

インデックスはゼロベースで、文字列の先頭から計算されます。インデックスは、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_INDEX と FIXED_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 固定の範囲。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 の先頭は英数字またはアンダースコア（正規表現 [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 MP 以下にする必要があります。また、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 スコープが必要です。

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

string

ユーザー指定のオブジェクト 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 は、カテゴリと、他のページ要素に接続するためにルーティングされる方法に基づいて決定されます。

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 スプレッドシートの最新バージョンのグラフに置き換えます。

注: グラフを更新するには、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 x 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 : 3D シェーディング付きの矢印。Unicode U+27a2 コードポイントに対応。
  • CHECKBOX : 中空の正方形。Unicode U+274f コードポイントに対応します。
  • CIRCLE : 中空の円。Unicode U+25cb コードポイントに対応します
  • DIAMOND : 塗りつぶされたダイヤモンド。Unicode U+25c6 コードポイントに対応します。
  • DIAMONDX : 「x」が付いたダイヤモンド。Unicode U+2756 コードポイントに対応します。
  • HOLLOWDIAMOND : 中空のダイヤモンド。Unicode U+25c7 コードポイントに対応します。
  • DISC : 実線の円。Unicode U+25cf コードポイントに対応します。
  • SQUARE : 塗りつぶされた正方形。Unicode U+25a0 コードポイントに対応します。
  • STAR : 星。Unicode U+2605 コードポイントに対応します。
  • ALPHA : 小文字（a、b、c など）。
  • UPPERALPHA : 大文字（A、B、C など）。
  • DIGIT : 数値（「1」、「2」、「3」など）。
  • ZERODIGIT : 1 桁の数字の前にゼロが付いた数値（「01」、「02」、「03」など）。2 桁以上の数値には先頭にゼロを付けません。
  • 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 の数値グリフが使用され、その後にピリオドが続く番号付きリスト。

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)

replace メソッド。

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

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

enum (