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. É necessário especificar exatamente um campo. 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 de 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 do Google Planilhas.

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 de 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 de 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)

Agrupa objetos, como elementos da 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 nos dois sites de conexão mais próximos nos elementos da página conectada.

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 precisará ser exclusivo entre todas as páginas e elementos da 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, além de um hífen ou dois pontos (corresponde à regex [a-zA-Z0-9_-:]). O ID precisa ter entre 5 e 50 caracteres, inclusive.

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 modelo atual, que é um dos seguintes:

  • O mestre do índice do slide anterior.
  • O modelo 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 master 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 com base no layout especificado. Só pode ser usado quando slideLayoutReference é especificado.

LayoutReference

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

  • Um layout predefinido
  • Um dos layouts na 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 modelo atual, já que 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.

Tipos enumerados
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 precisará ser exclusivo entre todas as páginas e elementos da 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, além de um hífen ou dois pontos (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 precisará ser exclusivo entre todas as páginas e elementos da 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, além de um hífen ou dois pontos (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 um PageElement, 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 precisará ser exclusivo entre todas as páginas e elementos da 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, além de um hífen ou dois pontos (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 não podem ter componentes 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. Se presente, o objectId precisa se referir a uma tabela.

text

string

O texto a ser inserido.

A inserção de 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 do 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 do 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 desde o início da string. O índice pode ser ajustado para evitar inserções em clusters de grafemas Unicode. Nesses casos, o texto será 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 (TableCellLocation)

A localização da célula da tabela de referência de onde as linhas serão inseridas.

Uma nova linha será inserida acima (ou abaixo) da linha em que a célula de referência está. Se a célula de referência for uma célula mesclada, uma nova linha será inserida acima (ou abaixo) dela.

insertBelow

boolean

Se novas linhas devem ser inseridas abaixo do local da célula de referência.

  • True : insere abaixo da célula.
  • False : insere acima da célula.
number

integer

O número de linhas a serem inseridas. Máximo de 20 por solicitação.

InsertTableColumnsRequest

Insere colunas em uma tabela.

As outras colunas da tabela serão redimensionadas para se ajustar à nova.

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

string

A tabela em que as colunas serão inseridas.

cellLocation

object (TableCellLocation)

A localização da célula de referência da tabela em que as colunas serão inseridas.

Uma nova coluna será inserida à esquerda (ou à direita) da coluna em que a célula de referência está. Se a célula de referência for uma célula mesclada, uma nova coluna será inserida à esquerda (ou à direita) da célula mesclada.

insertRight

boolean

Se novas colunas devem ser inseridas à direita do local da célula de referência.

  • True : insere à direita.
  • False : inserir à esquerda.
number

integer

O número de colunas a serem inseridas. Máximo de 20 por solicitação.

DeleteTableRowRequest

Exclui uma linha de uma tabela.

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

string

A tabela de que as linhas serão excluídas.

cellLocation

object (TableCellLocation)

O local da célula da tabela de referência de onde uma linha será excluída.

A linha em que a célula está será excluída. Se for uma célula mesclada, várias linhas serão excluídas. Se não houver mais linhas na tabela após essa exclusão, toda a tabela será excluída.

DeleteTableColumnRequest

Exclui uma coluna de uma tabela.

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

string

A tabela de que as colunas serão excluídas.

cellLocation

object (TableCellLocation)

A localização da célula da tabela de referência de onde uma coluna será excluída.

A coluna que essa célula abrange será excluída. Se for uma célula mesclada, várias colunas serão excluídas. Se nenhuma coluna permanecer na tabela após essa exclusão, toda a tabela será excluída.

ReplaceAllTextRequest

Substitui todas as instâncias de texto que correspondem a um critério por replace text.

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

string

O texto que vai substituir o texto correspondente.

pageObjectIds[]

string

Se não estiver vazio, limita as correspondências a elementos da página apenas nas páginas especificadas.

Retorna um erro 400 de solicitação incorreta se for fornecido o ID do objeto de página de um notes master ou se uma página com esse ID de objeto não existir na apresentação.

Campo de união criteria. Os critérios usados para corresponder ao texto a ser substituído. criteria pode ser apenas um dos seguintes:
containsText

object (SubstringMatchCriteria)

Encontra texto em uma forma que corresponde a essa substring.

SubstringMatchCriteria

Um critério que corresponde a uma string de texto específica em uma forma ou tabela.

Representação JSON 
{
  "text": string,
  "matchCase": boolean,
  "searchByRegex": boolean
}
Campos
text

string

O texto a ser pesquisado na forma ou tabela.

matchCase

boolean

Indica se a pesquisa deve diferenciar maiúsculas e minúsculas:

  • True : a pesquisa diferencia maiúsculas de minúsculas.
  • False : a pesquisa não diferencia maiúsculas de minúsculas.
searchByRegex

boolean

Opcional. Verdadeiro se o valor de pesquisa deve ser tratado como uma expressão regular. Todas as barras invertidas no padrão precisam ter escape.

  • True : o texto de pesquisa é tratado como uma expressão regular.
  • False : o texto de pesquisa é tratado como uma substring para correspondência.

DeleteObjectRequest

Exclui um objeto, seja pages ou page elements, da apresentação.

Representação JSON 
{
  "objectId": string
}
Campos
objectId

string

O ID do objeto da página ou do elemento da página a ser excluído.

Se, após uma operação de exclusão, um group contiver apenas um ou nenhum elemento de página, o grupo também será excluído.

Se um marcador de posição for excluído em um layout, todos os marcadores de posição vazios que herdam dele também serão excluídos.

UpdatePageElementTransformRequest

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

Atualizar a transformação de um grupo muda a transformação absoluta dos elementos da página nesse grupo, o que pode alterar a aparência visual deles. Consulte a documentação de PageElement.transform para saber mais.

Representação JSON 
{
  "objectId": string,
  "transform": {
    object (AffineTransform)
  },
  "applyMode": enum (ApplyMode)
}
Campos
objectId

string

O ID do objeto do elemento da página a ser atualizado.

transform

object (AffineTransform)

A matriz de transformação de entrada usada para atualizar o elemento da página.

applyMode

enum (ApplyMode)

O modo de aplicação da atualização de transformação.

ApplyMode

Os modos de aplicação da atualização de transformação.

Tipos enumerados
APPLY_MODE_UNSPECIFIED Modo não especificado.
RELATIVE Aplica a nova matriz AffineTransform à matriz atual e substitui a atual pela concatenação resultante.
ABSOLUTE Substitui a matriz AffineTransform atual pela nova.

UpdateSlidesPositionRequest

Atualiza a posição dos slides na apresentação.

Representação JSON 
{
  "slideObjectIds": [
    string
  ],
  "insertionIndex": integer
}
Campos
slideObjectIds[]

string

Os IDs dos slides na apresentação que precisam ser movidos. Os slides nesta lista precisam estar na ordem da apresentação, sem duplicatas.

insertionIndex

integer

O índice em que os slides devem ser inseridos, com base na organização deles antes da movimentação. Precisa estar entre zero e o número de slides na apresentação, incluindo esses dois valores.

DeleteTextRequest

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

Representação JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  }
}
Campos
objectId

string

O ID do objeto da forma ou tabela de onde o texto será excluído.

cellLocation

object (TableCellLocation)

A localização opcional da célula da tabela se o texto for excluído de uma célula da tabela. Se presente, o objectId precisa se referir a uma tabela.

textRange

object (Range)

O intervalo de texto a ser excluído, com base nos índices TextElement.

Sempre há um caractere de nova linha implícito no final do texto de uma forma ou célula de tabela que não pode ser excluído. Range.Type.ALL vai usar os limites corretos, mas é preciso ter cuidado ao especificar limites explícitos para tipos de intervalo FROM_START_INDEX e FIXED_RANGE. Por exemplo, se o texto for "ABC", seguido por uma nova linha implícita, o valor máximo será 2 para textRange.start_index e 3 para textRange.end_index.

Excluir texto que cruza um limite de parágrafo pode resultar em mudanças nos estilos e listas de parágrafos, já que os dois parágrafos são mesclados.

Intervalos que incluem apenas uma unidade de código de um par substituto são expandidos para incluir as duas unidades.

Intervalo

Especifica um intervalo contíguo de uma coleção indexada, como caracteres em um texto.

Representação JSON 
{
  "startIndex": integer,
  "endIndex": integer,
  "type": enum (Type)
}
Campos
startIndex

integer

O índice opcional baseado em zero do início da coleção. Obrigatório para intervalos de FIXED_RANGE e FROM_START_INDEX.

endIndex

integer

O índice opcional baseado em zero do fim da coleção. Obrigatório para intervalos de FIXED_RANGE.

type

enum (Type)

O tipo de intervalo.

Tipo

Os tipos de intervalos.

Tipos enumerados
RANGE_TYPE_UNSPECIFIED Tipo de intervalo não especificado. Esse valor não pode ser usado.
FIXED_RANGE Um período fixo. É preciso especificar startIndex e endIndex.
FROM_START_INDEX Começa o intervalo em startIndex e continua até o final da coleta. O endIndex não pode ser especificado.
ALL Define o intervalo como o comprimento total da coleção. Não é possível especificar startIndex e endIndex.

CreateImageRequest

Cria uma imagem.

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

string

Um ID de objeto fornecido pelo usuário.

Se você especificar um ID, ele precisará ser exclusivo entre todas as páginas e elementos da 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, além de um hífen ou dois pontos (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 imagem.

Quando a proporção do tamanho fornecido não corresponde à proporção da imagem, ela é redimensionada e centralizada em relação ao tamanho para manter a proporção. A transformação fornecida é aplicada após essa operação.

A propriedade PageElementProperties.size é opcional. Se você não especificar o tamanho, o padrão será usado.

A propriedade PageElementProperties.transform é opcional. Se você não especificar uma transformação, a imagem será colocada no canto superior esquerdo da página.

Campo de união image_source. O tipo de origem da imagem. image_source pode ser apenas um dos seguintes:
url

string

O URL da imagem.

A imagem é buscada uma vez no momento da inserção e uma cópia é armazenada para exibição na apresentação. As imagens precisam ter menos de 50 MB, não podem exceder 25 megapixels e precisam estar em um dos formatos PNG, JPEG ou GIF.

O URL fornecido precisa ser acessível publicamente e ter até 2 KB de comprimento. O URL é salvo com a imagem e exposto pelo campo Image.source_url.

CreateVideoRequest

Cria um vídeo.

OBSERVAÇÃO: para criar um vídeo no Google Drive, o app solicitante precisa ter pelo menos um dos escopos do OAuth "drive", "drive.readonly" ou "drive.file".

Representação JSON 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "source": enum (Source),
  "id": string
}
Campos
objectId

string

Um ID de objeto fornecido pelo usuário.

Se você especificar um ID, ele precisará ser exclusivo entre todas as páginas e elementos da 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, além de um hífen ou dois pontos (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 o vídeo.

A propriedade PageElementProperties.size é opcional. Se você não especificar um tamanho, o servidor vai escolher um padrão.

A propriedade PageElementProperties.transform é opcional. A transformação não pode ter componentes de cisalhamento. Se você não especificar uma transformação, o vídeo será colocado no canto superior esquerdo da página.

source

enum (Source)

A fonte do vídeo.

id

string

O identificador exclusivo da origem do vídeo.

Por exemplo, para o vídeo do YouTube https://www.youtube.com/watch?v=7U3axjORYZ0, o ID é 7U3axjORYZ0. Para um vídeo do Google Drive https://drive.google.com/file/d/1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q o ID é 1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q.

Para acessar um arquivo de vídeo do Google Drive, talvez seja necessário adicionar uma chave de recurso ao cabeçalho HTTP de um subconjunto de arquivos antigos. Para mais informações, consulte Acessar arquivos compartilhados por link usando chaves de recursos.

CreateSheetsChartRequest

Cria um gráfico incorporado do Google Planilhas.

OBSERVAÇÃO: para criar gráficos, é necessário ter pelo menos um dos escopos do OAuth "spreadsheets.readonly", "spreadsheets", "drive.readonly", "drive.file" ou "drive".

Representação JSON 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "spreadsheetId": string,
  "chartId": integer,
  "linkingMode": enum (LinkingMode)
}
Campos
objectId

string

Um ID de objeto fornecido pelo usuário.

Se especificado, o ID precisa ser exclusivo entre todas as páginas e elementos de página na apresentação. O ID precisa começar com um caractere de palavra [a-zA-Z0-9_] e ser seguido por qualquer número dos seguintes caracteres [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 o gráfico.

Quando a proporção do tamanho fornecido não corresponde à proporção do gráfico, ele é dimensionado e centralizado em relação ao tamanho para manter a proporção. A transformação fornecida é aplicada após essa operação.

spreadsheetId

string

O ID da planilha Google que contém o gráfico.

Talvez seja necessário adicionar uma chave de recurso ao cabeçalho HTTP para um subconjunto de arquivos antigos. Para mais informações, consulte Acessar arquivos compartilhados por link usando chaves de recursos.

chartId

integer

O ID do gráfico específico na planilha Google.

linkingMode

enum (LinkingMode)

O modo com que o gráfico está vinculado à planilha de origem. Quando não especificado, o gráfico será uma imagem não vinculada.

LinkingMode

O modo com que o gráfico está vinculado à planilha de origem.

Tipos enumerados
NOT_LINKED_IMAGE O gráfico não está associado à planilha de origem e não pode ser atualizado. Um gráfico não vinculado será inserido como uma imagem.
LINKED Ao vincular o gráfico, ele pode ser atualizado, e outros colaboradores vão ver um link para a planilha.

CreateLineRequest

Cria uma linha.

Representação JSON 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "lineCategory": enum (Category),
  "category": enum (LineCategory)
}
Campos
objectId

string

Um ID de objeto fornecido pelo usuário.

Se você especificar um ID, ele precisará ser exclusivo entre todas as páginas e elementos da 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, além de um hífen ou dois pontos (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 linha.

lineCategory
(deprecated)

enum (Category)

A categoria da linha a ser criada.

Descontinuado : use category em vez disso.

O line type exato criado é determinado com base na categoria e em como ele é encaminhado para se conectar a outros elementos da página.

Se você especificar um category e um lineCategory, o category terá precedência.

category

enum (LineCategory)

A categoria da linha a ser criada.

O line type exato criado é determinado com base na categoria e em como ele é encaminhado para se conectar a outros elementos da página.

Se você especificar um category e um lineCategory, o category terá precedência.

Se você não especificar um valor para category, mas especificar um valor para lineCategory, o valor lineCategory especificado será usado.

Se você não especificar nenhum deles, STRAIGHT será usado.

Categoria

As categorias de linha.

Tipos enumerados
STRAIGHT Conectores retos, incluindo o conector reto 1. Essa é a categoria padrão quando nenhuma é especificada.
BENT Conectores tortos, incluindo os conectores 2 a 5.
CURVED Conectores curvados, incluindo os conectores curvados de 2 a 5.

RefreshSheetsChartRequest

Atualiza um gráfico incorporado das Planilhas Google, substituindo-o pela versão mais recente.

OBSERVAÇÃO: para atualizar os gráficos, é necessário ter pelo menos um dos escopos do OAuth "spreadsheets.readonly", "spreadsheets", "drive.readonly" ou "drive".

Representação JSON 
{
  "objectId": string
}
Campos
objectId

string

O ID do objeto do gráfico a ser atualizado.

UpdateShapePropertiesRequest

Atualiza as propriedades de um Shape.

Representação JSON 
{
  "objectId": string,
  "shapeProperties": {
    object (ShapeProperties)
  },
  "fields": string
}
Campos
objectId

string

O ID do objeto da forma a que as atualizações são aplicadas.

shapeProperties

object (ShapeProperties)

As propriedades de forma a serem atualizadas.

fields

string (FieldMask format)

Os campos que precisam ser atualizados.

É necessário especificar pelo menos um campo. A raiz shapeProperties é implícita e não precisa ser especificada. Um único "*" pode ser usado como abreviação para listar todos os campos.

Por exemplo, para atualizar a cor de preenchimento sólido do plano de fundo da forma, defina fields como "shapeBackgroundFill.solidFill.color".

Para redefinir uma propriedade para o valor padrão, inclua o nome do campo na máscara, mas deixe o campo sem definição.

UpdateImagePropertiesRequest

Atualiza as propriedades de um Image.

Representação JSON 
{
  "objectId": string,
  "imageProperties": {
    object (ImageProperties)
  },
  "fields": string
}
Campos
objectId

string

O ID do objeto da imagem a que as atualizações são aplicadas.

imageProperties

object (ImageProperties)

As propriedades da imagem a serem atualizadas.

fields

string (FieldMask format)

Os campos que precisam ser atualizados.

É necessário especificar pelo menos um campo. A raiz imageProperties é implícita e não precisa ser especificada. Um único "*" pode ser usado como abreviação para listar todos os campos.

Por exemplo, para atualizar a cor do contorno da imagem, defina fields como "outline.outlineFill.solidFill.color".

Para redefinir uma propriedade para o valor padrão, inclua o nome do campo na máscara, mas deixe o campo sem definição.

UpdateVideoPropertiesRequest

Atualiza as propriedades de um Video.

Representação JSON 
{
  "objectId": string,
  "videoProperties": {
    object (VideoProperties)
  },
  "fields": string
}
Campos
objectId

string

O ID do objeto do vídeo em que as atualizações são aplicadas.

videoProperties

object (VideoProperties)

As propriedades de vídeo a serem atualizadas.

fields

string (FieldMask format)

Os campos que precisam ser atualizados.

É necessário especificar pelo menos um campo. A raiz videoProperties é implícita e não precisa ser especificada. Um único "*" pode ser usado como abreviação para listar todos os campos.

Por exemplo, para atualizar a cor do contorno do vídeo, defina fields como "outline.outlineFill.solidFill.color".

Para redefinir uma propriedade para o valor padrão, inclua o nome do campo na máscara, mas deixe o campo sem definição.

UpdatePagePropertiesRequest

Atualiza as propriedades de um Page.

Representação JSON 
{
  "objectId": string,
  "pageProperties": {
    object (PageProperties)
  },
  "fields": string
}
Campos
objectId

string

O ID do objeto da página em que a atualização é aplicada.

pageProperties

object (PageProperties)

As propriedades da página a serem atualizadas.

fields

string (FieldMask format)

Os campos que precisam ser atualizados.

É necessário especificar pelo menos um campo. A raiz pageProperties é implícita e não precisa ser especificada. Um único "*" pode ser usado como abreviação para listar todos os campos.

Por exemplo, para atualizar a cor de preenchimento sólido do plano de fundo da página, defina fields como "pageBackgroundFill.solidFill.color".

Para redefinir uma propriedade para o valor padrão, inclua o nome do campo na máscara, mas deixe o campo sem definição.

UpdateTableCellPropertiesRequest

Atualiza as propriedades de um TableCell.

Representação JSON 
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  },
  "tableCellProperties": {
    object (TableCellProperties)
  },
  "fields": string
}
Campos
objectId

