Requests

Solicitação

Um único tipo de atualização para aplicar 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 uma das seguintes opções:
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 ocorrê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 do 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 de página.

updateTextStyle

object (UpdateTextStyleRequest)

Atualiza o estilo do texto em uma 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 uma Shape ou Table.

updateTableBorderProperties

object (UpdateTableBorderPropertiesRequest)

Atualiza as propriedades das bordas da tabela em um Table:

updateTableColumnProperties

object (UpdateTableColumnPropertiesRequest)

Atualiza as propriedades de um 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 locais de conexão mais próximos dos elementos de 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 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 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 do layout do slide a ser inserido, com base no mestre atual, que é uma das opções a seguir:

  • O mestre do índice do slide anterior.
  • O mestre do primeiro slide, se o insertIndex 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 usado quando slideLayoutReference é especificado.

LayoutReference

Referência de layout de slide. Isso pode mencionar:

  • 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 de objeto de um dos layouts na apresentação.

PredefinedLayout

Tipos de layout predefinidos. Esses são layouts comumente encontrados 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 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.

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. Somente type e index necessários. Por exemplo, um modelo predefinido TITLE_AND_BODY o layout pode ter um marcador TITLE com índice 0 e um marcador BODY com índice 0.

layoutPlaceholderObjectId

string

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

CreateShapeRequest

Cria uma nova forma.

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

string

Um ID de objeto fornecido pelo usuário.

Se você especificar um ID, ele precisará ser ú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 estiver vazio, será gerado um identificador exclusivo.

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

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)

A localização opcional da célula da tabela, caso o texto precise ser inserido nela. Se estiver presente, o objectId deve se referir a uma tabela.

text

string

O texto a ser inserido.

Inserir um caractere de nova linha criará implicitamente um novo ParagraphMarker naquele índice. O estilo do novo parágrafo será copiado dele 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 em clusters de grafeme Unicode. Nesses casos, o texto é inserido imediatamente após o cluster de grafema.

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 onde a célula de referência está. Se a célula de referência for uma célula mesclada, uma nova linha será inserida acima (ou abaixo) 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 : inserir acima da célula.
number

integer

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

InsertTableColumnsRequest

Insere colunas em uma tabela.

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

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

string

A tabela na qual inserir colunas.

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 onde está a célula de referência. Se a célula de referência for uma célula mesclada, uma nova coluna será inserida à esquerda (ou direita) da célula mesclada.

insertRight

boolean

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 da qual excluir linhas.

cellLocation

object (TableCellLocation)

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

A linha que esta célula abrange 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 a 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 da qual 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 a exclusão, a tabela inteira será excluída.

ReplaceAllTextRequest

Substitui todas as ocorrê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 substituirá o texto correspondente.

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 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 herdados vazios 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 PageElement.transform para mais detalhes.

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 de 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 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 da apresentação que devem ser movidos. Os slides dessa lista devem estar na ordem da apresentação, sem cópias.

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 estiver presente, o objectId deve se referir a uma tabela.

textRange

object (Range)

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

Sempre há um caractere de nova linha implícito no final do texto de uma célula de tabela ou forma que não possa ser excluído. Range.Type.ALL usará os limites corretos, mas tenha 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.

Excluir o texto que ultrapassa um limite de parágrafo pode resultar em alterações nos estilos de parágrafo e nas listas à medida 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 baseado em zero do início da coleção. Obrigatório para FIXED_RANGE e FROM_START_INDEX intervalos.

endIndex

integer

O índice opcional baseado 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. Não use esse valor.
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. A endIndex não deve ser especificado.
ALL Define o intervalo como todo o comprimento 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 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.

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.

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

A 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 uma das seguintes opções:
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 de acesso público 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 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.

elementProperties

object (PageElementProperties)

As propriedades do elemento para o vídeo.

A PageElementProperties.size é opcional. Se você não especificar um tamanho, um tamanho padrão será escolhido pelo servidor.

A PageElementProperties.transform é opcional. A transformação não pode ter componentes de distorção. 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 deste 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 Acesse arquivos de link compartilhado 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 do Planilhas Google.

linkingMode

