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 (TableCellLocation)

O local da célula da tabela de referência em que 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 mesclada, uma nova linha será inserida acima (ou abaixo) da célula mesclada.

insertBelow

boolean

Define se novas linhas serão 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.

O tamanho das outras colunas na tabela será alterado para caber na nova coluna.

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)

O local da célula da tabela de referência 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 mesclada, uma nova coluna será inserida à esquerda (ou à direita) da célula mesclada.

insertRight

boolean

Define se novas colunas serão inseridas à direita do local da célula de referência.

  • True : insira à direita.
  • False : insira à 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 onde 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 que abrange essa célula será excluída. Se for uma célula mesclada, várias linhas serão excluídas. Se nenhuma linha permanecer na tabela após essa exclusão, a tabela inteira será excluída.

DeleteTableColumnRequest

Exclui uma coluna de uma tabela.

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

string

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

cellLocation

object (TableCellLocation)

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

A coluna que abrange essa célula 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, a tabela inteira 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 somente nas páginas especificadas.

Retorna um erro 400 de solicitação inválida se receber o ID do objeto da 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 busca precisa ser tratado como uma expressão regular. Todas as barras invertidas no padrão precisam ter escape.

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

DeleteObjectRequest

Exclui um objeto, 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 da 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 vai mudar a transformação absoluta dos elementos da página nesse grupo, o que pode mudar a aparência 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.

Enums
APPLY_MODE_UNSPECIFIED Modo não especificado.
RELATIVE Aplica a nova matriz AffineTransform à matriz atual e a substitui 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 dessa lista precisam estar na ordem da apresentação, sem duplicações.

insertionIndex

integer

O índice em que os slides precisam ser inseridos, com base na disposição dos slides antes da mudança. Precisa estar entre zero e o número de slides da apresentação.

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 quebra de linha implícita, o valor máximo será 2 para textRange.start_index e 3 para textRange.end_index.

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

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

Intervalo

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

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

integer

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

endIndex

integer

O índice opcional com base 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.

Enums
RANGE_TYPE_UNSPECIFIED Tipo de intervalo não especificado. Esse valor não deve ser usado.
FIXED_RANGE Um intervalo fixo. É preciso especificar startIndex e endIndex.
FROM_START_INDEX Inicia o intervalo em startIndex e continua até o fim da coleção. 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 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 imagem.

Quando a proporção do tamanho fornecido não corresponde à proporção da imagem, a imagem é 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 tamanho padrão da imagem 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. 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 de 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 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 do vídeo.

A propriedade PageElementProperties.size é opcional. Se você não especificar um tamanho, o servidor vai escolher um tamanho 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 origem do vídeo.

id

string

Identificador exclusivo da fonte do vídeo.

Por exemplo, no 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 para um subconjunto de arquivos antigos. Para mais informações, consulte Acessar arquivos compartilhados por link usando chaves de recurso.

CreateSheetsChartRequest

Cria um gráfico incorporado das Planilhas Google.

OBSERVAÇÃO: a criação de gráficos requer pelo menos um dos escopos 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 da 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 ID não pode ter menos de 5 nem mais de 50 caracteres. Se estiver vazio, um identificador exclusivo será gerado.

elementProperties

object (PageElementProperties)

As propriedades do elemento do gráfico.

Quando a proporção do tamanho fornecido não corresponde à proporção do gráfico, o gráfico é redimensionado 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 do Google Planilhas 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 recurso.

chartId

integer

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

linkingMode

enum (LinkingMode)

O modo em que o gráfico está vinculado à planilha de origem. Se não for especificado, o gráfico será uma imagem sem link.

LinkingMode

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

Enums
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 A vinculação do gráfico permite que ele seja atualizado, e outros colaboradores vão ter acesso a 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 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 linha.

lineCategory
(deprecated)

enum (Category)

A categoria da linha a ser criada.

Descontinuado : use category em vez disso.