string

O ID do objeto da tabela.

tableRange

object (TableRange)

O intervalo da tabela que representa o subconjunto da tabela a que as atualizações são aplicadas. Se um intervalo de tabela não for especificado, as atualizações serão aplicadas à tabela inteira.

tableCellProperties

object (TableCellProperties)

As propriedades da célula da tabela a serem atualizadas.

fields

string (FieldMask format)

Os campos que precisam ser atualizados.

É necessário especificar pelo menos um campo. A raiz tableCellProperties é implícita e não precisa ser especificada. Um único "*" pode ser usado como abreviação para listar todos os campos.

Por exemplo, para atualizar a cor de preenchimento sólido do plano de fundo da célula da tabela, defina fields como "tableCellBackgroundFill.solidFill.color".

Para redefinir uma propriedade para o valor padrão, inclua o nome do campo na máscara, mas deixe o campo sem definição.

TableRange

Um intervalo de tabela representa uma referência a um subconjunto de uma tabela.

É importante observar que as células especificadas por um intervalo de tabela não formam necessariamente um retângulo. Por exemplo, digamos que temos uma tabela 3 x 3 em que todas as células da última linha estão mescladas. A tabela tem esta aparência: 

 [   ][   ][   ]
 [   ][   ][   ]
 [             ]

