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 de página da apresentação.

updatePageElementTransform

object (UpdatePageElementTransformRequest)

Atualiza a transformação de um elemento de 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 do Planilhas Google.

updateShapeProperties

object (UpdateShapePropertiesRequest)

Atualiza as propriedades de um Shape:

updateImageProperties

object (UpdateImagePropertiesRequest)

Atualiza as propriedades de uma 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 do 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 um Table linha de comando.

mergeTableCells

object (MergeTableCellsRequest)

Mescla células em uma Table:

unmergeTableCells

object (UnmergeTableCellsRequest)

Cancela a mesclagem de células em uma Table:

groupObjects

object (GroupObjectsRequest)

Agrupa 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 existente por uma nova.

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 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 ao regex) [a-zA-Z0-9_]); os caracteres restantes podem incluir os demais, além de hífen ou dois-pontos (corresponde à regex [a-zA-Z0-9_-:]). O ID precisa ter de 5 a 50 caracteres.

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

insertionIndex

integer

O índice opcional baseado 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 master 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 da apresentação, se não houver slides.

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

Se você não especificar uma referência de layout, o slide usará o modelo BLANK o mesmo layout organizacional.

placeholderIdMappings[]

object (LayoutPlaceholderIdMapping)

Uma lista opcional de mapeamentos de ID de objeto do placeholder (s) no layout para os marcadores de posição que são criados no slide a partir do layout especificado. Só pode ser usada 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 uma das seguintes opções:
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 um layout com título e subtítulo de um lado e descrição do outro.
ONE_COLUMN_TEXT Layout com um título e um corpo, organizado 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 a partir 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 ao regex) [a-zA-Z0-9_]); os caracteres restantes podem incluir os demais, além de 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 uma das seguintes opções:
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 ao regex) [a-zA-Z0-9_]); os caracteres restantes podem incluir os demais, além de 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 da forma.

shapeType

enum (Type)

O tipo de forma.

PageElementProperties

Propriedades comuns de um elemento de página.

Observação: quando você cria inicialmente um PageElement, a API pode modificar os valores de ambos size e transform, mas o tamanho visual não será alterado.

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

elementProperties

object (PageElementProperties)

As propriedades do elemento da tabela.

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

As transformações de tabela precisam ter uma escala de 1 e não podem ter componentes de distorção. 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 fim de 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 serã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 particular de plano multilíngue Unicode Basic (U+E000-U+F8FF) serão retirados do texto inserido.

insertionIndex

integer

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

O índice é baseado em zero e é calculado 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 na qual inserir linhas.

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 : inserir 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 da qual uma linha será excluída.

A linha que abrange essa célula será excluída. Se esta 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 da qual excluir colunas.

cellLocation

object (TableCellLocation)

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

A coluna que esta célula abrange será excluída. Se esta 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 aos 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 fazer a correspondência do texto para substituição. criteria pode ser apenas uma das seguintes opções:
containsText

object (SubstringMatchCriteria)

Encontra texto em uma forma que corresponda a essa substring.

SubstringMatchCriteria

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

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

string

O texto a ser pesquisado na forma ou tabela.

matchCase

boolean

Indica se a pesquisa deve respeitar a capitalização:

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

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 de 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 de página.

Atualizar a transformação de um grupo altera a transformação absoluta dos elementos da página desse 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.

Enums
APPLY_MODE_UNSPECIFIED Modo não especificado.
RELATIVE Aplica a nova matriz AffineTransform à existente e substitui a matriz 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 atual da apresentação, sem duplicidade.

insertionIndex

integer

O índice onde os slides devem ser inseridos, com base na organização dos slides antes da movimentação. Precisa estar entre zero e o número de slides da apresentação, inclusive.

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 da qual o texto será excluído.

cellLocation

object (TableCellLocation)

O local 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, então o valor máximo é 2 para textRange.start_index e 3 para textRange.end_index.

