リクエスト
プレゼンテーションに適用する 1 種類の更新。
JSON 表現 |
---|
{ // Union field |
フィールド | |
---|---|
共用体フィールド kind 。更新の種類。1 つのフィールドのみを指定する必要があります。kind は次のいずれかになります。 |
|
createSlide
|
新しいスライドを作成します。 |
createShape
|
新しいシェイプを作成します。 |
createTable
|
新しいテーブルを作成します。 |
insertText
|
シェイプまたは表のセルにテキストを挿入します。 |
insertTableRows
|
テーブルに行を挿入します。 |
insertTableColumns
|
テーブルに列を挿入します。 |
deleteTableRow
|
テーブルから行を削除します。 |
deleteTableColumn
|
テーブルから列を削除します。 |
replaceAllText
|
指定したテキストのすべてのインスタンスを置き換えます。 |
deleteObject
|
プレゼンテーションからページまたはページ要素を削除します。 |
updatePageElementTransform
|
ページ要素の変換を更新します。 |
updateSlidesPosition
|
プレゼンテーション内のスライドセットの位置を更新します。 |
deleteText
|
図形または表のセルからテキストを削除します。 |
createImage
|
イメージを作成します。 |
createVideo
|
動画を作成します。 |
createSheetsChart
|
埋め込みの Google スプレッドシートのグラフを作成します。 |
createLine
|
線を作成します。 |
refreshSheetsChart
|
Google スプレッドシートのグラフを更新します。 |
updateShapeProperties
|
|
updateImageProperties
|
|
updateVideoProperties
|
|
updatePageProperties
|
|
updateTableCellProperties
|
|
updateLineProperties
|
|
createParagraphBullets
|
段落に箇条書きを作成します。 |
replaceAllShapesWithImage
|
特定の条件に一致するすべての図形を画像に置き換えます。 |
duplicateObject
|
スライドまたはページ要素を複製します。 |
updateTextStyle
|
|
replaceAllShapesWithSheetsChart
|
特定の条件に一致するすべての図形を Google スプレッドシートのグラフに置き換えます。 |
deleteParagraphBullets
|
段落から箇条書きを削除します。 |
updateParagraphStyle
|
|
updateTableBorderProperties
|
|
updateTableColumnProperties
|
|
updateTableRowProperties
|
|
mergeTableCells
|
|
unmergeTableCells
|
|
groupObjects
|
ページ要素などのオブジェクトをグループ化します。 |
ungroupObjects
|
オブジェクトのグループ化を解除します( |
updatePageElementAltText
|
|
replaceImage
|
既存の画像を新しい画像に置き換えます。 |
updateSlideProperties
|
スライドのプロパティを更新します。 |
updatePageElementsZOrder
|
|
updateLineCategory
|
|
rerouteLine
|
|
CreateSlideRequest
スライドを作成します。
JSON 表現 |
---|
{ "objectId": string, "insertionIndex": integer, "slideLayoutReference": { object ( |
フィールド | |
---|---|
objectId
|
ユーザー指定のオブジェクト ID。
ID を指定する場合は、プレゼンテーション内のすべてのページとページ要素で一意である必要があります。ID の先頭は英数字またはアンダースコア(正規表現 ID を指定しない場合、一意の ID が生成されます。 |
insertionIndex
|
スライドを挿入する場所を示す 0 ベースのインデックス(省略可)。 インデックスを指定しない場合、スライドは最後に作成されます。 |
slideLayoutReference
|
現在のマスターに基づいて挿入するスライドのレイアウト参照。次のいずれかです。
現在のマスターに LayoutReference が見つからない場合、400 不正なリクエスト エラーが返されます。
レイアウト参照を指定しない場合、スライドは事前定義された |
placeholderIdMappings[]
|
レイアウトの |
LayoutReference
スライド レイアウトのリファレンス。これは次のいずれかを指す場合があります。
- 事前定義されたレイアウト
- プレゼンテーションのレイアウトの 1 つ。
JSON 表現 |
---|
{ // Union field |
フィールド | |
---|---|
共用体フィールド kind 。LayoutReference の種類。kind は次のいずれかになります。 |
|
predefinedLayout
|
事前定義されたレイアウト。 |
layoutId
|
レイアウト 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 |
フィールド | |
---|---|
objectId
|
スライド上に作成する、上記で指定したプレースホルダのユーザー指定のオブジェクト ID。
ID を指定する場合は、プレゼンテーション内のすべてのページとページ要素で一意である必要があります。ID の先頭は英数字またはアンダースコア(正規表現 ID を指定しない場合、一意の ID が生成されます。 |
共用体フィールド kind 。レイアウト上のプレースホルダを識別する種類。
kind は次のいずれかになります。 |
|
layoutPlaceholder
|
スライドに適用されるレイアウト上のプレースホルダ。 |
layoutPlaceholderObjectId
|
スライドに適用されるレイアウト上のプレースホルダのオブジェクト ID。 |
CreateShapeRequest
新しいシェイプを作成します。
JSON 表現 |
---|
{ "objectId": string, "elementProperties": { object ( |
フィールド | |
---|---|
objectId
|
ユーザー指定のオブジェクト ID。
ID を指定する場合は、プレゼンテーション内のすべてのページとページ要素で一意である必要があります。ID の先頭は英数字またはアンダースコア(正規表現 |
elementProperties
|
シェイプの要素プロパティ。 |
shapeType
|
シェイプのタイプ。 |
PageElementProperties
ページ要素の一般的なプロパティ。
注: PageElement
を最初に作成すると、API によって size
と transform
の両方の値が変更される場合がありますが、視覚的なサイズは変更されません。
JSON 表現 |
---|
{ "pageObjectId": string, "size": { object ( |
フィールド | |
---|---|
pageObjectId
|
要素が配置されているページのオブジェクト ID。 |
size
|
要素のサイズ。 |
transform
|
要素の変換。 |
CreateTableRequest
新しいテーブルを作成します。
JSON 表現 |
---|
{
"objectId": string,
"elementProperties": {
object ( |
フィールド | |
---|---|
objectId
|
ユーザー指定のオブジェクト ID。
ID を指定する場合は、プレゼンテーション内のすべてのページとページ要素で一意である必要があります。ID の先頭は英数字またはアンダースコア(正規表現 ID を指定しない場合、一意の ID が生成されます。 |
elementProperties
|
表の要素プロパティ。 テーブルは、指定されたサイズで作成されます(最小サイズが適用されます)。サイズを指定しない場合、テーブルのサイズは自動的に設定されます。 テーブル変換のスケールは 1 で、シアー コンポーネントは使用できません。変換が指定されていない場合、テーブルはページの中央に配置されます。 |
rows
|
テーブル内の行数。 |
columns
|
テーブル内の列数。 |
InsertTextRequest
シェイプまたは表セルにテキストを挿入します。
JSON 表現 |
---|
{
"objectId": string,
"cellLocation": {
object ( |
フィールド | |
---|---|
objectId
|
テキストを挿入する図形または表のオブジェクト ID。 |
cellLocation
|
テキストをテーブルセルに挿入する場合は、テーブルセルの位置(省略可)。objectId が指定されている場合は、テーブルを参照する必要があります。 |
text
|
挿入するテキスト。
改行文字を挿入すると、そのインデックスに新しい
挿入されたテキストのテキスト スタイルは自動的に決定されます。通常は、隣接するテキストのスタイルが保持されます。ほとんどの場合、テキストは挿入インデックスに存在する 挿入されたテキストから、一部の制御文字(U+0000 ~ U+0008、U+000C ~ U+001F)と Unicode 基本多言語プレーンの私用領域の文字(U+E000 ~ U+F8FF)が削除されます。 |
insertionIndex
|
テキストが挿入されるインデックス( インデックスはゼロベースで、文字列の先頭から計算されます。インデックスは、Unicode グラフ記号クラスタ内に挿入されないように調整される場合があります。このような場合は、テキストがグラフーム クラスタの直後に挿入されます。 |
InsertTableRowsRequest
テーブルに行を挿入します。
JSON 表現 |
---|
{
"tableObjectId": string,
"cellLocation": {
object ( |
フィールド | |
---|---|
tableObjectId
|
行を挿入するテーブル。 |
cellLocation
|
行を挿入する参照テーブルのセル位置。 参照セルが配置されている行の上に(または下に)新しい行が挿入されます。参照セルが結合セルの場合は、結合セルの上に(または下に)新しい行が挿入されます。 |
insertBelow
|
参照セルの位置の下に新しい行を挿入するかどうか。
|
number
|
挿入する行数。リクエストあたり最大 20 件。 |
InsertTableColumnsRequest
テーブルに列を挿入します。
テーブル内の他の列は、新しい列に合わせてサイズが変更されます。
JSON 表現 |
---|
{
"tableObjectId": string,
"cellLocation": {
object ( |
フィールド | |
---|---|
tableObjectId
|
列を挿入するテーブル。 |
cellLocation
|
列を挿入する参照テーブルのセル位置。 参照セルがある列の左側(または右側)に新しい列が挿入されます。参照セルが結合セルの場合は、結合セルの左側(または右側)に新しい列が挿入されます。 |
insertRight
|
参照セルの位置の右側に新しい列を挿入するかどうか。
|
number
|
挿入する列の数。リクエストあたり最大 20 件。 |
DeleteTableRowRequest
テーブルから行を削除します。
JSON 表現 |
---|
{
"tableObjectId": string,
"cellLocation": {
object ( |
フィールド | |
---|---|
tableObjectId
|
行を削除するテーブル。 |
cellLocation
|
行を削除する参照テーブルのセル位置。 このセルがまたがっている行は削除されます。結合されたセルの場合は、複数の行が削除されます。この削除後にテーブルに行が残っていない場合、テーブル全体が削除されます。 |
DeleteTableColumnRequest
テーブルから列を削除します。
JSON 表現 |
---|
{
"tableObjectId": string,
"cellLocation": {
object ( |
フィールド | |
---|---|
tableObjectId
|
列を削除するテーブル。 |
cellLocation
|
列を削除する参照テーブルのセル位置。 このセルがまたがっている列は削除されます。結合セルの場合は、複数の列が削除されます。この削除後にテーブルに列が残っていない場合、テーブル全体が削除されます。 |
ReplaceAllTextRequest
条件に一致するテキストのすべてのインスタンスを replace text
に置き換えます。
JSON 表現 |
---|
{ "replaceText": string, "pageObjectIds": [ string ], // Union field |
フィールド | |
---|---|
replaceText
|
一致したテキストに置き換えるテキスト。 |
pageObjectIds[]
|
空でない場合、一致は指定されたページのページ要素のみに制限されます。
|
共用体フィールド criteria 。置換するテキストの照合に使用される条件。criteria は次のいずれかになります。 |
|
containsText
|
このサブ文字列に一致するシェイプ内のテキストを検索します。 |
SubstringMatchCriteria
シェイプまたは表内の特定のテキスト文字列に一致する条件。
JSON 表現 |
---|
{ "text": string, "matchCase": boolean, "searchByRegex": boolean } |
フィールド | |
---|---|
text
|
シェイプまたは表内で検索するテキスト。 |
matchCase
|
検索で大文字と小文字を区別するかどうかを示します。
|
searchByRegex
|
省略可。検索値を正規表現として扱う必要がある場合は true。パターンのバックスラッシュはエスケープする必要があります。
|
DeleteObjectRequest
プレゼンテーションからオブジェクト(pages
または page elements
)を削除します。
JSON 表現 |
---|
{ "objectId": string } |
フィールド | |
---|---|
objectId
|
削除するページまたはページ要素のオブジェクト ID。
削除オペレーション後に レイアウトでプレースホルダを削除すると、空の継承プレースホルダも削除されます。 |
UpdatePageElementTransformRequest
ページ要素の変換を更新します。
グループの変換を更新すると、そのグループ内のページ要素の絶対変換が変更され、外観が変化する可能性があります。詳しくは、PageElement.transform
のドキュメントをご覧ください。
JSON 表現 |
---|
{ "objectId": string, "transform": { object ( |
フィールド | |
---|---|
objectId
|
更新するページ要素のオブジェクト ID。 |
transform
|
ページ要素の更新に使用される入力変換行列。 |
applyMode
|
変換更新の適用モード。 |
ApplyMode
変換更新の適用モード。
列挙型 | |
---|---|
APPLY_MODE_UNSPECIFIED
|
モードが指定されていません。 |
RELATIVE
|
新しい AffineTransform 行列を既存の行列に適用し、その結果の連結で既存の行列を置き換えます。 |
ABSOLUTE
|
既存の AffineTransform 行列を新しい行列に置き換えます。 |
UpdateSlidesPositionRequest
プレゼンテーション内のスライドの位置を更新します。
JSON 表現 |
---|
{ "slideObjectIds": [ string ], "insertionIndex": integer } |
フィールド | |
---|---|
slideObjectIds[]
|
移動する必要があるプレゼンテーション内のスライドの ID。このリストのスライドは、既存のプレゼンテーションの順序で、重複がないようにする必要があります。 |
insertionIndex
|
移動前のスライドの配置に基づいて、スライドを挿入するインデックス。0 ~プレゼンテーションのスライド数(両端を含む)の範囲で指定してください。 |
DeleteTextRequest
図形または表のセルからテキストを削除します。
JSON 表現 |
---|
{ "objectId": string, "cellLocation": { object ( |
フィールド | |
---|---|
objectId
|
テキストを削除する図形または表のオブジェクト ID。 |
cellLocation
|
表のセルからテキストを削除する場合は、表のセル位置を指定します(省略可)。objectId が存在する場合は、テーブルを参照する必要があります。 |
textRange
|
図形または表のセル内のテキストの末尾には、削除できない暗黙的な改行文字が常に存在します。
段落の境界をまたぐテキストを削除すると、2 つの段落が統合されるため、段落のスタイルやリストが変更される可能性があります。 サロゲートペアの 1 つのコード単位のみを含む範囲は、両方のコード単位を含むように拡張されます。 |
範囲
インデックスに登録されたコレクションの連続した範囲(テキスト内の文字など)を指定します。
JSON 表現 |
---|
{
"startIndex": integer,
"endIndex": integer,
"type": enum ( |