enum (LinkingMode)

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

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 que não estiver 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 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.

elementProperties

object (PageElementProperties)

As propriedades do elemento da linha.

lineCategory
(deprecated)

enum (Category)

A categoria da linha a ser criada.

Descontinuado : use category como alternativa.

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

Se você especificar um category e um lineCategory, os category tem prioridade.

category

enum (LineCategory)

A categoria da linha a ser criada.

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

Se você especificar um category e um lineCategory, os category tem prioridade.

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

Se você não especificar nenhum dos dois, então STRAIGHT é usado.

Categoria

As categorias de linha.

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

RefreshSheetsChartRequest

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

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

Atualizar as propriedades de uma 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. A raiz shapeProperties está implícito e não deve ser especificado. Um único "*" 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 forma, defina fields para "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 único "*" pode ser usado como uma forma abreviada para listar todos os campos.

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

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

UpdateVideoPropertiesRequest

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 ao qual 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. A raiz videoProperties está implícito e não deve ser especificado. Um único "*" pode ser usado como uma forma abreviada para listar todos os campos.

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

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

UpdatePagePropertiesRequest

Atualiza as propriedades de um Page:

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

string

O ID do objeto da página à 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. A raiz pageProperties está implícito e não deve ser especificado. Um único "*" 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 para "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

Atualizar as propriedades de uma TableCell:

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

string

O ID de 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. A raiz tableCellProperties 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 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 sem definição.

TableRange

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

É importante observar que as células especificadas por um intervalo de tabela não necessariamente formam 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 da tabela com localização = (0, 0), período da linha = 3 e período da coluna = 2 especifica as seguintes células:

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

object (TableCellLocation)

O local inicial do intervalo da tabela.

rowSpan

integer

A extensão da linha do intervalo da tabela.

columnSpan

integer

A extensão 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 à qual a atualização é aplicada.

lineProperties

object (LineProperties)

As propriedades da linha a ser atualizada.

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 uma forma abreviada 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 sem definição.

CreateParagraphBulletsRequest

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

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

Se o parágrafo imediatamente anterior à atualização estiver em uma lista com uma predefinição correspondente, os parágrafos que estão sendo atualizados serão adicionados à 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 marcadores a serem usados. O padrão é BULLET_DISC_CIRCLE_SQUARE predefinida.

BulletGlyphPreset

Padrões predefinidos de glifos de marcador 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 número 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 símbolo de marcador para os três primeiros níveis de aninhamento da lista.
BULLET_DIAMONDX_ARROW3D_SQUARE Uma lista com marcadores DIAMONDX, ARROW3D e SQUARE símbolo de marcador para os três primeiros níveis de aninhamento da lista.
BULLET_CHECKBOX Uma lista com marcadores CHECKBOX marcadores de marcadores para todos os níveis de aninhamento de lista.
BULLET_ARROW_DIAMOND_DISC Uma lista com marcadores ARROW, DIAMOND e DISC símbolo de marcador 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 símbolo de marcador 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 DIGIT, ALPHA e ROMAN glifos numéricos para os primeiros três níveis de aninhamento de lista, 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 de aninhamento anterior como prefixo. Por exemplo: "1.", "1.1.", "2.", "2.2.".
NUMBERED_UPPERALPHA_ALPHA_ROMAN Uma lista numerada com UPPERALPHA, ALPHA e ROMAN glifos numéricos para os primeiros três níveis de aninhamento de lista, seguidos por pontos.
NUMBERED_UPPERROMAN_UPPERALPHA_DIGIT Uma lista numerada com UPPERROMAN, UPPERALPHA e DIGIT glifos numéricos para os primeiros três níveis de aninhamento de lista, 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)

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 nenhum deles for especificado, será usado CENTER_INSIDE.

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 caso seja fornecido 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 aos quais as formas precisam corresponder para serem substituídas. criteria pode ser apenas uma das seguintes opções:
containsText

object (SubstringMatchCriteria)

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

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 de comprimento. O próprio URL é salvo com a imagem e exposto por meio da Image.source_url .

ReplaceMethod

O método de substituição.

