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