Um intervalo de tabela com local = (0, 0), período de linha = 3 e período de coluna = 2 especifica as seguintes células: 

 [ x ][ x ][   ]
 [ x ][ x ][   ]
 [ x    x    x ]
Representação JSON 
{
  "location": {
    object (TableCellLocation)
  },
  "rowSpan": integer,
  "columnSpan": integer
}
Campos
location

object (TableCellLocation)

O local inicial do intervalo da tabela.

rowSpan

integer

O intervalo de linhas do intervalo da tabela.

columnSpan

integer

O intervalo de colunas do intervalo da tabela.

UpdateLinePropertiesRequest

Atualiza as propriedades de um Line.

Representação JSON 
{
  "objectId": string,
  "lineProperties": {
    object (LineProperties)
  },
  "fields": string
}
Campos
objectId

string

O ID do objeto da linha a que a atualização é aplicada.

lineProperties

object (LineProperties)

As propriedades da linha a serem atualizadas.

fields

string (FieldMask format)

Os campos que precisam ser atualizados.

É necessário especificar pelo menos um campo. A raiz lineProperties é implícita e não precisa ser especificada. Um único "*" pode ser usado como abreviação para listar todos os campos.

Por exemplo, para atualizar a cor de preenchimento sólido da linha, defina fields como "lineFill.solidFill.color".