A exclusão de texto que excede o limite de um parágrafo pode resultar em mudanças nos estilos e 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 alternativo são expandidos para incluir as duas unidades de código.

Intervalo

Especifica um intervalo contíguo de uma coleção indexada, como caracteres de 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 FIXED_RANGE intervalos.

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. Tanto o startIndex e endIndex deve ser especificado.
FROM_START_INDEX Inicia 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. Tanto o startIndex e o endIndex não deve ser especificado.

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

elementProperties

object (PageElementProperties)

As propriedades do elemento para a imagem.

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

O PageElementProperties.size é opcional. Se você não especificar o tamanho, o tamanho padrão da imagem será usado.

O 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 por meio do Image.source_url .

CreateVideoRequest

Cria um vídeo.

OBSERVAÇÃO: a criação de um vídeo do Google Drive exige que o app solicitante tenha 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 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 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.

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á posicionado no canto superior esquerdo da página.

source

enum (Source)

É a fonte do vídeo.

id

string

O identificador exclusivo da fonte do vídeo.

por exemplo: Para vídeos do YouTube https://www.youtube.com/watch?v=7U3axjORYZ0, o código é 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 recurso.

CreateSheetsChartRequest

Cria um gráfico incorporado do Planilhas Google.

OBSERVAÇÃO: a criação de gráficos exige pelo menos um dos escopos do OAuth planilhas.readonly, planilha, drive.readonly, drive.file ou OAuth.

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 único entre todas as páginas e elementos de página da apresentação. O ID precisa começar com uma palavra [a-zA-Z0-9_], seguida por qualquer número dos seguintes caracteres [a-zA-Z0-9_-:]. O comprimento do ID não deve ser menor que 5 nem maior que 50. 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 à do gráfico, o gráfico é 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 do Planilhas 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 Acesse arquivos de link compartilhado usando chaves de recurso.

chartId

integer

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

linkingMode

enum (LinkingMode)

O modo com o qual o gráfico está vinculado à planilha de origem. Se não for especificado, o gráfico será uma imagem sem vínculo.

LinkingMode

O modo com o qual 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 Vincular o gráfico permite que ele seja atualizado, e outros colaboradores verão 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 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.

elementProperties

object (PageElementProperties)

As propriedades do elemento para a linha.

lineCategory
(deprecated)

enum (Category)

A categoria da linha a ser criada.

Descontinuado : use category como alternativa.

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 dos dois, então STRAIGHT é 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 de 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 exige pelo menos um dos escopos do OAuth, planilhas, planilhas, 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 da forma ao qual 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, mas deixe o campo sem definição.

UpdateImagePropertiesRequest

Atualizar as propriedades de uma 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 está implícito e não deve ser especificado. Um "*" pode ser usado como uma forma abreviada 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 indefinido.

UpdateVideoPropertiesRequest

Atualizar as propriedades de uma 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, 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 à qual 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 "*" pode ser usado como uma forma abreviada 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, mas deixe o campo sem definição.

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 ao qual as atualizações são aplicadas. Se um intervalo da tabela não for especificado, as atualizações serão aplicadas à tabela inteira.

tableCellProperties

object (TableCellProperties)

As propriedades de 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 para "tableCellBackgroundFill.solidFill.color".

Para redefinir uma propriedade para o valor padrão, inclua o nome do campo na máscara, 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 estã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. A raiz lineProperties está implícito e não deve ser especificado. Um único "*" pode ser usado como atalho para listar todos os campos.

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

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

CreateParagraphBulletsRequests

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 das guias à 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 ao qual adicionar 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 estiver presente, o objectId deve se referir a uma tabela.

textRange

object (Range)

É o intervalo de texto ao qual as predefinições de marcador serão aplicadas, com base TextElement índices.

bulletPreset

