Introdução

Com a API Google Slides, você pode criar e modificar apresentações Google.

Os apps podem ser integrados à API Google Slides para criar automaticamente belas apresentações de slides com dados fornecidos pelo usuário e pelo sistema. Por exemplo, é possível usar detalhes de clientes de um banco de dados e combiná-los com modelos predefinidos e opções de configuração selecionadas para criar apresentações concluídas em uma fração do tempo que levaria para criá-las manualmente.

Visão geral da API

A coleção presentations oferece métodos que permitem acessar e atualizar elementos dentro da apresentação.

A maior parte do seu trabalho com a API Slides provavelmente será criar e atualizar apresentações. Para isso, use o método batchUpdate. Esse método usa uma lista de objetos Request que permitem fazer coisas como:

  • Criar slides
  • Adicionar elementos aos slides, como formas ou tabelas
  • Inserir, alterar e remover texto
  • Aplicar transformações a elementos
  • Mudar a ordem dos slides

Consulte Atualizações em lote para mais detalhes. Consulte os guias de iniciação para ver um exemplo completo e simples de como usar a API.

A estrutura de uma apresentação

Uma apresentação da API Slides é composta de páginas, que contêm elementos.

O ID de uma apresentação pode ser derivado do URL:

https://docs.google.com/presentation/d/presentationId/edit

O ID da apresentação é uma string que contém letras, números e alguns caracteres especiais. A expressão regular a seguir pode ser usada para extrair o ID da apresentação de um URL das Planilhas Google:

/presentation/d/([a-zA-Z0-9-_]+)

Se você conhece a API Drive, o presentationId corresponde ao ID do recurso File.

Páginas e elementos de página são identificados por IDs de objeto.

Pages

O Apresentações Google tem os seguintes tipos de página:

Mestrado Os slides mestres definem os estilos de texto, o plano de fundo e os elementos de página padrão que aparecem em todos os slides que usam esse mestre. Os elementos de página que precisam aparecer em todos os slides precisam ser adicionados ao mestre. A maioria das apresentações tem um mestre, mas algumas podem ter vários ou nenhum.
Layouts Os layouts servem como um modelo para organizar os elementos da página por padrão nos slides usando um layout. Cada layout está associado a um mestre.
Apresentações Essas páginas contêm o conteúdo que você apresenta para o público. A maioria dos slides se baseia em um mestre e um layout. Você pode especificar qual layout usar para cada slide quando ele for criado.
Observações Essas páginas têm o conteúdo dos folhetos da apresentação, incluindo uma forma que contém as anotações do apresentador do slide. Cada slide tem uma página de anotações correspondente. Só o texto na forma das anotações do apresentador pode ser modificado com a API Slides.
Mestres das notas As notas mestres definem os estilos de texto e os elementos padrão de todas as páginas de notas. Os mestres de notas estão disponíveis somente para leitura na API Slides.

Elementos de página

Os elementos de página são os componentes visuais colocados nas páginas. A API expõe vários tipos de elementos de página:

Grupo Um conjunto de elementos de página tratados como uma unidade individual. Eles podem ser movidos, dimensionados e girados juntos.
Forma Um objeto visual simples, como retângulos, elipses e caixas de texto. As formas podem conter texto, por isso são os elementos de página mais comuns na criação de slides.
Imagem Uma imagem importada para o Apresentações.
Video Um vídeo importado para as Apresentações.
Linhas Linha, curva ou conector visual.
Tabela Uma grade de conteúdo.
WordArt Um elemento de texto visual que se comporta mais como uma forma.
SheetsChart Um gráfico do Planilhas Google importado para o Apresentações.

Atualizações em lote

O método batchUpdate permite atualizar muitos aspectos de uma apresentação. As alterações são agrupadas em um lote para que, se uma solicitação falhar, nenhuma das outras (possivelmente dependentes) será gravada.

O método batchUpdate processa um ou mais objetos Request, cada um especificando um único tipo de solicitação a ser executada. Há muitos tipos diferentes de solicitações. Veja os tipos de solicitações agrupados em diferentes categorias.