O line type criado é determinado com base na categoria e na forma como ele é roteado 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 criado é determinado com base na categoria e na forma como ele é roteado 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 linhas.

Enums
STRAIGHT Conectores retos, incluindo o conector reto 1. A categoria padrão quando nenhuma é especificada.
BENT Conectores dobrados, incluindo o conector dobrado 2 a 5.
CURVED Conectores curvos, incluindo os conectores curvos 2 a 5.

RefreshSheetsChartRequest

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

OBSERVAÇÃO: a atualização de gráficos requer pelo menos um dos escopos de 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

Atualize as propriedades de um Shape.

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

string

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

shapeProperties

object (ShapeProperties)

As propriedades da forma a serem atualizadas.

fields

string (FieldMask format)

Os campos que precisam ser atualizados.

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

Por exemplo, para atualizar a cor de preenchimento sólida 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 de campo, mas deixe o campo indefinido.

UpdateImagePropertiesRequest

Atualize as propriedades de um Image.

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

string

O ID do objeto da imagem em 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. O imageProperties raiz é implícito e não precisa ser especificado. Um único "*" pode ser usado como atalho 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 de campo, mas deixe o campo indefinido.

UpdateVideoPropertiesRequest

Atualize 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 do vídeo a serem atualizadas.

fields

string (FieldMask format)

Os campos que precisam ser atualizados.

É necessário especificar pelo menos um campo. O videoProperties raiz é implícito e não precisa ser especificado. Um único "*" pode ser usado como atalho 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 de campo, mas deixe o campo indefinido.

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. O pageProperties raiz é implícito e não precisa ser especificado. Um único "*" pode ser usado como atalho para listar todos os campos.

Por exemplo, para atualizar a cor de preenchimento sólida 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 de campo, mas deixe o campo indefinido.

UpdateTableCellPropertiesRequest

Atualize 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 em que as atualizações são aplicadas. Se um intervalo de tabela não for especificado, as atualizações serão aplicadas a toda a tabela.

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. O tableCellProperties raiz é implícito e não precisa ser especificado. Um único "*" pode ser usado como atalho para listar todos os campos.

Por exemplo, para atualizar a cor de preenchimento sólida 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 de campo, mas deixe o campo indefinido.

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 tabelas 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 são mescladas. A tabela tem esta aparência:

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

