Requests

{

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

object (CreateSlideRequest)

Creates a new slide.

object (CreateShapeRequest)

Creates a new shape.

object (CreateTableRequest)

Creates a new table.

object (InsertTextRequest)

Inserts text into a shape or table cell.

object (InsertTableRowsRequest)

Inserts rows into a table.

object (InsertTableColumnsRequest)

Inserts columns into a table.

object (DeleteTableRowRequest)

Deletes a row from a table.

object (DeleteTableColumnRequest)

Deletes a column from a table.

object (ReplaceAllTextRequest)

Replaces all instances of specified text.

object (DeleteObjectRequest)

Deletes a page or page element from the presentation.

object (UpdatePageElementTransformRequest)

Updates the transform of a page element.

object (UpdateSlidesPositionRequest)

Updates the position of a set of slides in the presentation.

object (DeleteTextRequest)

Deletes text from a shape or a table cell.

object (CreateImageRequest)

Creates an image.

object (CreateVideoRequest)

Creates a video.

object (CreateSheetsChartRequest)

Creates an embedded Google Sheets chart.

object (CreateLineRequest)

Creates a line.

object (RefreshSheetsChartRequest)

Refreshes a Google Sheets chart.

object (UpdateShapePropertiesRequest)

Updates the properties of a Shape.

object (UpdateImagePropertiesRequest)

Updates the properties of an Image.

object (UpdateVideoPropertiesRequest)

Updates the properties of a Video.

object (UpdatePagePropertiesRequest)

Updates the properties of a Page.

object (UpdateTableCellPropertiesRequest)

Updates the properties of a TableCell.

object (UpdateLinePropertiesRequest)

Updates the properties of a Line.

object (CreateParagraphBulletsRequest)

Creates bullets for paragraphs.

object (ReplaceAllShapesWithImageRequest)

Replaces all shapes matching some criteria with an image.

object (DuplicateObjectRequest)

Duplicates a slide or page element.

object (UpdateTextStyleRequest)

Updates the styling of text within a Shape or Table.

object (ReplaceAllShapesWithSheetsChartRequest)

Replaces all shapes matching some criteria with a Google Sheets chart.

object (DeleteParagraphBulletsRequest)

Deletes bullets from paragraphs.

object (UpdateParagraphStyleRequest)

Updates the styling of paragraphs within a Shape or Table.

object (UpdateTableBorderPropertiesRequest)

Updates the properties of the table borders in a Table.

object (UpdateTableColumnPropertiesRequest)

Updates the properties of a Table column.

object (UpdateTableRowPropertiesRequest)

Updates the properties of a Table row.

object (MergeTableCellsRequest)

Merges cells in a Table.

object (UnmergeTableCellsRequest)

Unmerges cells in a Table.

object (GroupObjectsRequest)

Groups objects, such as page elements.

object (UngroupObjectsRequest)

Ungroups objects, such as groups.

object (UpdatePageElementAltTextRequest)

Updates the alt text title and/or description of a page element.

object (ReplaceImageRequest)

Replaces an existing image with a new image.

object (UpdateSlidePropertiesRequest)

Updates the properties of a Slide

object (UpdatePageElementsZOrderRequest)

Updates the Z-order of page elements.

object (UpdateLineCategoryRequest)

Updates the category of a line.

object (RerouteLineRequest)

Reroutes a line such that it's connected at the two closest connection sites on the connected page elements.

{
  "objectId": string,
  "insertionIndex": integer,
  "slideLayoutReference": {
    object (LayoutReference)
  },
  "placeholderIdMappings": [
    {
      object (LayoutPlaceholderIdMapping)
    }
  ]
}

string

A user-supplied object ID.

If you specify an ID, it must be unique among all pages and page elements in the presentation. The ID must start with an alphanumeric character or an underscore (matches regex [a-zA-Z0-9_]); remaining characters may include those as well as a hyphen or colon (matches regex [a-zA-Z0-9_-:]). The ID length must be between 5 and 50 characters, inclusive.

If you don't specify an ID, a unique one is generated.

integer

The optional zero-based index indicating where to insert the slides.

If you don't specify an index, the slide is created at the end.

object (LayoutReference)

Layout reference of the slide to be inserted, based on the current master, which is one of the following:

• The master of the previous slide index.
• The master of the first slide, if the insertionIndex is zero.
• The first master in the presentation, if there are no slides.

If the LayoutReference is not found in the current master, a 400 bad request error is returned.

If you don't specify a layout reference, the slide uses the predefined BLANK layout.

object (LayoutPlaceholderIdMapping)

An optional list of object ID mappings from the placeholder (s) on the layout to the placeholders that are created on the slide from the specified layout. Can only be used when slideLayoutReference is specified.

{

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

enum (PredefinedLayout)

Predefined layout.

string

Layout ID: the object ID of one of the layouts in the presentation.

{
  "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.
}

string

A user-supplied object ID for the placeholder identified above that to be created onto a slide.

If you specify an ID, it must be unique among all pages and page elements in the presentation. The ID must start with an alphanumeric character or an underscore (matches regex [a-zA-Z0-9_]); remaining characters may include those as well as a hyphen or colon (matches regex [a-zA-Z0-9_-:]). The length of the ID must not be less than 5 or greater than 50.

If you don't specify an ID, a unique one is generated.

object (Placeholder)

The placeholder on a layout that will be applied to a slide. Only type and index are needed. For example, a predefined TITLE_AND_BODY layout may usually have a TITLE placeholder with index 0 and a BODY placeholder with index 0.

string

The object ID of the placeholder on a layout that will be applied to a slide.

{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "shapeType": enum (Type)
}

string

A user-supplied object ID.

If you specify an ID, it must be unique among all pages and page elements in the presentation. The ID must start with an alphanumeric character or an underscore (matches regex [a-zA-Z0-9_]); remaining characters may include those as well as a hyphen or colon (matches regex [a-zA-Z0-9_-:]). The length of the ID must not be less than 5 or greater than 50. If empty, a unique identifier will be generated.

object (PageElementProperties)

The element properties for the shape.

enum (Type)

The shape type.

{
  "pageObjectId": string,
  "size": {
    object (Size)
  },
  "transform": {
    object (AffineTransform)
  }
}

string

The object ID of the page where the element is located.

object (Size)

The size of the element.

object (AffineTransform)

The transform for the element.

{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "rows": integer,
  "columns": integer
}

string

A user-supplied object ID.

If you specify an ID, it must be unique among all pages and page elements in the presentation. The ID must start with an alphanumeric character or an underscore (matches regex [a-zA-Z0-9_]); remaining characters may include those as well as a hyphen or colon (matches regex [a-zA-Z0-9_-:]). The length of the ID must not be less than 5 or greater than 50.

If you don't specify an ID, a unique one is generated.

object (PageElementProperties)

The element properties for the table.

The table will be created at the provided size, subject to a minimum size. If no size is provided, the table will be automatically sized.

Table transforms must have a scale of 1 and no shear components. If no transform is provided, the table will be centered on the page.

integer

Number of rows in the table.

integer

Number of columns in the table.

{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "text": string,
  "insertionIndex": integer
}

string

The object ID of the shape or table where the text will be inserted.

object (TableCellLocation)

The optional table cell location if the text is to be inserted into a table cell. If present, the objectId must refer to a table.

string

The text to be inserted.

Inserting a newline character will implicitly create a new ParagraphMarker at that index. The paragraph style of the new paragraph will be copied from the paragraph at the current insertion index, including lists and bullets.

Text styles for inserted text will be determined automatically, generally preserving the styling of neighboring text. In most cases, the text will be added to the TextRun that exists at the insertion index.

Some control characters (U+0000-U+0008, U+000C-U+001F) and characters from the Unicode Basic Multilingual Plane Private Use Area (U+E000-U+F8FF) will be stripped out of the inserted text.

integer

The index where the text will be inserted, in Unicode code units, based on TextElement indexes.

The index is zero-based and is computed from the start of the string. The index may be adjusted to prevent insertions inside Unicode grapheme clusters. In these cases, the text will be inserted immediately after the grapheme cluster.

{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "insertBelow": boolean,
  "number": integer
}

string

The table to insert rows into.

object (TableCellLocation)

The reference table cell location from which rows will be inserted.

A new row will be inserted above (or below) the row where the reference cell is. If the reference cell is a merged cell, a new row will be inserted above (or below) the merged cell.

boolean

Whether to insert new rows below the reference cell location.

• True : insert below the cell.
• False : insert above the cell.

integer

The number of rows to be inserted. Maximum 20 per request.

{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "insertRight": boolean,
  "number": integer
}

string

The table to insert columns into.

object (TableCellLocation)

The reference table cell location from which columns will be inserted.

A new column will be inserted to the left (or right) of the column where the reference cell is. If the reference cell is a merged cell, a new column will be inserted to the left (or right) of the merged cell.

boolean

Whether to insert new columns to the right of the reference cell location.

• True : insert to the right.
• False : insert to the left.

integer

The number of columns to be inserted. Maximum 20 per request.

{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  }
}

string

The table to delete rows from.

object (TableCellLocation)

The reference table cell location from which a row will be deleted.

The row this cell spans will be deleted. If this is a merged cell, multiple rows will be deleted. If no rows remain in the table after this deletion, the whole table is deleted.

{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  }
}