Para redefinir uma propriedade para o valor padrão, inclua o nome do campo na máscara, mas deixe o campo sem definição.

CreateParagraphBulletsRequest

Cria marcadores para todos os parágrafos que se sobrepõem ao intervalo de índice de texto especificado.

O nível de aninhamento de cada parágrafo é determinado pela contagem de tabulações à esquerda de cada um. Para evitar espaço em excesso entre o marcador e o parágrafo correspondente, essas tabulações iniciais são removidas por essa solicitação. Isso pode mudar os índices de partes do texto.

Se o parágrafo imediatamente anterior aos parágrafos que estão sendo atualizados estiver em uma lista com uma predefinição correspondente, os parágrafos atualizados serão adicionados a essa lista anterior.

Representação JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  },
  "bulletPreset": enum (BulletGlyphPreset)
}
Campos
objectId

string

O ID do objeto da forma ou tabela que contém o texto a ser adicionado a marcadores.

cellLocation

object (TableCellLocation)

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

textRange

object (Range)

O intervalo de texto em que os presets de marcadores serão aplicados, com base nos índices TextElement.

bulletPreset

enum (BulletGlyphPreset)

Os tipos de glifos de marcador a serem usados. O padrão é a predefinição BULLET_DISC_CIRCLE_SQUARE.

BulletGlyphPreset

Padrões predefinidos de glifos de marcadores para listas em texto.

Esses padrões usam os seguintes tipos de marcadores:

  • ARROW : uma seta, correspondente a um ponto de código Unicode U+2794
  • ARROW3D : uma seta com sombreamento 3D, correspondente a um ponto de código Unicode U+27a2
  • CHECKBOX : um quadrado oco, correspondente a um ponto de código Unicode U+274f
  • CIRCLE : um círculo oco, correspondente a um ponto de código Unicode U+25cb
  • DIAMOND : um losango sólido, correspondente a um ponto de código Unicode U+25c6
  • DIAMONDX : um losango com um "x", correspondente a um ponto de código Unicode U+2756
  • HOLLOWDIAMOND : um losango oco, correspondente a um ponto de código Unicode U+25c7
  • DISC : um círculo sólido, correspondente a um ponto de código Unicode U+25cf
  • SQUARE : um quadrado sólido, correspondente a um ponto de código Unicode U+25a0
  • STAR : uma estrela, correspondente a um ponto de código Unicode U+2605
  • ALPHA : uma letra minúscula, como "a", "b" ou "c".
  • UPPERALPHA : uma letra maiúscula, como "A", "B" ou "C".
  • DIGIT : um número, como "1", "2" ou "3".
  • ZERODIGIT : um número em que os números de um único dígito são prefixados com um zero, como "01", "02" ou "03". Números com mais de um dígito não são prefixados com um zero.
  • ROMAN : um numeral romano em minúsculas, como "i", "ii" ou "iii".
  • UPPERROMAN : um numeral romano em maiúsculas, como "I", "II" ou "III".
  • LEFTTRIANGLE : um triângulo apontando para a esquerda, correspondente a um ponto de código Unicode U+25c4