Como trabalhar com as Apresentações: CreateSlideRequest
UpdateSlidesPositionRequest
DuplicateObjectRequest
UpdatePagePropertiesRequest
DeleteObjectRequest
Como trabalhar com elementos de página: CreateShapeRequest
CreateLineRequest
UpdatePageElementTransformRequest
UpdateShapePropertiesRequest
DuplicateObjectRequest
DeleteObjectRequest
Como trabalhar com tabelas: CreateTableRequest
InsertTableRowsRequest
InsertTableColumnsRequest
DeleteTableRowRequest
DeleteTableColumnRequest
UpdateTableRowPropertiesRequest
UpdateTableColumnPropertiesRequest
UpdateTableBorderPropertiesRequest
UpdateTableCellPropertiesRequest
MergeTableCellsRequest
UnmergeTableCellsRequest
DeleteObjectRequest
Como trabalhar com gráficos: CreateSheetsChartRequest
RefreshSheetsChartRequest
ReplaceAllShapesWithSheetsChartRequest
DeleteObjectRequest
Como trabalhar com imagens e vídeos: CreateImageRequest
CreateVideoRequest
UpdateImagePropertiesRequest
UpdateVideoPropertiesRequest
ReplaceAllShapesWithImageRequest
DuplicateObjectRequest
DeleteObjectRequest
Como trabalhar com texto: InsertTextRequest
DeleteTextRequest
ReplaceAllTextRequest
CreateParagraphBulletsRequest
DeleteParagraphBulletsRequest
UpdateTextStyleRequest
UpdateParagraphStyleRequest

O método batchUpdate retorna um corpo de resposta, que contém uma Resposta para cada solicitação. Cada resposta ocupa o mesmo índice que a solicitação correspondente. Para solicitações sem resposta aplicável, a resposta nesse índice fica vazia. As diversas solicitações Create normalmente têm respostas para que você saiba o ID do objeto recém-adicionado.

Como trabalhar com IDs de objetos

Uma apresentação da API Slides é composta de páginas e elementos de página. Esses objetos incluem uma string de ID de objeto exclusiva em uma apresentação.

Especificar IDs de objetos na criação

Ao criar páginas ou elementos de página usando o método batchUpdate, você também tem a opção de especificar um ID para o novo objeto. Isso permite que você crie um objeto e o modifique na mesma solicitação batchUpdate, minimizando o número de chamadas para a API Slides e o uso da cota.

Na maioria dos casos, recomendamos gerar um ID de objeto aleatório. Por exemplo, se você estiver usando Java, java.util.UUID.randomUUID().toString() funcionará bem.

Quando seu aplicativo quiser monitorar os objetos por um período mais longo, não dependa do ID do objeto, porque ele pode mudar. Consulte a seção a seguir para saber mais.

Manter o controle dos objetos sem usar o ID do objeto

Quando você faz uma solicitação da Slides API, o ID do objeto normalmente é preservado. As exceções são mencionadas na documentação de referência do método. Fazer uma cópia de uma apresentação inteira com a API Drive também preserva os IDs de objetos.

No entanto, você não pode depender de que um ID de objeto não seja inalterado depois que uma apresentação for alterada na IU das Apresentações. Por exemplo, se alguém usar a IU das Apresentações para copiar e colar um elemento de página e depois excluir o original, esse elemento vai ter um novo ID exclusivo, e o ID informado anteriormente pela API será perdido. Como resultado, não recomendamos que você armazene IDs de objeto no armazenamento do seu aplicativo. Em vez disso, você deve encontrar objetos na apresentação pelo conteúdo de texto ou texto alternativo.

Apresentações recém-criadas normalmente usam um conjunto consistente de IDs para slides padrão, mestres e caixas de texto. Esses IDs estão sujeitos a mudanças ao longo do tempo, por isso não recomendamos depender desse recurso. Em vez disso, encontre os elementos que você quer modificar usando o objeto de apresentação retornado por chamadas para create() ou get().