string

The table to delete columns from.

object (TableCellLocation)

The reference table cell location from which a column will be deleted.

The column this cell spans will be deleted. If this is a merged cell, multiple columns will be deleted. If no columns remain in the table after this deletion, the whole table is deleted.

{
  "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.
}

string

The text that will replace the matched text.

string

If non-empty, limits the matches to page elements only on the given pages.

Returns a 400 bad request error if given the page object ID of a notes master, or if a page with that object ID doesn't exist in the presentation.

object (SubstringMatchCriteria)

Finds text in a shape matching this substring.

{
  "text": string,
  "matchCase": boolean
}

string

The text to search for in the shape or table.

boolean

Indicates whether the search should respect case:

• True : the search is case sensitive.
• False : the search is case insensitive.

{
  "objectId": string
}

string

The object ID of the page or page element to delete.

If after a delete operation a group contains only 1 or no page elements, the group is also deleted.

If a placeholder is deleted on a layout, any empty inheriting placeholders are also deleted.

{
  "objectId": string,
  "transform": {
    object (AffineTransform)
  },
  "applyMode": enum (ApplyMode)
}

string

The object ID of the page element to update.

object (AffineTransform)

The input transform matrix used to update the page element.

enum (ApplyMode)

The apply mode of the transform update.

{
  "slideObjectIds": [
    string
  ],
  "insertionIndex": integer
}

