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 は次のいずれか 1 つのみを指定できます。
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)

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

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

スライドの挿入位置を示すゼロベースのインデックス(省略可)。

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

slideLayoutReference

object (LayoutReference)

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

  • 前のスライドの索引のマスター。
  • 最初のスライドのマスター(insertIndex がゼロの場合)。
  • プレゼンテーションの最初のマスター(スライドがない場合)。

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

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

placeholderIdMappings[]

object (LayoutPlaceholderIdMapping)

オブジェクトの ID マッピングのリスト。 placeholder を、指定されたレイアウトからスライド上に作成されたプレースホルダに追加します。次の場合にのみ使用可能 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 は次のいずれか 1 つのみを指定できます。
predefinedLayout

enum (PredefinedLayout)

事前定義レイアウト。

layoutId

string

Layout 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 は次のいずれか 1 つのみを指定できます。
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

ページ要素の一般的なプロパティ。

注: 最初に Terraform 構成を 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 Basic Multilingual Plane Private Use Area(U+E000-U+F8FF)の文字が取り除かれます。

insertionIndex

integer

テキストが挿入されるインデックス。Unicode コード単位で、 TextElement 作成します。

インデックスはゼロベースで、文字列の先頭から計算されます。インデックスは、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

空でない場合は、指定されたページのページ要素のみにマッチを制限します。

ブラウザのページ オブジェクト ID が渡された場合、400 不正なリクエスト エラーを返します。 notes master であるか、そのオブジェクト ID のページがプレゼンテーションに存在しない場合に表示されます。

共用体フィールド criteria。置換するテキストを照合するために使用される条件。 criteria は次のいずれか 1 つのみを指定できます。
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 からプレゼンテーションのスライド数までの範囲で指定してください。

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」の後に暗黙的に改行が続く場合、次の文字列の最大値は 2 です。 textRange.start_index 3 は textRange.end_index

段落の境界を越えるテキストを削除すると、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 は次のいずれか 1 つのみを指定できます。
url

string

画像の URL。

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

提出する URL は一般公開されている必要があり、長さは 2 KB 以下である必要があります。URL は画像とともに保存され、 Image.source_url 表示されます。

CreateVideoRequest

動画を作成します。

注: Google ドライブから動画を作成するには、リクエスト元のアプリに drive、drive.readonly、drive.file の OAuth スコープのうち少なくとも 1 つが必要です。

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)

作成される線のカテゴリ。

<ph type="x-smartling-placeholder"></ph> サポート終了 : category してください。

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

両方の Pod を指定した場合、 category および lineCategorycategory が優先されます。

category

enum (LineCategory)

作成される線のカテゴリ。

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

両方の Pod を指定した場合、 category および lineCategorycategory が優先されます。

Pod の IP アドレスを category。ただし、次の値を指定します。 lineCategory、指定した lineCategory 値が使用されます。

どちらも指定しない場合は、次のようになります。 STRAIGHT 使用されます。

カテゴリ

線のカテゴリ。

<ph type="x-smartling-placeholder">

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

RefreshSheetsChartRequest

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

注: グラフを更新するには、spreadsheets.readonly、spreadsheets、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 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 暗黙的に指定され、指定しないでください。単一の "*" すべてのフィールドをリストするための省略形として使用できます。

たとえば、線の塗りつぶしの色を更新するには、 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」など)。数字が複数ある場合は、先頭に 0 は付きません。
  • ROMAN : 小文字のローマ数字(「i」、「ii」、「iii」など)。
  • UPPERROMAN : 大文字のローマ数字(「I」、「II」、「III」など)。
  • LEFTTRIANGLE : 左を指す三角形。Unicode U+25c4 コードポイントに対応します。