Enums
CENTER_INSIDE Redimensiona 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 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. Não use esse valor.
CENTER_INSIDE Redimensiona 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 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.

DuplicateObjectRequest

Duplica um slide ou elemento de 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 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. Este mapa define como os IDs de objetos duplicados são gerados: as chaves são os IDs dos objetos originais e seus valores são os IDs que serão atribuídos ao objeto duplicado correspondente. O ID da cópia do objeto de origem também pode ser especificado neste mapa, usando o mesmo valor do atributo objectId campo como chave e o ID recém-desejado como o valor.

Todas as chaves precisam corresponder aos IDs da apresentação. Todos os valores precisam ser exclusivos na apresentação e 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 tamanho do novo ID não pode ser menor que 5 nem maior que 50.

Se algum ID dos 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)

A localização 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 herdado.

Certas mudanças no estilo de texto podem causar outras alterações para espelhar o comportamento do editor das Apresentações. Consulte a documentação 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. 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 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 fornecidos pelo gráfico do Planilhas Google fornecido. O gráfico será dimensionado e centralizado para caber nos limites da forma original.

OBSERVAÇÃO: a substituição de formas por um gráfico exige pelo menos um dos escopos sheet.readonly, bulksheet, de drive.readonly ou de 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 substituirá todas as formas que contêm o texto fornecido.

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. Quando não especificado, o gráfico é uma imagem não vinculada.

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 caso seja fornecido 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 que não estiver 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.

DeleteParagraphBulletsRequest

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á visualmente preservado com a adição de 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 do qual os marcadores serão excluídos.

cellLocation

object (TableCellLocation)

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

textRange

object (Range)

O intervalo de texto do qual os marcadores serão excluídos, com base no TextElement índices.

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)

A localização 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, ela não poderá.

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 único "*" pode ser usado como uma forma abreviada para listar todos os campos.

Por exemplo, para atualizar o alinhamento do parágrafo, defina fields para "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 de 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 não for especificado, as atualizações serão aplicadas à tabela inteira.

borderPosition

enum (BorderPosition)

A posição da borda no intervalo da tabela ao qual 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 de borda da tabela a serem atualizadas.

fields

string (FieldMask format)

Os campos que precisam ser atualizados.

É necessário especificar pelo menos um campo. A raiz tableBorderProperties 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 de preenchimento sólida da borda da tabela, defina fields para "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 Bordas 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 de objeto da tabela.

columnIndices[]

integer

A lista de índices baseados em zero que especifica quais colunas atualizar. 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. A raiz tableColumnProperties 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 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 baseados em zero que especifica quais linhas atualizar. Se nenhum índice for informado, todas as linhas da tabela serão atualizadas.

tableRowProperties

object (TableRowProperties)

As propriedades da linha da tabela a ser atualizada.

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 uma forma abreviada para listar todos os campos.

Por exemplo, para atualizar a altura mínima da linha, defina fields para "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 de objeto da tabela.

tableRange

object (TableRange)

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

A mesclagem de todas as células mescladas neste intervalo será cancelada. Além disso, as células já mescladas 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 ao qual 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 de texto alternativo atualizada do elemento de página. Se não for definido, o valor atual será mantido. A descrição é exposta a leitores de tela e outras interfaces de acessibilidade. Use apenas valores legíveis relacionados ao conteúdo do elemento de 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 recuperado com a resposta de uma solicitação GET.

imageReplaceMethod

enum (ImageReplaceMethod)

O método de substituição.

Campo de união image_source: O tipo de origem da imagem. image_source pode ser apenas uma das seguintes opções:
url

string

O URL da imagem.

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

O URL fornecido não pode ultrapassar 2 KB de comprimento. 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 ao qual 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" está implícito e não deve ser especificado. Um único "*" pode ser usado como uma forma abreviada para listar todos os campos.

Por exemplo, para atualizar se um slide foi pulado, defina fields para "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 o início.
BRING_FORWARD Traz os elementos de página para a frente na página por um elemento em relação ao que está mais à frente nos elementos de página 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 exato line type é determinado com base na categoria que vai receber a atualização e em como ele é direcionado 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 inicial e final da linha precisam estar em elementos de página diferentes.