string

The IDs of the slides in the presentation that should be moved. The slides in this list must be in existing presentation order, without duplicates.

integer

The index where the slides should be inserted, based on the slide arrangement before the move takes place. Must be between zero and the number of slides in the presentation, inclusive.

{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  }
}

string

The object ID of the shape or table from which the text will be deleted.

object (TableCellLocation)

The optional table cell location if the text is to be deleted from a table cell. If present, the objectId must refer to a table.

object (Range)

The range of text to delete, based on TextElement indexes.

There is always an implicit newline character at the end of a shape's or table cell's text that cannot be deleted. Range.Type.ALL will use the correct bounds, but care must be taken when specifying explicit bounds for range types FROM_START_INDEX and FIXED_RANGE. For example, if the text is "ABC", followed by an implicit newline, then the maximum value is 2 for textRange.start_index and 3 for textRange.end_index.

Deleting text that crosses a paragraph boundary may result in changes to paragraph styles and lists as the two paragraphs are merged.

Ranges that include only one code unit of a surrogate pair are expanded to include both code units.

{
  "startIndex": integer,
  "endIndex": integer,
  "type": enum (Type)
}

integer

The optional zero-based index of the beginning of the collection. Required for FIXED_RANGE and FROM_START_INDEX ranges.

integer

The optional zero-based index of the end of the collection. Required for FIXED_RANGE ranges.