列挙型
BULLET_DISC_CIRCLE_SQUARE 箇条書きに DISC, CIRCLE および SQUARE リストの最初の 3 つのネスト レベルの箇条書きグリフ。
BULLET_DIAMONDX_ARROW3D_SQUARE 箇条書きに DIAMONDX, ARROW3D および SQUARE リストの最初の 3 つのネスト レベルの箇条書きグリフ。
BULLET_CHECKBOX 箇条書きに CHECKBOX すべてのリストのネスト レベルでの箇条書きのグリフ。
BULLET_ARROW_DIAMOND_DISC 箇条書きに ARROW, DIAMOND および DISC リストの最初の 3 つのネスト レベルの箇条書きグリフ。
BULLET_STAR_CIRCLE_SQUARE 箇条書きに STAR, CIRCLE および SQUARE リストの最初の 3 つのネスト レベルの箇条書きグリフ。
BULLET_ARROW3D_CIRCLE_SQUARE 箇条書きに ARROW3D, CIRCLE および SQUARE リストの最初の 3 つのネスト レベルの箇条書きグリフ。
BULLET_LEFTTRIANGLE_DIAMOND_DISC 箇条書きに LEFTTRIANGLE, DIAMOND および DISC リストの最初の 3 つのネスト レベルの箇条書きグリフ。
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE 箇条書きに DIAMONDX, HOLLOWDIAMOND および SQUARE リストの最初の 3 つのネスト レベルの箇条書きグリフ。
BULLET_DIAMOND_CIRCLE_SQUARE 箇条書きに DIAMOND, CIRCLE および SQUARE リストの最初の 3 つのネスト レベルの箇条書きグリフ。
NUMBERED_DIGIT_ALPHA_ROMAN 番号付きリスト DIGIT, ALPHA および ROMAN 最初の 3 つのネスト レベルには数値グリフを使用し、その後にピリオドを付けます。
NUMBERED_DIGIT_ALPHA_ROMAN_PARENS 番号付きリスト DIGIT, ALPHA および ROMAN 最初の 3 つのリストネスト レベルには数値グリフを使用し、その後に括弧が続きます。
NUMBERED_DIGIT_NESTED 番号付きリスト DIGIT ピリオドで区切られた数値グリフ。各ネスト レベルは、前のネスト レベルのグリフを接頭辞として使用します。例: 「1.」、'1.1.'、'2.'、'2.2.'.
NUMBERED_UPPERALPHA_ALPHA_ROMAN 番号付きリスト UPPERALPHA, ALPHA および ROMAN 最初の 3 つのネスト レベルには数値グリフを使用し、その後にピリオドを付けます。
NUMBERED_UPPERROMAN_UPPERALPHA_DIGIT 番号付きリスト UPPERROMAN, UPPERALPHA および DIGIT 最初の 3 つのネスト レベルには数値グリフを使用し、その後にピリオドを付けます。
NUMBERED_ZERODIGIT_ALPHA_ROMAN 番号付きリスト ZERODIGIT, ALPHA および ROMAN 最初の 3 つのネスト レベルには数値グリフを使用し、その後にピリオドを付けます。

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)

置換メソッド。

<ph type="x-smartling-placeholder"></ph> サポート終了 : imageReplaceMethod してください。

両方の Pod を指定した場合、 replaceMethod および imageReplaceMethodimageReplaceMethod が優先されます。

imageReplaceMethod

enum (ImageReplaceMethod)

画像の置換メソッドです。

両方の Pod を指定した場合、 replaceMethod および imageReplaceMethodimageReplaceMethod が優先されます。

Pod の IP アドレスを imageReplaceMethod。ただし、次の値を指定します。 replaceMethod、指定した replaceMethod 値が使用されます。

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

pageObjectIds[]

string

空でない場合は、指定されたページのページ要素のみにマッチを制限します。

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

共用体フィールド criteria。シェイプを置き換えるには条件が一致する必要があります。 criteria は次のいずれか 1 つのみを指定できます。
containsText

object (SubstringMatchCriteria)

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

共用体フィールド image_source。画像ソースの種類。 image_source は次のいずれか 1 つのみを指定できます。
imageUrl

string

画像の URL。

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

指定する URL の長さは 2 KB 以下です。URL 自体は画像と一緒に保存され、 Image.source_url 表示されます。

ReplaceMethod

置換メソッド。

<ph type="x-smartling-placeholder">

列挙型
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"

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

ReplaceAllShapesWithSheetsChartRequest

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

注: 図形をグラフに置き換えるには、spreadsheets.readonly、spreadsheets、drive.readonly、drive の 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

空でない場合は、指定されたページのページ要素のみにマッチを制限します。

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

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

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

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

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

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)

結合する表のセルを指定する表の範囲。

結合されるセル内のテキストは連結されて範囲の左上(「head」)セルに格納されます。範囲が長方形以外の場合(すでに結合されているセルが範囲に含まれる場合があるため)、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 つ以上必要です。たとえば、 videos, tables および placeholders グループ化することはできません

UngroupObjectsRequest

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

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

string

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

単独 groups 他の Pod に 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 は次のいずれか 1 つのみを指定できます。
url

string

画像の URL。

画像は挿入時に一度取得され、プレゼンテーション内に表示するためにコピーが保存されます。画像は 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 つずつ相対的に 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

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

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

string

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

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