enum (BulletGlyphPreset)

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

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 vazio, correspondente a um ponto de código Unicode U+274f
  • CIRCLE : um círculo vazio 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 vazio, correspondente a um ponto de código Unicode U+25c7
  • DISC : um círculo sólido que corresponde 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 números de apenas um dígito são prefixados com zero, como "01", "02" ou "03". Números com mais de um dígito não têm o prefixo zero.
  • ROMAN : um algarismo romano em letra minúscula, 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 da lista.
BULLET_DIAMONDX_ARROW3D_SQUARE Uma lista com marcadores DIAMONDX, ARROW3D e SQUARE para os três primeiros níveis de aninhamento da lista.
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 da lista.
BULLET_STAR_CIRCLE_SQUARE Uma lista com marcadores STAR, CIRCLE e SQUARE símbolo de marcador para os três primeiros níveis de aninhamento da lista.
BULLET_ARROW3D_CIRCLE_SQUARE Uma lista com marcadores ARROW3D, CIRCLE e SQUARE para os três primeiros níveis de aninhamento da lista.
BULLET_LEFTTRIANGLE_DIAMOND_DISC Uma lista com marcadores LEFTTRIANGLE, DIAMOND e DISC símbolo de marcador para os três primeiros níveis de aninhamento da lista.
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE Uma lista com marcadores DIAMONDX, HOLLOWDIAMOND e SQUARE símbolo de marcador para os três primeiros níveis de aninhamento da lista.
BULLET_DIAMOND_CIRCLE_SQUARE Uma lista com marcadores DIAMOND, CIRCLE e SQUARE símbolo de marcador 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 de listas, seguidos por pontos.
NUMBERED_DIGIT_ALPHA_ROMAN_PARENS Uma lista numerada com DIGIT, ALPHA e ROMAN glifos numéricos para os três primeiros níveis de aninhamento da lista, 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 ZERODIGIT, ALPHA e ROMAN glifos numéricos para os primeiros três níveis de aninhamento de 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 após serem inseridas na apresentação e não assumem a forma 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 como alternativa.

Se você especificar um replaceMethod e um imageReplaceMethod, os imageReplaceMethod tem prioridade.

imageReplaceMethod

enum (ImageReplaceMethod)

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

Se você especificar um replaceMethod e um imageReplaceMethod, os imageReplaceMethod tem prioridade.

Se você não especificar um valor para imageReplaceMethod, mas especifique um valor para replaceMethod, o valor especificado replaceMethod é 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 de solicitação 400 inválida se o ID de objeto da 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 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 uma das seguintes opções:
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 estar no formato 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 dentro dos limites da forma original e mantém a proporção da imagem. O tamanho renderizado da imagem pode ser menor que o tamanho da forma. Esse é o método padrão quando não é 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

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

Ao duplicar um slide, a cópia será criada imediatamente após o slide especificado. Ao duplicar um elemento de 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 recém-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 e 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 for definido, todos os objetos duplicados receberão um novo ID aleatório.

UpdateTextStyleRequest

Atualizar o estilo do texto em uma 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 precisam ter um valor. Caso contrário, ela não poderá.

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

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

textRange

object (Range)

O intervalo do texto a ser estilizado.

O intervalo pode ser estendido para incluir novas linhas adjacentes.

Se o intervalo contiver totalmente um parágrafo pertencente 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 para "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 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 escopossheets.readonly, planilha, drive.readonly ou OAuth do Drive.

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

object (SubstringMatchCriteria)

Os critérios aos quais 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 do Planilhas Google que contém o gráfico.

chartId

integer

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

linkingMode

enum (LinkingMode)

O modo com o qual o gráfico está vinculado à planilha de origem. Se não for especificado, o gráfico será uma imagem sem vínculo.

pageObjectIds[]

string

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

Retorna um erro de solicitação 400 inválida se o ID de objeto da 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 o qual 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 Vincular o gráfico permite que ele seja atualizado, e outros colaboradores verão um link para a planilha.

DeleteParagraphBulletsRequests

