Com a API Google Slides, você pode criar e modificar arquivos do 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 do cliente de um banco de dados e combiná-los com modelos predefinidos e com 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 receber e atualizar elementos dentro da apresentação.
A maior parte do seu trabalho com a API Slides provavelmente será de criação e atualização de 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 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 ver mais detalhes. Consulte os guias de primeiros passos para ver um exemplo simples e completo de como usar a API.
A estrutura de uma apresentação
Uma apresentação da API Slides é composta por páginas, que contêm elementos de página.
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 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.
As páginas e os 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 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 funcionam como um modelo de como os elementos da página serão organizados por padrão nos slides usando um layout. Cada layout é associado a um mestre. |
| Slides | Essas páginas têm o conteúdo que você está apresentando ao 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 com as anotações do apresentador do slide. Cada slide tem uma página de anotações correspondente. Somente o texto na forma das anotações do apresentador pode ser modificado com a API Slides. |
| Mestres das notas | Os mestres das notas 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 | Um gráfico importado para as Apresentações. |
| Video | Um vídeo importado para as Apresentações. |
| Linhas | Uma linha, curva ou conector visual. |
| Tabela | Uma grade de conteúdo. |
| WordArt | Um elemento de texto visual que se comporta mais como uma forma. |
| Gráfico das Planilhas | 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) seja gravada.
O método batchUpdate usa 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 a seguir o detalhamento dos tipos de solicitações, agrupados em diferentes categorias.
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 objeto
Uma apresentação da Slides API é composta por páginas e elementos de página. Esses objetos incluem uma string de ID de objeto que é exclusiva em uma apresentação.
Como especificar IDs de objetos na criação
Ao criar páginas ou elementos de página usando o método batchUpdate, você tem a opção de especificar um código para o novo objeto. Com isso, é possível criar um objeto e modificá-lo na mesma solicitação batchUpdate, o que minimiza o número de chamadas para a API Slides e reduz 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 o aplicativo quiser rastrear os objetos por um período mais longo, não confie no ID do objeto, porque ele pode mudar. Consulte a seção a seguir para saber mais.
Como acompanhar objetos sem usar o ID de objeto
Quando você faz uma solicitação à Slides API, o ID do objeto costuma ser 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, não é possível garantir 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 terá um novo ID exclusivo, e o ID fornecido pela API será perdido. Como resultado, não recomendamos armazenar IDs de objeto no armazenamento do seu aplicativo. Em vez disso, você deve encontrar objetos na apresentação pelo conteúdo textual ou pelo texto alternativo.
Apresentações recém-criadas normalmente usam um conjunto consistente de IDs para slides, mestres e caixas de texto padrão. 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().