Um intervalo de tabela com localização = (0, 0), intervalo de linha = 3 e intervalo de coluna = 2 especifica as células a seguir:

 [ 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 em 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. O lineProperties raiz é implícito e não precisa ser especificado. Um único "*" pode ser usado como atalho para listar todos os campos.

Por exemplo, para atualizar a cor de preenchimento sólida 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 de campo, mas deixe o campo indefinido.

CreateParagraphBulletsRequest

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

O nível de aninhamento de cada parágrafo será determinado pela contagem de guias principais à frente de cada parágrafo. Para evitar espaço excessivo entre o marcador de posição e o parágrafo correspondente, essas guias iniciais são removidas por essa solicitação. Isso pode mudar os índices de partes do texto.

Se o parágrafo imediatamente antes dos parágrafos que estão sendo atualizados estiver em uma lista com uma predefinição correspondente, os parágrafos que estão sendo 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 para adicionar marcadores.

cellLocation

object (TableCellLocation)

O local da célula da tabela opcional 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 as predefinições de marcadores serão aplicadas, 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 estes 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 têm um zero no início, como "01", "02" ou "03". Números com mais de um dígito não têm um zero no prefixo.
  • ROMAN : um numeral romano minúsculo, como 'i', 'ii' ou 'iii'.
  • UPPERROMAN : um numeral romano maiúsculo, como 'I', 'II' ou 'III'.
  • LEFTTRIANGLE : um triângulo apontando para a esquerda, correspondente a um ponto de código Unicode U+25c4
Enums
BULLET_DISC_CIRCLE_SQUARE Uma lista com marcadores DISC, CIRCLE e SQUARE para os três primeiros níveis de aninhamento de listas.
BULLET_DIAMONDX_ARROW3D_SQUARE Uma lista com marcadores DIAMONDX, ARROW3D e SQUARE para os três primeiros níveis de aninhamento de listas.
BULLET_CHECKBOX Uma lista com marcadores CHECKBOX para todos os níveis de aninhamento de listas.
BULLET_ARROW_DIAMOND_DISC Uma lista com marcadores ARROW, DIAMOND e DISC para os três primeiros níveis de aninhamento de listas.
BULLET_STAR_CIRCLE_SQUARE Uma lista com marcadores STAR, CIRCLE e SQUARE para os três primeiros níveis de aninhamento de listas.
BULLET_ARROW3D_CIRCLE_SQUARE Uma lista com marcadores ARROW3D, CIRCLE e SQUARE para os três primeiros níveis de aninhamento de listas.
BULLET_LEFTTRIANGLE_DIAMOND_DISC Uma lista com marcadores LEFTTRIANGLE, DIAMOND e DISC para os três primeiros níveis de aninhamento de listas.
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE Uma lista com marcadores DIAMONDX, HOLLOWDIAMOND e SQUARE para os três primeiros níveis de aninhamento de listas.
BULLET_DIAMOND_CIRCLE_SQUARE Uma lista com marcadores DIAMOND, CIRCLE e SQUARE para os três primeiros níveis de aninhamento de listas.
NUMBERED_DIGIT_ALPHA_ROMAN Uma lista numerada com glifos numéricos DIGIT, ALPHA e ROMAN para os três primeiros níveis de aninhamento de listas, 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 de listas, seguidos por parênteses.
NUMBERED_DIGIT_NESTED Uma lista numerada com DIGIT glifos numéricos 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 de listas, 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 de listas, 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 de listas, seguidos por pontos.

ReplaceAllShapesWithImageRequest

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

As imagens que substituem as formas são retangulares depois de inseridas na apresentação e não assumem as formas das 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 somente nas páginas especificadas.

Retorna um erro 400 de solicitação inválida se o ID do objeto da página for de um notes page ou 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 que as formas precisam atender 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.

Enums
CENTER_INSIDE Dimensiona 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.

ImageReplaceMethod

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

Enums
IMAGE_REPLACE_METHOD_UNSPECIFIED Método de substituição de imagem não especificado. Esse valor não deve ser usado.
CENTER_INSIDE Dimensiona 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 da página.

Quando você duplica um slide, a cópia é criada 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 que o 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 objeto de origem duplicado também pode ser especificado neste mapa, usando o mesmo valor do campo objectId como chave e o ID desejado como valor.

Todas as chaves precisam corresponder aos 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 caracteres, bem como um hífen ou dois-ponto (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 objetos 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)

O local da célula na tabela que contém o texto a ser estilizado. Se objectId se refere a uma tabela, cellLocation precisa 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 pai, esse estilo será definido como herdado.

Algumas mudanças no estilo de texto podem causar outras que refletem o comportamento do editor do 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 um parágrafo que pertence a 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. O style raiz é implícito e não precisa ser especificado. Um único "*" pode ser usado como atalho para listar todos os campos.

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

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

ReplaceAllShapesWithSheetsChartRequest

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

OBSERVAÇÃO: substituir formas por um gráfico requer pelo menos um dos escopos de OAuth drive.readonly, drive ou spreadsheets.readonly.

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 atender para serem substituídas. A solicitação vai substituir todas as formas que contêm o texto especificado.

spreadsheetId

string

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

chartId

integer

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

linkingMode

enum (LinkingMode)

O modo em que o gráfico está vinculado à planilha de origem. Se não for especificado, o gráfico será uma imagem sem link.

pageObjectIds[]

string

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

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

LinkingMode

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

Enums
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 A vinculação do gráfico permite que ele seja atualizado, e outros colaboradores vão ter acesso a um link para a planilha.

DeleteParagraphBulletsRequest

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

O nível de aninhamento de cada parágrafo será preservado visualmente adicionando recuo ao 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 para excluir os marcadores.

cellLocation

object (TableCellLocation)

O local da célula da tabela opcional, 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 fornecido.

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)