enum (Type)

The type of range.

{
  "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.
}

string

A user-supplied object ID.

If you specify an ID, it must be unique among all pages and page elements in the presentation. The ID must start with an alphanumeric character or an underscore (matches regex [a-zA-Z0-9_]); remaining characters may include those as well as a hyphen or colon (matches regex [a-zA-Z0-9_-:]). The length of the ID must not be less than 5 or greater than 50.

If you don't specify an ID, a unique one is generated.

object (PageElementProperties)

The element properties for the image.

When the aspect ratio of the provided size does not match the image aspect ratio, the image is scaled and centered with respect to the size in order to maintain the aspect ratio. The provided transform is applied after this operation.

The PageElementProperties.size property is optional. If you don't specify the size, the default size of the image is used.

The PageElementProperties.transform property is optional. If you don't specify a transform, the image will be placed at the top-left corner of the page.

string

The image URL.

The image is fetched once at insertion time and a copy is stored for display inside the presentation. Images must be less than 50 MB in size, can't exceed 25 megapixels, and must be in one of PNG, JPEG, or GIF formats.

The provided URL must be publicly accessible and up to 2 KB in length. The URL is saved with the image, and exposed through the Image.source_url field.

{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "source": enum (Source),
  "id": string
}

string

A user-supplied object ID.

If you specify an ID, it must be unique among all pages and page elements in the presentation. The ID must start with an alphanumeric character or an underscore (matches regex [a-zA-Z0-9_]); remaining characters may include those as well as a hyphen or colon (matches regex [a-zA-Z0-9_-:]). The length of the ID must not be less than 5 or greater than 50.

If you don't specify an ID, a unique one is generated.

object (PageElementProperties)

The element properties for the video.

The PageElementProperties.size property is optional. If you don't specify a size, a default size is chosen by the server.

The PageElementProperties.transform property is optional. The transform must not have shear components. If you don't specify a transform, the video will be placed at the top left corner of the page.

enum (Source)

The video source.

string

The video source's unique identifier for this video.

e.g. For YouTube video https://www.youtube.com/watch?v=7U3axjORYZ0, the ID is 7U3axjORYZ0. For a Google Drive video https://drive.google.com/file/d/1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q the ID is 1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q.

To access a Google Drive video file, you might need to add a resource key to the HTTP header for a subset of old files. For more information, see Access link-shared files using resource keys.

{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "spreadsheetId": string,
  "chartId": integer,
  "linkingMode": enum (LinkingMode)
}

string

A user-supplied object ID.

If specified, the ID must be unique among all pages and page elements in the presentation. The ID should start with a word character [a-zA-Z0-9_] and then followed by any number of the following characters [a-zA-Z0-9_-:]. The length of the ID should not be less than 5 or greater than 50. If empty, a unique identifier will be generated.

object (PageElementProperties)

The element properties for the chart.

When the aspect ratio of the provided size does not match the chart aspect ratio, the chart is scaled and centered with respect to the size in order to maintain aspect ratio. The provided transform is applied after this operation.

string

The ID of the Google Sheets spreadsheet that contains the chart.

You might need to add a resource key to the HTTP header for a subset of old files. For more information, see Access link-shared files using resource keys.

integer

The ID of the specific chart in the Google Sheets spreadsheet.

enum (LinkingMode)

The mode with which the chart is linked to the source spreadsheet. When not specified, the chart will be an image that is not linked.

{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "lineCategory": enum (Category),
  "category": enum (LineCategory)
}

string

A user-supplied object ID.

If you specify an ID, it must be unique among all pages and page elements in the presentation. The ID must start with an alphanumeric character or an underscore (matches regex [a-zA-Z0-9_]); remaining characters may include those as well as a hyphen or colon (matches regex [a-zA-Z0-9_-:]). The length of the ID must not be less than 5 or greater than 50.