Tipos enumerados
BULLET_DISC_CIRCLE_SQUARE Uma lista com marcadores com um glifo de marcador DISC, CIRCLE e SQUARE para os três primeiros níveis de aninhamento da lista.
BULLET_DIAMONDX_ARROW3D_SQUARE Uma lista com marcadores com um glifo de marcador DIAMONDX, ARROW3D e SQUARE para os três primeiros níveis de aninhamento da lista.
BULLET_CHECKBOX Uma lista com marcadores com CHECKBOX glifos de marcadores para todos os níveis de aninhamento da lista.
BULLET_ARROW_DIAMOND_DISC Uma lista com marcadores com um glifo de marcador ARROW, DIAMOND e DISC para os três primeiros níveis de aninhamento da lista.
BULLET_STAR_CIRCLE_SQUARE Uma lista com marcadores com um glifo de marcador STAR, CIRCLE e SQUARE para os três primeiros níveis de aninhamento da lista.
BULLET_ARROW3D_CIRCLE_SQUARE Uma lista com marcadores com um glifo de marcador ARROW3D, CIRCLE e SQUARE para os três primeiros níveis de aninhamento da lista.
BULLET_LEFTTRIANGLE_DIAMOND_DISC Uma lista com marcadores com um glifo de marcador LEFTTRIANGLE, DIAMOND e DISC para os três primeiros níveis de aninhamento da lista.
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE Uma lista com marcadores com um glifo de marcador DIAMONDX, HOLLOWDIAMOND e SQUARE para os três primeiros níveis de aninhamento da lista.
BULLET_DIAMOND_CIRCLE_SQUARE Uma lista com marcadores com um glifo de marcador DIAMOND, CIRCLE e SQUARE para os três primeiros níveis de aninhamento da lista.
NUMBERED_DIGIT_ALPHA_ROMAN Uma lista numerada com glifos numéricos DIGIT, ALPHA e ROMAN para os três primeiros níveis de aninhamento da lista, seguidos por pontos.
NUMBERED_DIGIT_ALPHA_ROMAN_PARENS Uma lista numerada com glifos numéricos DIGIT, ALPHA e ROMAN para os três primeiros níveis de aninhamento da lista, seguidos por parênteses.
NUMBERED_DIGIT_NESTED Uma lista numerada com glifos numéricos DIGIT separados por pontos, em que cada nível de aninhamento usa o glifo do nível anterior como um prefixo. Por exemplo: "1.", '1.1.', '2.', '2.2'.
NUMBERED_UPPERALPHA_ALPHA_ROMAN Uma lista numerada com glifos numéricos UPPERALPHA, ALPHA e ROMAN para os três primeiros níveis de aninhamento da lista, seguidos por pontos.
NUMBERED_UPPERROMAN_UPPERALPHA_DIGIT Uma lista numerada com glifos numéricos UPPERROMAN, UPPERALPHA e DIGIT para os três primeiros níveis de aninhamento da lista, seguidos por pontos.
NUMBERED_ZERODIGIT_ALPHA_ROMAN Uma lista numerada com glifos numéricos ZERODIGIT, ALPHA e ROMAN para os três primeiros níveis de aninhamento da lista, seguidos por pontos.

ReplaceAllShapesWithImageRequest

Substitui todas as formas que correspondem aos critérios especificados pela imagem fornecida.

As imagens que substituem as formas são retangulares depois de inseridas na apresentação e não assumem as formas.

Representação 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.
}
Campos
replaceMethod
(deprecated)

enum (ReplaceMethod)

O método de substituição.

Descontinuado : use imageReplaceMethod em vez disso.

Se você especificar um replaceMethod e um imageReplaceMethod, o imageReplaceMethod terá precedência.

imageReplaceMethod

enum (ImageReplaceMethod)

O método de substituição de imagem.

Se você especificar um replaceMethod e um imageReplaceMethod, o imageReplaceMethod terá precedência.

Se você não especificar um valor para imageReplaceMethod, mas especificar um valor para replaceMethod, o valor replaceMethod especificado será usado.

Se você não especificar nenhum deles, CENTER_INSIDE será usado.

pageObjectIds[]

string

Se não estiver vazio, limita as correspondências a elementos da página apenas nas páginas especificadas.

Retorna um erro 400 de solicitação inválida se for fornecido o ID do objeto de página de um notes page ou um notes master, ou se uma página com esse ID de objeto não existir na apresentação.

Campo de união criteria. Os critérios que as formas precisam corresponder para serem substituídas. criteria pode ser apenas um dos seguintes:
containsText

object (SubstringMatchCriteria)

Se definido, essa solicitação vai substituir todas as formas que contêm o texto especificado.

Campo de união image_source. O tipo de origem da imagem. image_source pode ser apenas um dos seguintes:
imageUrl

string

O URL da imagem.

A imagem é buscada uma vez no momento da inserção e uma cópia é armazenada para exibição na apresentação. As imagens precisam ter menos de 50 MB, não podem exceder 25 megapixels e precisam estar em um dos formatos PNG, JPEG ou GIF.

O URL fornecido pode ter no máximo 2 kB. O URL é salvo com a imagem e exposto pelo campo Image.source_url.

ReplaceMethod

O método de substituição.

Tipos enumerados
CENTER_INSIDE Ajusta e centraliza a imagem para caber nos limites da forma original e mantém a proporção da imagem. O tamanho renderizado da imagem pode ser menor do que o tamanho da forma. Esse é o método padrão quando nenhum é especificado.
CENTER_CROP Dimensiona e centraliza a imagem para preencher os limites da forma original. A imagem pode ser cortada para preencher a forma. O tamanho renderizado da imagem será o mesmo do formato original.

ImageReplaceMethod

O método de substituição de imagem.

