Introdução

A API Google Slides permite criar e modificar apresentações do Apresentações Google.

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

Visão geral da API

O conjunto de apresentações oferece métodos que permitem obter e atualizar elementos dentro da apresentação.

A maior parte do seu trabalho com a Slides API provavelmente será a criação e a atualização apresentações. Você fará isso usando o batchUpdate; esse método pega uma lista de Solicitação que permitem fazer coisas como:

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

Consulte Atualizações em lote para mais detalhes. Consulte os guias para iniciantes para conferir um exemplo simples e completo de como usar a API.

A estrutura de uma apresentação

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

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

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

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

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

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

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-mestre definem os estilos de texto, o plano de fundo e a página padrão que aparecem em todos os slides que usam este mestre. Página elementos que devem aparecer em todos os slides devem ser adicionados ao mestre. Mais frequentes apresentações têm um mestre, mas alguns podem ter vários ou nenhum.
Layouts Os layouts servem como um modelo de como os elementos da página serão organizados por por padrão nos slides que usam um layout. Cada layout está associado a um mestre.
Apresentações Essas páginas incluem o conteúdo que você apresenta ao público. A maioria dos slides é baseada em um mestre e um layout. É possível especificar layout a ser usado em cada slide quando ele for criado.
Observações Essas páginas contêm o conteúdo dos folhetos das apresentações, incluindo uma forma que contém as anotações do orador do slide. Cada slide tem um a página de notas correspondente. Somente o texto na forma de anotações do orador pode ser modificado com a Slides API.
Mestres das notas Os mestres de notas definem os estilos de texto e elementos de página padrão para todos páginas de notas. Na API Slides, os mestres de notas são somente leitura.

Elementos de página

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. Eles podem podem ser movidas, dimensionadas e giradas juntas.
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 para criar slides.
Imagem Uma imagem importada para o app Apresentações.
Vídeo Um vídeo importado para as Apresentações.
Linha Uma linha, curva ou conector visual.
Tabela Uma grade de conteúdo.
WordArt Um elemento de texto visual que se comporta de forma parecida com uma forma.
SheetsChart Um gráfico do Planilhas Google importado para o Apresentações.

Atualizações em lote

Método batchUpdate permite atualizar muitos aspectos de uma apresentação. As mudanças são agrupadas um lote para que, se uma solicitação falhar, nenhuma das outras (possivelmente dependente) alterações são gravadas.

O método batchUpdate pega um ou mais Solicitação objetos, cada um especificando um único tipo de solicitação a ser executada. Existem para muitos tipos diferentes de solicitações. Aqui está um detalhamento dos tipos de solicitações, agrupadas em diferentes categorias.

Trabalhar com 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ídeo: 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 um Resposta para cada solicitação. Cada resposta ocupa o mesmo índice que o solicitação para solicitações sem resposta aplicável, a resposta nesse índice estará vazio. As várias solicitações Create normalmente têm respostas. Portanto, que você saiba o ID do objeto recém-adicionado.

Como trabalhar com IDs de objetos

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

Como especificar IDs de objetos na criação

Ao criar páginas ou elementos de página usando o batchUpdate, como opção, é possível especificar um ID para o novo objeto. Isso permite criar um e modificá-lo dentro da mesma solicitação batchUpdate, minimizando o número de chamadas para a API Slides e reduzir o uso da cota.

Recomendamos gerar um ID de objeto aleatório na maioria dos casos. Por exemplo, se você estiverem usando Java, java.util.UUID.randomUUID().toString() deve funcionar bem.

Quando seu aplicativo deseja rastrear objetos por um período mais longo de tempo, não confie no ID do objeto, porque ele pode mudar. Consulte o seguinte: para mais detalhes.

Como rastrear objetos sem usar o ID de objeto

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

No entanto, não é possível depender de um ID de objeto permanecer inalterado após uma apresentação é alterado na interface do Apresentações. Por exemplo, se alguém usar o Apresentações Google interface para copiar e colar um elemento de página e excluir o original, o elemento de página terá um novo ID exclusivo, e o ID fornecido anteriormente pela API serão perdidos. Por isso, não recomendamos armazenar IDs de objeto em sua o armazenamento do seu aplicativo. Em vez disso, você deve encontrar objetos na apresentação seu conteúdo de texto ou texto alternativo.

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