If you don't specify an ID, a unique one is generated.

object (PageElementProperties)

The element properties for the line.

enum (Category)

The category of the line to be created.

Deprecated : use category instead.

The exact line type created is determined based on the category and how it's routed to connect to other page elements.

If you specify both a category and a lineCategory, the category takes precedence.

enum (LineCategory)

The category of the line to be created.

The exact line type created is determined based on the category and how it's routed to connect to other page elements.

If you specify both a category and a lineCategory, the category takes precedence.

If you do not specify a value for category, but specify a value for lineCategory, then the specified lineCategory value is used.

If you do not specify either, then STRAIGHT is used.

{
  "objectId": string
}

string

The object ID of the chart to refresh.

{
  "objectId": string,
  "shapeProperties": {
    object (ShapeProperties)
  },
  "fields": string
}

string

The object ID of the shape the updates are applied to.

object (ShapeProperties)

The shape properties to update.

string (FieldMask format)

The fields that should be updated.

At least one field must be specified. The root shapeProperties is implied and should not be specified. A single "*" can be used as short-hand for listing every field.

For example to update the shape background solid fill color, set fields to "shapeBackgroundFill.solidFill.color".

To reset a property to its default value, include its field name in the field mask but leave the field itself unset.

{
  "objectId": string,
  "imageProperties": {
    object (ImageProperties)
  },
  "fields": string
}

string

The object ID of the image the updates are applied to.

object (ImageProperties)

The image properties to update.

string (FieldMask format)

The fields that should be updated.

At least one field must be specified. The root imageProperties is implied and should not be specified. A single "*" can be used as short-hand for listing every field.

For example to update the image outline color, set fields to "outline.outlineFill.solidFill.color".

To reset a property to its default value, include its field name in the field mask but leave the field itself unset.

{
  "objectId": string,
  "videoProperties": {
    object (VideoProperties)
  },
  "fields": string
}

string

The object ID of the video the updates are applied to.

object (VideoProperties)

The video properties to update.

string (FieldMask format)

The fields that should be updated.

At least one field must be specified. The root videoProperties is implied and should not be specified. A single "*" can be used as short-hand for listing every field.

For example to update the video outline color, set fields to "outline.outlineFill.solidFill.color".

To reset a property to its default value, include its field name in the field mask but leave the field itself unset.

{
  "objectId": string,
  "pageProperties": {
    object (PageProperties)
  },
  "fields": string
}

string

The object ID of the page the update is applied to.

object (PageProperties)

The page properties to update.

string (FieldMask format)

The fields that should be updated.

At least one field must be specified. The root pageProperties is implied and should not be specified. A single "*" can be used as short-hand for listing every field.

For example to update the page background solid fill color, set fields to "pageBackgroundFill.solidFill.color".

To reset a property to its default value, include its field name in the field mask but leave the field itself unset.

{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  },
  "tableCellProperties": {
    object (TableCellProperties)
  },
  "fields": string
}

string

The object ID of the table.

object (TableRange)

The table range representing the subset of the table to which the updates are applied. If a table range is not specified, the updates will apply to the entire table.

object (TableCellProperties)

The table cell properties to update.

string (FieldMask format)

The fields that should be updated.

At least one field must be specified. The root tableCellProperties is implied and should not be specified. A single "*" can be used as short-hand for listing every field.

For example to update the table cell background solid fill color, set fields to "tableCellBackgroundFill.solidFill.color".

To reset a property to its default value, include its field name in the field mask but leave the field itself unset.

{
  "location": {
    object (TableCellLocation)
  },
  "rowSpan": integer,
  "columnSpan": integer
}

object (TableCellLocation)

The starting location of the table range.

integer

The row span of the table range.

integer

The column span of the table range.

{
  "objectId": string,
  "lineProperties": {
    object (LineProperties)
  },
  "fields": string
}

string

The object ID of the line the update is applied to.

object (LineProperties)

The line properties to update.

string (FieldMask format)

The fields that should be updated.

