Requests

Solicitação

Um único tipo de atualização a ser aplicado a uma apresentação.

Representação 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.
}
Campos
Campo de união kind. O tipo de atualização. Exatamente um campo é obrigatório. kind pode ser apenas um dos seguintes:
createSlide

object (CreateSlideRequest)

Cria um novo slide.

createShape

object (CreateShapeRequest)

Cria uma nova forma.

createTable

object (CreateTableRequest)

Cria uma nova tabela.

insertText

object (InsertTextRequest)

Insere texto em uma forma ou célula de tabela.

insertTableRows

object (InsertTableRowsRequest)

Insere linhas em uma tabela.

insertTableColumns

object (InsertTableColumnsRequest)

Insere colunas em uma tabela.

deleteTableRow

object (DeleteTableRowRequest)

Exclui uma linha de uma tabela.

deleteTableColumn

object (DeleteTableColumnRequest)

Exclui uma coluna de uma tabela.

replaceAllText

object (ReplaceAllTextRequest)

Substitui todas as instâncias do texto especificado.

deleteObject

object (DeleteObjectRequest)

Exclui uma página ou um elemento da página da apresentação.

updatePageElementTransform

object (UpdatePageElementTransformRequest)

Atualiza a transformação de um elemento da página.

updateSlidesPosition

object (UpdateSlidesPositionRequest)

Atualiza a posição de um conjunto de slides na apresentação.

deleteText

object (DeleteTextRequest)

Exclui texto de uma forma ou célula de tabela.

createImage

object (CreateImageRequest)

Cria uma imagem.

createVideo

object (CreateVideoRequest)

Cria um vídeo.

createSheetsChart

object (CreateSheetsChartRequest)

Cria um gráfico incorporado das Planilhas Google.

createLine

object (CreateLineRequest)

Cria uma linha.

refreshSheetsChart

object (RefreshSheetsChartRequest)

Atualiza um gráfico das Planilhas Google.

updateShapeProperties

object (UpdateShapePropertiesRequest)

Atualiza as propriedades de um Shape.

updateImageProperties

object (UpdateImagePropertiesRequest)

Atualiza as propriedades de um Image.

updateVideoProperties

object (UpdateVideoPropertiesRequest)

Atualiza as propriedades de um Video.

updatePageProperties

object (UpdatePagePropertiesRequest)

Atualiza as propriedades de um Page.

updateTableCellProperties

object (UpdateTableCellPropertiesRequest)

Atualiza as propriedades de um TableCell.

updateLineProperties

object (UpdateLinePropertiesRequest)

Atualiza as propriedades de um Line.

createParagraphBullets

object (CreateParagraphBulletsRequest)

Cria marcadores para parágrafos.

replaceAllShapesWithImage

object (ReplaceAllShapesWithImageRequest)

Substitui todas as formas que correspondem a alguns critérios por uma imagem.

duplicateObject

object (DuplicateObjectRequest)

Duplica um slide ou elemento da página.

updateTextStyle

object (UpdateTextStyleRequest)

Atualiza o estilo do texto em um Shape ou Table.

replaceAllShapesWithSheetsChart

object (ReplaceAllShapesWithSheetsChartRequest)

Substitui todas as formas que correspondem a alguns critérios por um gráfico das Planilhas Google.

deleteParagraphBullets

object (DeleteParagraphBulletsRequest)

Exclui marcadores de parágrafos.

updateParagraphStyle

object (UpdateParagraphStyleRequest)

Atualiza o estilo dos parágrafos em um Shape ou Table.

updateTableBorderProperties

object (UpdateTableBorderPropertiesRequest)

Atualiza as propriedades das bordas da tabela em um Table.

updateTableColumnProperties

object (UpdateTableColumnPropertiesRequest)

Atualiza as propriedades de uma coluna Table.

updateTableRowProperties

object (UpdateTableRowPropertiesRequest)

Atualiza as propriedades de uma linha Table.

mergeTableCells

object (MergeTableCellsRequest)

Mescla células em um Table.

unmergeTableCells

object (UnmergeTableCellsRequest)

Desfaz a mesclagem de células em um Table.

groupObjects

object (GroupObjectsRequest)

Agrupar objetos, como elementos de página.

ungroupObjects

object (UngroupObjectsRequest)

Desagrupa objetos, como groups.

updatePageElementAltText

object (UpdatePageElementAltTextRequest)

Atualiza o título e/ou a descrição do texto alternativo de um page element.

replaceImage

object (ReplaceImageRequest)

Substitui uma imagem por outra.

updateSlideProperties

object (UpdateSlidePropertiesRequest)

Atualiza as propriedades de um slide