Tipos enumerados
IMAGE_REPLACE_METHOD_UNSPECIFIED Método de substituição de imagem não especificado. Esse valor não pode ser usado.
CENTER_INSIDE Ajusta e centraliza a imagem para caber nos limites da forma original e mantém a proporção da imagem. O tamanho renderizado da imagem pode ser menor do que o tamanho da forma. Esse é o método padrão quando nenhum é especificado.
CENTER_CROP Dimensiona e centraliza a imagem para preencher os limites da forma original. A imagem pode ser cortada para preencher a forma. O tamanho renderizado da imagem será o mesmo da forma original.

DuplicateObjectRequest

Duplica um slide ou elemento de página.

Ao duplicar um slide, ele é criado imediatamente após o slide especificado. Ao duplicar um elemento da página, a cópia será colocada na mesma página e na mesma posição do original.

Representação JSON 
{
  "objectId": string,
  "objectIds": {
    string: string,
    ...
  }
}
Campos
objectId

string

O ID do objeto a ser duplicado.

objectIds

map (key: string, value: string)

O objeto duplicado pode conter outros objetos, por exemplo, ao duplicar um slide ou um elemento de página de grupo. Esse mapa define como os IDs de objetos duplicados são gerados: as chaves são os IDs dos objetos originais, e os valores são os IDs que serão atribuídos ao objeto duplicado correspondente. O ID do duplicado do objeto de origem também pode ser especificado neste mapa, usando o mesmo valor do campo objectId como uma chave e o novo ID desejado como o valor.

Todas as chaves precisam corresponder a IDs existentes na apresentação. Todos os valores precisam ser exclusivos na apresentação e começar com um caractere alfanumérico ou um sublinhado (corresponde à regex [a-zA-Z0-9_]). Os caracteres restantes podem incluir esses, além de um hífen ou dois pontos (corresponde à regex [a-zA-Z0-9_-:]). O comprimento do novo ID não pode ser menor que 5 nem maior que 50.

Se algum ID de objeto de origem for omitido do mapa, um novo ID aleatório será atribuído. Se o mapa estiver vazio ou não definido, todos os objetos duplicados vão receber um novo ID aleatório.

UpdateTextStyleRequest

Atualize o estilo do texto em um Shape ou Table.

Representação JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "style": {
    object (TextStyle)
  },
  "textRange": {
    object (Range)
  },
  "fields": string
}
Campos
objectId

string

O ID do objeto da forma ou tabela com o texto a ser estilizado.

cellLocation

object (TableCellLocation)

A localização da célula na tabela que contém o texto a ser estilizado. Se objectId se referir a uma tabela, cellLocation precisará ter um valor. Caso contrário, não.

style

object (TextStyle)

Os estilos a serem definidos no texto.

Se o valor de um estilo específico corresponder ao do elemento pai, o estilo será definido como "herdar".

Algumas mudanças no estilo do texto podem causar outras alterações destinadas a espelhar o comportamento do editor de apresentações. Consulte a documentação de TextStyle para mais informações.

textRange

object (Range)

O intervalo de texto a ser estilizado.

O intervalo pode ser estendido para incluir novas linhas adjacentes.

Se o intervalo contiver totalmente um parágrafo de uma lista, o marcador do parágrafo também será atualizado com o estilo de texto correspondente.

fields

string (FieldMask format)

Os campos que precisam ser atualizados.

É necessário especificar pelo menos um campo. A raiz style é implícita e não precisa ser especificada. Um único "*" pode ser usado como abreviação para listar todos os campos.

Por exemplo, para atualizar o estilo do texto para negrito, defina fields como "bold".

Para redefinir uma propriedade para o valor padrão, inclua o nome do campo na máscara, mas deixe o campo sem definição.

ReplaceAllShapesWithSheetsChartRequest

Substitui todas as formas que correspondem aos critérios especificados pelo gráfico das Planilhas Google fornecido. O gráfico será dimensionado e centralizado para caber nos limites da forma original.

OBSERVAÇÃO: para substituir formas por um gráfico, é necessário ter pelo menos um dos escopos do OAuth "spreadsheets.readonly", "spreadsheets", "drive.readonly" ou "drive".

Representação JSON 
{
  "containsText": {
    object (SubstringMatchCriteria)
  },
  "spreadsheetId": string,
  "chartId": integer,
  "linkingMode": enum (LinkingMode),
  "pageObjectIds": [
    string
  ]
}
Campos
containsText

object (SubstringMatchCriteria)

Os critérios que as formas precisam corresponder para serem substituídas. A solicitação vai substituir todas as formas que contêm o texto especificado.

spreadsheetId

string

O ID da planilha Google que contém o gráfico.

chartId

integer

O ID do gráfico específico na planilha Google.

linkingMode

enum (LinkingMode)

O modo com que o gráfico está vinculado à planilha de origem. Quando não especificado, o gráfico será uma imagem não vinculada.

pageObjectIds[]

string

Se não estiver vazio, limita as correspondências a elementos da página apenas nas páginas especificadas.

Retorna um erro 400 de solicitação inválida se for fornecido o ID do objeto de página de um notes page ou um notes master, ou se uma página com esse ID de objeto não existir na apresentação.

LinkingMode

O modo com que o gráfico está vinculado à planilha de origem.

Tipos enumerados
NOT_LINKED_IMAGE O gráfico não está associado à planilha de origem e não pode ser atualizado. Um gráfico não vinculado será inserido como uma imagem.
LINKED Ao vincular o gráfico, ele pode ser atualizado, e outros colaboradores vão ver um link para a planilha.

DeleteParagraphBulletsRequest

Exclui marcadores de todos os parágrafos que se sobrepõem ao índice de texto range.

O nível de aninhamento de cada parágrafo será preservado visualmente com a adição de um recuo no início do parágrafo correspondente.

Representação JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  }
}
Campos
objectId

string

O ID do objeto da forma ou tabela que contém o texto de onde os marcadores serão excluídos.

cellLocation

object (TableCellLocation)

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

textRange

object (Range)

O intervalo de texto para excluir marcadores, com base nos índices TextElement.

UpdateParagraphStyleRequest

Atualiza o estilo de todos os parágrafos em um Shape ou Table que se sobrepõem ao intervalo de índice de texto especificado.