Exclui os 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 estiver presente, o objectId deve 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 de uma Shape ou Table que se sobrepõem ao intervalo do í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 serem estilizados. Se objectId se refere a uma tabela, cellLocation precisam ter um valor. Caso contrário, não.

style

object (ParagraphStyle)

O estilo do parágrafo.

textRange

object (Range)

A faixa 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 está implícito e não deve ser especificado. Um "*" pode ser usado como uma forma abreviada 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 ao qual 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 precisam 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. 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, mas deixe o campo sem definição.

BorderPosition

A posição da borda da tabela.

Enums
ALL Todas as bordas no intervalo.
BOTTOM Bordas na parte inferior do intervalo.
INNER Bordas dentro 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 no topo do intervalo.

UpdateTableColumnPropertiesRequest

Atualiza as propriedades de um 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 informado, 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 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 "*" pode ser usado como uma forma abreviada para listar todos os campos.

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

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

UpdateTableRowPropertiesRequest

Atualiza as propriedades de um Table linha de comando.

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

string

O ID de objeto da tabela.

rowIndices[]

integer

A lista de índices com base em zero que especifica quais linhas serão atualizadas. Se nenhum índice for informado, 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 está implícito e não deve 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"' for incluído na máscara de campo, mas a propriedade não for definida, a altura mínima da linha será padronizada como 0.

MergeTableCellsRequest

Mescla células em uma Table:

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

string

O ID de objeto da tabela.

tableRange

object (TableRange)

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

O texto nas células que estão sendo mescladas será concatenado e armazenado na célula superior esquerda ("head") do intervalo. Se o intervalo não for retangular (o que pode ocorrer em alguns casos em que o intervalo cobre células que já estão mescladas), um erro de solicitação 400 inválida será retornado.

UnmergeTableCellsRequest

Cancela a mesclagem de células em uma 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 devem ser mescladas.

Todas as células mescladas nesse intervalo serão separadas, e as que já estiverem separadas não serão afetadas. Se o intervalo não tiver células mescladas, a solicitação não terá efeito. Se houver texto em qualquer uma das células mescladas, ele permanecerá na célula superior esquerda ("cabeçalho") do bloco resultante de células não mescladas.

GroupObjectsRequest

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

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 único entre todas as páginas e elementos de página da apresentação. O ID precisa começar com um caractere alfanumérico ou um sublinhado (corresponde ao regex) [a-zA-Z0-9_]); os caracteres restantes podem incluir os demais, além de 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 de página podem ser agrupados. É necessário que haja pelo menos dois elementos de página 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 agrupadas.

UngroupObjectsRequest

Desagrupa objetos, como groups.

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

string

Os IDs de objeto dos objetos a serem desagrupados.

Somente groups que não estão dentro de outros groups podem ser desagrupadas. Todos os grupos precisam estar na mesma página. O grupo será 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 de 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 de página.

description

string

A descrição do texto alternativo atualizada 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 existente por uma nova.

A substituição de uma imagem remove algumas 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 por meio do 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, mas deixe o campo sem definição.

UpdatePageElementsZOrderRequest

Atualiza a ordem Z dos elementos da página. A ordem Z é uma ordem dos elementos na página de trás para frente. O elemento de página à frente pode cobrir os elementos que estão por trá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 nesses elementos da página são mantidas antes da operação.

ZOrderOperation

A operação para atualizar a ordem Z de um elemento de 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 de página para trás na página, por um elemento em relação ao que está mais atrás de outro nos elementos de página especificados.
SEND_TO_BACK Envia os elementos da página para a parte de trás da página.

UpdateLineCategoryRequest

Atualiza a categoria de um line.

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

string

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

Apenas uma linha com category indicando que é um "conector" podem ser atualizadas.

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 para atualizar e como ele é roteado para se conectar a outros elementos da página.

RerouteLineRequest

redireciona um line para que ele seja conectado nos dois locais de conexão mais próximos dos elementos de página conectados.

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

string

O ID do objeto da linha a ser redirecionada.

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