At least one field must be specified. The root lineProperties is implied and should not be specified. A single "*" can be used as short-hand for listing every field.

For example to update the line solid fill color, set fields to "lineFill.solidFill.color".

To reset a property to its default value, include its field name in the field mask but leave the field itself unset.

{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  },
  "bulletPreset": enum (BulletGlyphPreset)
}

string

The object ID of the shape or table containing the text to add bullets to.

object (TableCellLocation)

The optional table cell location if the text to be modified is in a table cell. If present, the objectId must refer to a table.

object (Range)

The range of text to apply the bullet presets to, based on TextElement indexes.

enum (BulletGlyphPreset)

The kinds of bullet glyphs to be used. Defaults to the BULLET_DISC_CIRCLE_SQUARE preset.

{
  "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.
}

enum (ReplaceMethod)

The replace method.

Deprecated : use imageReplaceMethod instead.

If you specify both a replaceMethod and an imageReplaceMethod, the imageReplaceMethod takes precedence.

enum (ImageReplaceMethod)

The image replace method.

If you specify both a replaceMethod and an imageReplaceMethod, the imageReplaceMethod takes precedence.

If you do not specify a value for imageReplaceMethod, but specify a value for replaceMethod, then the specified replaceMethod value is used.

If you do not specify either, then CENTER_INSIDE is used.

string

If non-empty, limits the matches to page elements only on the given pages.

Returns a 400 bad request error if given the page object ID of a notes page or a notes master, or if a page with that object ID doesn't exist in the presentation.

object (SubstringMatchCriteria)

If set, this request will replace all of the shapes that contain the given text.

string

The image URL.

The image is fetched once at insertion time and a copy is stored for display inside the presentation. Images must be less than 50MB in size, cannot exceed 25 megapixels, and must be in one of PNG, JPEG, or GIF format.

The provided URL can be at most 2 kB in length. The URL itself is saved with the image, and exposed via the Image.source_url field.

{
  "objectId": string,
  "objectIds": {
    string: string,
    ...
  }
}

string

The ID of the object to duplicate.

map (key: string, value: string)

The object being duplicated may contain other objects, for example when duplicating a slide or a group page element. This map defines how the IDs of duplicated objects are generated: the keys are the IDs of the original objects and its values are the IDs that will be assigned to the corresponding duplicate object. The ID of the source object's duplicate may be specified in this map as well, using the same value of the objectId field as a key and the newly desired ID as the value.

All keys must correspond to existing IDs in the presentation. All values must be unique in the presentation and must start with an alphanumeric character or an underscore (matches regex [a-zA-Z0-9_]); remaining characters may include those as well as a hyphen or colon (matches regex [a-zA-Z0-9_-:]). The length of the new ID must not be less than 5 or greater than 50.

If any IDs of source objects are omitted from the map, a new random ID will be assigned. If the map is empty or unset, all duplicate objects will receive a new random ID.

{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "style": {
    object (TextStyle)
  },
  "textRange": {
    object (Range)
  },
  "fields": string
}

string

The object ID of the shape or table with the text to be styled.

object (TableCellLocation)

The location of the cell in the table containing the text to style. If objectId refers to a table, cellLocation must have a value. Otherwise, it must not.

object (TextStyle)

The style(s) to set on the text.

If the value for a particular style matches that of the parent, that style will be set to inherit.

Certain text style changes may cause other changes meant to mirror the behavior of the Slides editor. See the documentation of TextStyle for more information.

object (Range)

The range of text to style.

The range may be extended to include adjacent newlines.

If the range fully contains a paragraph belonging to a list, the paragraph's bullet is also updated with the matching text style.

string (FieldMask format)

The fields that should be updated.

At least one field must be specified. The root style is implied and should not be specified. A single "*" can be used as short-hand for listing every field.

For example, to update the text style to bold, set fields to "bold".

To reset a property to its default value, include its field name in the field mask but leave the field itself unset.