O local da célula na tabela que contém os parágrafos a estilizar. Se objectId se refere a uma tabela, cellLocation precisa 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 estilizar.

fields

string (FieldMask format)

Os campos que precisam ser atualizados.

É necessário especificar pelo menos um campo. O style raiz é implícito e não precisa ser especificado. Um único "*" pode ser usado como atalho 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 de campo, mas deixe o campo indefinido.

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 em que as atualizações são aplicadas. Se um intervalo de tabela não for especificado, as atualizações serão aplicadas a toda a tabela.

borderPosition

enum (BorderPosition)

A posição da borda no intervalo da tabela em que as atualizações serão 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. O tableBorderProperties raiz é implícito e não precisa ser especificado. Um único "*" pode ser usado como atalho para listar todos os campos.

Por exemplo, para atualizar a cor de preenchimento sólida 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 de campo, mas deixe o campo indefinido.

BorderPosition

A posição da borda da tabela.

Enums
ALL Todas as fronteiras no intervalo.
BOTTOM Bordas na parte de baixo do intervalo.
INNER Bordas no interior do intervalo.
INNER_HORIZONTAL Bordas horizontais dentro do intervalo.
INNER_VERTICAL Bordas verticais dentro do intervalo.
LEFT Bordas à esquerda do intervalo.
OUTER As bordas estão fora do intervalo.
RIGHT Bordas à direita do intervalo.
TOP Bordas na parte de cima 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 com base em zero que especifica 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 EMU (32 pontos), um erro 400 de solicitação inválida será retornado.

fields

string (FieldMask format)

Os campos que precisam ser atualizados.

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

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

Se "columnWidth" estiver incluído na máscara de campo, mas a propriedade não for definida,a largura da coluna vai ser padrão de 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 especifica quais linhas serão atualizadas. Se nenhum índice for fornecido, todas as linhas na 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. O tableRowProperties raiz é implícito e não precisa ser especificado. Um único "*" pode ser usado como atalho 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 for definida, a altura mínima da linha será 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 da tabela serão mescladas.

Qualquer texto nas células mescladas será concatenado e armazenado na célula superior esquerda ("cabeça") 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 inválida 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 de tabela que especifica quais células da tabela serão separadas.

Todas as células mescladas nesse intervalo serão desfeitas, e as células que já não estão mescladas não serão afetadas. Se o intervalo não tiver células mescladas, a solicitação não vai fazer nada. Se houver texto em qualquer uma 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, grupos PageElements para criar um Group na mesma página que todas as filhas.

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

childrenObjectIds[]

string

Os IDs dos objetos a serem agrupados.

Só é possível agrupar elementos da página. Deve haver pelo menos dois elementos na mesma página que 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 outro groups podem ser desagregados. Todos os grupos precisam estar na mesma página. O grupo é excluído. Os tamanhos e 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 do texto alternativo atualizado 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 por humanos relacionados ao conteúdo do elemento da página.

description

string

A descrição do texto alternativo atualizado 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 por humanos 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 que será substituída. O ID pode ser extraído da resposta de uma solicitação de busca.

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 nos formatos 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. A raiz "slideProperties" é implícita e não precisa ser especificada. Um único "*" pode ser usado como atalho 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 de campo, mas deixe o campo indefinido.

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 página na frente pode cobrir os elementos 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 da página 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.

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

UpdateLineCategoryRequest

Atualiza a categoria de um line.

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

string

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

Somente uma linha com um category indicando que é um "conector" pode ser atualizada.

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

lineCategory

enum (LineCategory)

A categoria de linha para atualizar.

O line type exato é determinado com base na categoria para atualizar e como ele é roteado 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 de página conectados.

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.