Representação JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "style": {
    object (ParagraphStyle)
  },
  "textRange": {
    object (Range)
  },
  "fields": string
}
Campos
objectId

string

O ID do objeto da forma ou tabela com o texto a ser estilizado.

cellLocation

object (TableCellLocation)

A localização da célula na tabela que contém os parágrafos a serem estilizados. Se objectId se referir a uma tabela, cellLocation precisará ter um valor. Caso contrário, não.

style

object (ParagraphStyle)

O estilo do parágrafo.

textRange

object (Range)

O intervalo de texto que contém os parágrafos a serem estilizados.

fields

string (FieldMask format)

Os campos que precisam ser atualizados.

É necessário especificar pelo menos um campo. A raiz style é implícita e não precisa ser especificada. Um único "*" pode ser usado como abreviação para listar todos os campos.

Por exemplo, para atualizar o alinhamento do parágrafo, defina fields como "alignment".

Para redefinir uma propriedade para o valor padrão, inclua o nome do campo na máscara, mas deixe o campo sem definição.

UpdateTableBorderPropertiesRequest

Atualiza as propriedades das bordas da tabela em um Table.

Representação JSON 
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  },
  "borderPosition": enum (BorderPosition),
  "tableBorderProperties": {
    object (TableBorderProperties)
  },
  "fields": string
}
Campos
objectId

string

O ID do objeto da tabela.

tableRange

object (TableRange)

O intervalo da tabela que representa o subconjunto da tabela a que as atualizações são aplicadas. Se um intervalo de tabela não for especificado, as atualizações serão aplicadas à tabela inteira.

borderPosition

enum (BorderPosition)

A posição da borda no intervalo da tabela a que as atualizações devem ser aplicadas. Se uma posição de borda não for especificada, as atualizações serão aplicadas a todas as bordas no intervalo da tabela.

tableBorderProperties

object (TableBorderProperties)

As propriedades da borda da tabela a serem atualizadas.

fields

string (FieldMask format)

Os campos que precisam ser atualizados.

É necessário especificar pelo menos um campo. A raiz tableBorderProperties é implícita e não precisa ser especificada. Um único "*" pode ser usado como abreviação para listar todos os campos.

Por exemplo, para atualizar a cor de preenchimento sólido da borda da tabela, defina fields como "tableBorderFill.solidFill.color".

Para redefinir uma propriedade para o valor padrão, inclua o nome do campo na máscara, mas deixe o campo sem definição.

BorderPosition

A posição da borda da tabela.

Tipos enumerados
ALL Todas as bordas no intervalo.
BOTTOM Bordas na parte de baixo do intervalo.
INNER Bordas dentro do intervalo.
INNER_HORIZONTAL Bordas horizontais dentro do intervalo.
INNER_VERTICAL Bordas verticais na parte interna do intervalo.
LEFT Bordas à esquerda do intervalo.
OUTER Bordas ao longo da parte externa do intervalo.
RIGHT Bordas à direita do intervalo.
TOP Bordas na parte superior do intervalo.

UpdateTableColumnPropertiesRequest

Atualiza as propriedades de uma coluna Table.

Representação JSON 
{
  "objectId": string,
  "columnIndices": [
    integer
  ],
  "tableColumnProperties": {
    object (TableColumnProperties)
  },
  "fields": string
}
Campos
objectId

string

O ID do objeto da tabela.

columnIndices[]

integer

A lista de índices baseados em zero que especificam quais colunas serão atualizadas. Se nenhum índice for fornecido, todas as colunas da tabela serão atualizadas.

tableColumnProperties

object (TableColumnProperties)

As propriedades da coluna da tabela a serem atualizadas.

Se o valor de tableColumnProperties#columnWidth na solicitação for menor que 406.400 EMUs (32 pontos), um erro 400 "Solicitação inválida" será retornado.

fields

string (FieldMask format)

Os campos que precisam ser atualizados.

É necessário especificar pelo menos um campo. A raiz tableColumnProperties é implícita e não precisa ser especificada. Um único "*" pode ser usado como abreviação para listar todos os campos.

Por exemplo, para atualizar a largura da coluna, defina fields como "columnWidth".

Se "columnWidth" for incluído na máscara de campo, mas a propriedade não for definida,a largura da coluna será definida como padrão para 406.400 EMU (32 pontos).

UpdateTableRowPropertiesRequest

Atualiza as propriedades de uma linha Table.

Representação JSON 
{
  "objectId": string,
  "rowIndices": [
    integer
  ],
  "tableRowProperties": {
    object (TableRowProperties)
  },
  "fields": string
}
Campos
objectId

string

O ID do objeto da tabela.

rowIndices[]

integer

A lista de índices com base em zero que especificam quais linhas serão atualizadas. Se nenhum índice for fornecido, todas as linhas da tabela serão atualizadas.

tableRowProperties

object (TableRowProperties)

As propriedades da linha da tabela a serem atualizadas.

fields

string (FieldMask format)

Os campos que precisam ser atualizados.

É necessário especificar pelo menos um campo. A raiz tableRowProperties é implícita e não precisa ser especificada. Um único "*" pode ser usado como abreviação para listar todos os campos.

Por exemplo, para atualizar a altura mínima da linha, defina fields como "minRowHeight".

Se "minRowHeight" estiver incluído na máscara de campo, mas a propriedade não estiver definida, a altura mínima da linha será definida como 0 por padrão.

MergeTableCellsRequest

Mescla células em um Table.

Representação JSON 
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  }
}
Campos
objectId

string

O ID do objeto da tabela.

tableRange

object (TableRange)

O intervalo da tabela que especifica quais células serão mescladas.

Todo o texto nas células mescladas será concatenado e armazenado na célula superior esquerda ("cabeçalho") do intervalo. Se o intervalo não for retangular (o que pode ocorrer em alguns casos em que o intervalo abrange células já mescladas), um erro 400 de solicitação incorreta será retornado.

UnmergeTableCellsRequest

Desfaz a mesclagem de células em um Table.

Representação JSON 
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  }
}
Campos
objectId

string

O ID do objeto da tabela.

tableRange

object (TableRange)