{
  "containsText": {
    object (SubstringMatchCriteria)
  },
  "spreadsheetId": string,
  "chartId": integer,
  "linkingMode": enum (LinkingMode),
  "pageObjectIds": [
    string
  ]
}

object (SubstringMatchCriteria)

The criteria that the shapes must match in order to be replaced. The request will replace all of the shapes that contain the given text.

string

The ID of the Google Sheets spreadsheet that contains the chart.

integer

The ID of the specific chart in the Google Sheets spreadsheet.

enum (LinkingMode)

The mode with which the chart is linked to the source spreadsheet. When not specified, the chart will be an image that is not linked.

string

If non-empty, limits the matches to page elements only on the given pages.

Returns a 400 bad request error if given the page object ID of a notes page or a notes master, or if a page with that object ID doesn't exist in the presentation.

{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  }
}

string

The object ID of the shape or table containing the text to delete bullets from.

object (TableCellLocation)

The optional table cell location if the text to be modified is in a table cell. If present, the objectId must refer to a table.

object (Range)

The range of text to delete bullets from, based on TextElement indexes.

{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "style": {
    object (ParagraphStyle)
  },
  "textRange": {
    object (Range)
  },
  "fields": string
}

string

The object ID of the shape or table with the text to be styled.

object (TableCellLocation)

The location of the cell in the table containing the paragraph(s) to style. If objectId refers to a table, cellLocation must have a value. Otherwise, it must not.

object (ParagraphStyle)

The paragraph's style.

object (Range)

The range of text containing the paragraph(s) to style.

string (FieldMask format)

The fields that should be updated.

At least one field must be specified. The root style is implied and should not be specified. A single "*" can be used as short-hand for listing every field.

For example, to update the paragraph alignment, set fields to "alignment".

To reset a property to its default value, include its field name in the field mask but leave the field itself unset.

{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  },
  "borderPosition": enum (BorderPosition),
  "tableBorderProperties": {
    object (TableBorderProperties)
  },
  "fields": string
}

string

The object ID of the table.

object (TableRange)

The table range representing the subset of the table to which the updates are applied. If a table range is not specified, the updates will apply to the entire table.

enum (BorderPosition)

The border position in the table range the updates should apply to. If a border position is not specified, the updates will apply to all borders in the table range.

object (TableBorderProperties)

The table border properties to update.

string (FieldMask format)

The fields that should be updated.

At least one field must be specified. The root tableBorderProperties is implied and should not be specified. A single "*" can be used as short-hand for listing every field.

For example to update the table border solid fill color, set fields to "tableBorderFill.solidFill.color".

To reset a property to its default value, include its field name in the field mask but leave the field itself unset.

{
  "objectId": string,
  "columnIndices": [
    integer
  ],
  "tableColumnProperties": {
    object (TableColumnProperties)
  },
  "fields": string
}

string

The object ID of the table.

integer

The list of zero-based indices specifying which columns to update. If no indices are provided, all columns in the table will be updated.

object (TableColumnProperties)

The table column properties to update.

If the value of tableColumnProperties#columnWidth in the request is less than 406,400 EMU (32 points), a 400 bad request error is returned.

string (FieldMask format)

The fields that should be updated.

At least one field must be specified. The root tableColumnProperties is implied and should not be specified. A single "*" can be used as short-hand for listing every field.

For example to update the column width, set fields to "columnWidth".

If '"columnWidth"' is included in the field mask but the property is left unset, the column width will default to 406,400 EMU (32 points).

{
  "objectId": string,
  "rowIndices": [
    integer
  ],
  "tableRowProperties": {
    object (TableRowProperties)
  },
  "fields": string
}

string

The object ID of the table.

integer

The list of zero-based indices specifying which rows to update. If no indices are provided, all rows in the table will be updated.

object (TableRowProperties)

The table row properties to update.

string (FieldMask format)

The fields that should be updated.

At least one field must be specified. The root tableRowProperties is implied and should not be specified. A single "*" can be used as short-hand for listing every field.

For example to update the minimum row height, set fields to "minRowHeight".