updatePageElementsZOrder

object (UpdatePageElementsZOrderRequest)

Atualiza a ordem Z de page elements.

updateLineCategory

object (UpdateLineCategoryRequest)

Atualiza a categoria de um line.

rerouteLine

object (RerouteLineRequest)

Redireciona um line para que ele seja conectado aos dois sites de conexão mais próximos nos elementos da página conectados.

CreateSlideRequest

Cria um slide.

Representação JSON 
{
  "objectId": string,
  "insertionIndex": integer,
  "slideLayoutReference": {
    object (LayoutReference)
  },
  "placeholderIdMappings": [
    {
      object (LayoutPlaceholderIdMapping)
    }
  ]
}
Campos
objectId

string

Um ID de objeto fornecido pelo usuário.

Se você especificar um ID, ele precisa ser exclusivo entre todas as páginas e elementos da página na apresentação. O ID precisa começar com um caractere alfanumérico ou um sublinhado (corresponde à regex [a-zA-Z0-9_]). Os caracteres restantes podem incluir esses caracteres, além de hífen ou dois-ponto (corresponde à regex [a-zA-Z0-9_-:]). O comprimento do ID precisa ter entre 5 e 50 caracteres.

Se você não especificar um ID, um exclusivo será gerado.

insertionIndex

integer

O índice opcional com base em zero que indica onde inserir os slides.

Se você não especificar um índice, o slide será criado no final.

slideLayoutReference

object (LayoutReference)

Referência de layout do slide a ser inserido, com base no mestre atual, que é uma das seguintes opções:

  • O mestre do índice do slide anterior.
  • O mestre do primeiro slide, se o insertionIndex for zero.
  • O primeiro mestre na apresentação, se não houver slides.

Se o LayoutReference não for encontrado no mestre atual, um erro 400 de solicitação inválida será retornado.

Se você não especificar uma referência de layout, o slide vai usar o layout BLANK predefinido.

placeholderIdMappings[]

object (LayoutPlaceholderIdMapping)

Uma lista opcional de mapeamentos de ID de objeto do placeholder (s) no layout para os marcadores de posição criados no slide do layout especificado. Só pode ser usado quando slideLayoutReference é especificado.

LayoutReference

Referência do layout do slide. Isso pode se referir a:

  • Um layout predefinido
  • Um dos layouts da apresentação.
Representação 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.
}
Campos
Campo de união kind. O tipo de LayoutReference. kind pode ser apenas um dos seguintes:
predefinedLayout

enum (PredefinedLayout)

Layout predefinido.

layoutId

string

ID do layout: o ID do objeto de um dos layouts na apresentação.

PredefinedLayout

Tipos de layout predefinidos. Esses são layouts comuns em apresentações. No entanto, não há garantia de que esses layouts estejam presentes no mestre atual, porque eles podem ter sido excluídos ou não fazer parte do tema usado. Além disso, os marcadores de posição em cada layout podem ter sido alterados.

Enums
PREDEFINED_LAYOUT_UNSPECIFIED Layout não especificado.
BLANK Layout em branco, sem marcadores de posição.
CAPTION_ONLY Layout com uma legenda na parte de baixo.
TITLE Layout com um título e um subtítulo.
TITLE_AND_BODY Layout com título e corpo.
TITLE_AND_TWO_COLUMNS Layout com um título e duas colunas.
TITLE_ONLY Layout com apenas um título.
SECTION_HEADER Layout com um título de seção.
SECTION_TITLE_AND_DESCRIPTION Layout com um título e um subtítulo de um lado e uma descrição do outro.
ONE_COLUMN_TEXT Layout com um título e um corpo, organizados em uma única coluna.
MAIN_POINT Layout com um ponto principal.
BIG_NUMBER Layout com um título de número grande.

LayoutPlaceholderIdMapping

O mapeamento de ID especificado pelo usuário para um marcador de posição que será criado em um slide de um layout especificado.

Representação 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.
}
Campos
objectId

string

Um ID de objeto fornecido pelo usuário para o marcador de posição identificado acima que será criado em um slide.

Se você especificar um ID, ele precisa ser exclusivo entre todas as páginas e elementos da página na apresentação. O ID precisa começar com um caractere alfanumérico ou um sublinhado (corresponde à regex [a-zA-Z0-9_]). Os caracteres restantes podem incluir esses caracteres, bem como um hífen ou dois-ponto (corresponde à regex [a-zA-Z0-9_-:]). O comprimento do ID não pode ser menor que 5 nem maior que 50.

Se você não especificar um ID, um exclusivo será gerado.

Campo de união kind. O tipo para identificar um marcador de posição em um layout. kind pode ser apenas um dos seguintes:
layoutPlaceholder