O intervalo da tabela que especifica quais células precisam ser desagrupadas.

Todas as células mescladas nesse intervalo serão separadas, e as que já estão separadas não serão afetadas. Se o intervalo não tiver células mescladas, a solicitação não fará nada. Se houver texto em alguma das células mescladas, ele vai permanecer na célula superior esquerda ("cabeça") do bloco resultante de células não mescladas.

GroupObjectsRequest

Agrupa objetos para criar um grupo de objetos. Por exemplo, agrupe PageElements para criar um Group na mesma página que todos os filhos.

Representação JSON 
{
  "groupObjectId": string,
  "childrenObjectIds": [
    string
  ]
}
Campos
groupObjectId

string

Um ID de objeto fornecido pelo usuário para o grupo a ser criado.

Se você especificar um ID, ele precisará ser exclusivo entre todas as páginas e elementos da 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, além de um hífen ou dois pontos (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.

childrenObjectIds[]

string

Os IDs dos objetos a serem agrupados.

Somente elementos da página podem ser agrupados. É necessário ter pelo menos dois elementos na mesma página que ainda não estejam em outro grupo. Alguns elementos da página, como videos, tables e placeholders não podem ser agrupados.

UngroupObjectsRequest

Desagrupa objetos, como groups.

Representação JSON 
{
  "objectIds": [
    string
  ]
}
Campos
objectIds[]

string

Os IDs dos objetos a serem desagrupados.

Somente groups que não estão dentro de outros groups podem ser desagrupados. Todos os grupos precisam estar na mesma página. O grupo em si é excluído. Os tamanhos e as posições visuais de todos os filhos são preservados.

UpdatePageElementAltTextRequest

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

Representação JSON 
{
  "objectId": string,
  "title": string,
  "description": string
}
Campos
objectId

string

O ID do objeto do elemento da página em que as atualizações são aplicadas.

title

string

O título atualizado do texto alternativo do elemento da página. Se não for definido, o valor atual será mantido. O título é exposto a leitores de tela e outras interfaces de acessibilidade. Use apenas valores legíveis relacionados ao conteúdo do elemento da página.

description

string

A descrição atualizada do texto alternativo do elemento da página. Se não for definido, o valor atual será mantido. A descrição é exposta a leitores de tela e outras interfaces de acessibilidade. Use apenas valores legíveis relacionados ao conteúdo do elemento da página.

ReplaceImageRequest

Substitui uma imagem por outra.

A substituição de uma imagem remove alguns image effects da imagem atual.

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

string

O ID da imagem atual que será substituída. O ID pode ser extraído da resposta de uma solicitação GET.

imageReplaceMethod

enum (ImageReplaceMethod)

O método de substituição.

Campo de união image_source. O tipo de origem da imagem. image_source pode ser apenas um dos seguintes:
url

string

O URL da imagem.

A imagem é buscada uma vez no momento da inserção e uma cópia é armazenada para exibição na apresentação. As imagens precisam ter menos de 50 MB, não podem exceder 25 megapixels e precisam estar no formato PNG, JPEG ou GIF.

O URL fornecido não pode ter mais de 2 KB. O URL é salvo com a imagem e exposto pelo campo Image.source_url.

UpdateSlidePropertiesRequest

Atualiza as propriedades de um slide.

Representação JSON 
{
  "objectId": string,
  "slideProperties": {
    object (SlideProperties)
  },
  "fields": string
}
Campos
objectId

string

O ID do objeto do slide em que a atualização é aplicada.

slideProperties

object (SlideProperties)

As propriedades do slide a serem atualizadas.

fields

string (FieldMask format)

Os campos que precisam ser atualizados.

É necessário especificar pelo menos um campo. O "slideProperties" raiz está implícito e não precisa ser especificado. Um único "*" pode ser usado como abreviação para listar todos os campos.

Por exemplo, para atualizar se um slide é ignorado, defina fields como "isSkipped".

Para redefinir uma propriedade para o valor padrão, inclua o nome do campo na máscara, mas deixe o campo sem definição.

UpdatePageElementsZOrderRequest

Atualiza a ordem Z dos elementos da página. A ordem Z é uma ordenação dos elementos na página de trás para frente. O elemento da frente pode cobrir os que estão atrás dele.

Representação JSON 
{
  "pageElementObjectIds": [
    string
  ],
  "operation": enum (ZOrderOperation)
}
Campos
pageElementObjectIds[]

string

Os IDs de objeto dos elementos da página a serem atualizados.

Todos os elementos precisam estar na mesma página e não podem ser agrupados.

operation

enum (ZOrderOperation)

A operação de ordem Z a ser aplicada aos elementos da página.

Ao aplicar a operação em vários elementos da página, as ordens Z relativas dentro desses elementos antes da operação são mantidas.

ZOrderOperation

A operação para atualizar a ordem Z de um elemento da página.

Tipos enumerados
Z_ORDER_OPERATION_UNSPECIFIED Operação não especificada.
BRING_TO_FRONT Traz os elementos da página para a frente.
BRING_FORWARD Traz os elementos da página para a frente em relação ao elemento mais avançado nos elementos especificados.
SEND_BACKWARD Envia os elementos da página para trás em relação ao elemento mais distante nos elementos especificados.
SEND_TO_BACK Envia os elementos da página para o fundo dela.

UpdateLineCategoryRequest

Atualiza a categoria de um line.

Representação JSON 
{
  "objectId": string,
  "lineCategory": enum (LineCategory)
}
Campos
objectId

string

O ID do objeto da linha a que a atualização é aplicada.

Só é possível atualizar uma linha com um category indicando que é um "conector".

A linha pode ser redirecionada após a atualização da categoria.

lineCategory

enum (LineCategory)

A categoria de linha a ser atualizada.

O line type exato é determinado com base na categoria a ser atualizada e em como ela é encaminhada para se conectar a outros elementos da página.

RerouteLineRequest

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

Representação JSON 
{
  "objectId": string
}
Campos
objectId

string

O ID do objeto da linha a ser redirecionada.

Somente uma linha com um category indicando que é um "conector" pode ser redirecionada. As conexões de início e fim da linha precisam estar em elementos de página diferentes.