If '"minRowHeight"' is included in the field mask but the property is left unset, the minimum row height will default to 0.

{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  }
}

string

The object ID of the table.

object (TableRange)

The table range specifying which cells of the table to merge.

Any text in the cells being merged will be concatenated and stored in the upper-left ("head") cell of the range. If the range is non-rectangular (which can occur in some cases where the range covers cells that are already merged), a 400 bad request error is returned.

{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  }
}

string

The object ID of the table.

object (TableRange)

The table range specifying which cells of the table to unmerge.

All merged cells in this range will be unmerged, and cells that are already unmerged will not be affected. If the range has no merged cells, the request will do nothing. If there is text in any of the merged cells, the text will remain in the upper-left ("head") cell of the resulting block of unmerged cells.

{
  "groupObjectId": string,
  "childrenObjectIds": [
    string
  ]
}

string

A user-supplied object ID for the group to be created.

If you specify an ID, it must be unique among all pages and page elements in the presentation. The ID must start with an alphanumeric character or an underscore (matches regex [a-zA-Z0-9_]); remaining characters may include those as well as a hyphen or colon (matches regex [a-zA-Z0-9_-:]). The length of the ID must not be less than 5 or greater than 50.

If you don't specify an ID, a unique one is generated.

string

The object IDs of the objects to group.

Only page elements can be grouped. There should be at least two page elements on the same page that are not already in another group. Some page elements, such as videos, tables and placeholders cannot be grouped.

{
  "objectIds": [
    string
  ]
}

string

The object IDs of the objects to ungroup.

Only groups that are not inside other groups can be ungrouped. All the groups should be on the same page. The group itself is deleted. The visual sizes and positions of all the children are preserved.

{
  "objectId": string,
  "title": string,
  "description": string
}

string

The object ID of the page element the updates are applied to.

string

The updated alt text title of the page element. If unset the existing value will be maintained. The title is exposed to screen readers and other accessibility interfaces. Only use human readable values related to the content of the page element.

string

The updated alt text description of the page element. If unset the existing value will be maintained. The description is exposed to screen readers and other accessibility interfaces. Only use human readable values related to the content of the page element.

{
  "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.
}

string

The ID of the existing image that will be replaced. The ID can be retrieved from the response of a get request.

enum (ImageReplaceMethod)

The replacement method.

string

The image URL.

The image is fetched once at insertion time and a copy is stored for display inside the presentation. Images must be less than 50MB, cannot exceed 25 megapixels, and must be in PNG, JPEG, or GIF format.

The provided URL can't surpass 2 KB in length. The URL is saved with the image, and exposed through the Image.source_url field.

{
  "objectId": string,
  "slideProperties": {
    object (SlideProperties)
  },
  "fields": string
}

string

The object ID of the slide the update is applied to.

object (SlideProperties)

The slide properties to update.

string (FieldMask format)

The fields that should be updated.

At least one field must be specified. The root 'slideProperties' is implied and should not be specified. A single "*" can be used as short-hand for listing every field.

For example to update whether a slide is skipped, set fields to "isSkipped".

To reset a property to its default value, include its field name in the field mask but leave the field itself unset.

{
  "pageElementObjectIds": [
    string
  ],
  "operation": enum (ZOrderOperation)
}

string

The object IDs of the page elements to update.

All the page elements must be on the same page and must not be grouped.

enum (ZOrderOperation)

The Z-order operation to apply on the page elements.

When applying the operation on multiple page elements, the relative Z-orders within these page elements before the operation is maintained.

{
  "objectId": string,
  "lineCategory": enum (LineCategory)
}

string

The object ID of the line the update is applied to.

Only a line with a category indicating it is a "connector" can be updated.

The line may be rerouted after updating its category.

enum (LineCategory)

The line category to update to.

The exact line type is determined based on the category to update to and how it's routed to connect to other page elements.

{
  "objectId": string
}

string

The object ID of the line to reroute.

Only a line with a category indicating it is a "connector" can be rerouted. The start and end connections of the line must be on different page elements.