object (Placeholder)

O marcador de posição em um layout que será aplicado a um slide. Apenas type e index são necessários. Por exemplo, um layout TITLE_AND_BODY predefinido geralmente tem um marcador de posição TITLE com índice 0 e um marcador de posição BODY com índice 0.

layoutPlaceholderObjectId

string

O ID do objeto do marcador de posição em um layout que será aplicado a um slide.

CreateShapeRequest

Cria uma nova forma.

Representação JSON 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "shapeType": enum (Type)
}
Campos
objectId

string

Um ID de objeto fornecido pelo usuário.

Se você especificar um ID, ele precisa ser exclusivo entre todas as páginas e elementos da página na apresentação. O ID precisa começar com um caractere alfanumérico ou um sublinhado (corresponde à regex [a-zA-Z0-9_]). Os caracteres restantes podem incluir esses caracteres, além de hífen ou dois-ponto (corresponde à regex [a-zA-Z0-9_-:]). O comprimento do ID não pode ser menor que 5 nem maior que 50. Se estiver vazio, um identificador exclusivo será gerado.

elementProperties

object (PageElementProperties)

As propriedades do elemento para a forma.

shapeType

enum (Type)

O tipo de forma.

PageElementProperties

Propriedades comuns de um elemento da página.

Observação: quando você cria uma PageElement pela primeira vez, a API pode modificar os valores de size e transform, mas o tamanho visual não muda.

Representação JSON 
{
  "pageObjectId": string,
  "size": {
    object (Size)
  },
  "transform": {
    object (AffineTransform)
  }
}
Campos
pageObjectId

string

O ID do objeto da página em que o elemento está localizado.

size

object (Size)

O tamanho do elemento.

transform

object (AffineTransform)

A transformação do elemento.

CreateTableRequest

Cria uma nova tabela.

Representação JSON 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "rows": integer,
  "columns": integer
}
Campos
objectId

string

Um ID de objeto fornecido pelo usuário.

Se você especificar um ID, ele precisa ser exclusivo entre todas as páginas e elementos da página na apresentação. O ID precisa começar com um caractere alfanumérico ou um sublinhado (corresponde à regex [a-zA-Z0-9_]). Os caracteres restantes podem incluir esses caracteres, além de hífen ou dois-ponto (corresponde à regex [a-zA-Z0-9_-:]). O comprimento do ID não pode ser menor que 5 nem maior que 50.

Se você não especificar um ID, um exclusivo será gerado.

elementProperties

object (PageElementProperties)

As propriedades do elemento para a tabela.

A tabela será criada no tamanho fornecido, sujeito a um tamanho mínimo. Se nenhum tamanho for fornecido, a tabela será dimensionada automaticamente.

As transformações de tabela precisam ter uma escala de 1 e nenhum componente de cisalhamento. Se nenhuma transformação for fornecida, a tabela será centralizada na página.

rows

integer

Número de linhas na tabela.

columns

integer

Número de colunas na tabela.

InsertTextRequest

Insere texto em uma forma ou célula de tabela.

Representação JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "text": string,
  "insertionIndex": integer
}
Campos
objectId

string

O ID do objeto da forma ou tabela em que o texto será inserido.

cellLocation

object (TableCellLocation)

O local opcional da célula da tabela, se o texto for inserido em uma célula da tabela. Se presente, o objectId precisa se referir a uma tabela.

text

string

O texto a ser inserido.

Inserir um caractere de nova linha cria implicitamente um novo ParagraphMarker nesse índice. O estilo do novo parágrafo será copiado do parágrafo no índice de inserção atual, incluindo listas e marcadores.

Os estilos de texto para o texto inserido são determinados automaticamente, geralmente preservando o estilo do texto vizinho. Na maioria dos casos, o texto será adicionado ao TextRun que existe no índice de inserção.

Alguns caracteres de controle (U+0000-U+0008, U+000C-U+001F) e caracteres da área de uso privado do plano multilíngue básico Unicode (U+E000-U+F8FF) serão removidos do texto inserido.

insertionIndex

integer

O índice em que o texto será inserido, em unidades de código Unicode, com base nos índices TextElement.

O índice é baseado em zero e é calculado a partir do início da string. O índice pode ser ajustado para evitar inserções dentro de clusters de grafemas Unicode. Nesses casos, o texto é inserido imediatamente após o cluster de grafemas.

InsertTableRowsRequest

Insere linhas em uma tabela.

Representação JSON 
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "insertBelow": boolean,
  "number": integer
}
Campos
tableObjectId

string

A tabela em que as linhas serão inseridas.

cellLocation

object (