Google Slides
Visão geral
Seção intitulada “Visão geral”Google Slides é um editor de apresentações baseado em nuvem com colaboração em tempo real, galeria de templates e integração com outros aplicativos do Google Workspace. Com a integração no SquadOS, seus agentes podem criar apresentações do zero, editar slides existentes, copiar modelos e gerar thumbnails de páginas de forma automatizada.
- Site oficial: https://slides.google.com/
- Documentação na Composio: docs.composio.dev/toolkits/googleslides
Autenticação
Seção intitulada “Autenticação”Esta ferramenta utiliza OAuth 2.0 (OAUTH2) para conectar.
A autenticação é feita pelo fluxo OAuth padrão do Google — você autoriza o acesso à sua conta Google diretamente na página segura da Composio, sem precisar gerar chaves manualmente.
Como conectar no SquadOS
Seção intitulada “Como conectar no SquadOS”- Acesse Ferramentas no menu lateral (
/admin/tools). - Abra a aba Disponíveis e procure por
Google Slides. - Clique no card para abrir o modal de detalhes e em Conectar.
- Você é levado para a página de conexão segura hospedada pela Composio, onde autoriza o acesso à sua conta Google (OAuth).
- Ao concluir, você volta para o SquadOS com a conta conectada e a ferramenta disponível para os agentes. (Detalhes do fluxo em Ferramentas da Organização.)
Perguntas frequentes
Seção intitulada “Perguntas frequentes”Como configurar credenciais OAuth personalizadas para o Google Slides?
Seção intitulada “Como configurar credenciais OAuth personalizadas para o Google Slides?”Para usar seu próprio aplicativo OAuth em vez do app padrão da Composio, consulte o guia Como criar credenciais OAuth2 para Apps Google.
Por que estou vendo “App está bloqueado” ao conectar o Google Slides?
Seção intitulada “Por que estou vendo “App está bloqueado” ao conectar o Google Slides?”O cliente OAuth está solicitando escopos que o Google ainda não verificou para aquele cliente. Isso geralmente ocorre ao adicionar escopos extras além dos padrões. Remova os escopos adicionais da configuração de auth ou crie seu próprio app OAuth e submeta os escopos para verificação. Consulte Como criar credenciais OAuth2 para Apps Google.
Por que estou recebendo o erro “Google Slides API has not been used in project”?
Seção intitulada “Por que estou recebendo o erro “Google Slides API has not been used in project”?”Ao usar credenciais OAuth personalizadas, a API do Google Slides precisa estar habilitada no projeto do Google Cloud que possui essas credenciais. Habilite-a no Google Cloud Console em APIs e Serviços, aguarde alguns minutos e tente novamente.
Por que estou recebendo “Error 400: invalid_scope”?
Seção intitulada “Por que estou recebendo “Error 400: invalid_scope”?”Os escopos solicitados são inválidos ou estão com formato incorreto na URL de autorização. Verifique os valores de escopo na documentação de escopos OAuth do Google.
Por que a tela de consentimento OAuth mostra “Composio” em vez do meu app?
Seção intitulada “Por que a tela de consentimento OAuth mostra “Composio” em vez do meu app?”Por padrão, a tela de consentimento usa o app OAuth da Composio. Para exibir o nome e logotipo do seu próprio app, crie um app OAuth próprio e defina uma URL de redirecionamento personalizada. Consulte a documentação de white-labeling de autenticação.
Por que estou recebendo erros 401 nas chamadas de ferramentas?
Seção intitulada “Por que estou recebendo erros 401 nas chamadas de ferramentas?”O token de acesso do usuário não é mais válido. Causas comuns: o usuário revogou o acesso, alterou senha ou 2FA, uma política de administrador do Workspace mudou, ou o limite de tokens de atualização do Google (~50 por conta) foi excedido. Reautenticar o usuário normalmente resolve o problema.
Por que estou recebendo “Quota Exhausted” ou “rate limit exhausted”?
Seção intitulada “Por que estou recebendo “Quota Exhausted” ou “rate limit exhausted”?”O Google aplica cotas por minuto e diárias para requisições. Se você estiver usando o app OAuth padrão da Composio, compartilha essa cota com outros usuários, o que pode fazer com que os limites sejam atingidos mais rapidamente. Use suas próprias credenciais OAuth para obter uma cota dedicada e adicione retentativas com backoff exponencial para lidar com limites transitórios.
Ações disponíveis
Seção intitulada “Ações disponíveis”Criar apresentação do Google Slides
Seção intitulada “Criar apresentação do Google Slides”GOOGLESLIDES_CREATE_PRESENTATION
Cria uma apresentação em branco no Google Slides. Use quando precisar inicializar uma nova apresentação com título, idioma ou tamanho de página específicos.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
title | string | Não | O título da apresentação. Se omitido, a API usa um título padrão. |
locale | string | Não | O idioma da apresentação, como tag IETF BCP 47 (ex.: en-US, fr-FR, ja-JP). Se omitido, a API usa um idioma padrão. |
pageSize | object | Não | O tamanho de página da apresentação. |
presentationId | string | Não | O ID a usar para a nova apresentação. Se fornecido, é usado como ID da nova apresentação; caso contrário, um novo ID é gerado automaticamente. Deve estar no formato de ID válido do Google Drive/Slides (string alfanumérica longa). IDs legíveis por humanos (ex.: my-presentation) não são válidos e causam erros de API. Forneça apenas se tiver um ID no formato correto do Google Drive/Slides; caso contrário, omita para deixar a API gerar um. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Criar slides a partir de Markdown
Seção intitulada “Criar slides a partir de Markdown”GOOGLESLIDES_CREATE_SLIDES_MARKDOWN
Cria uma nova apresentação do Google Slides a partir de texto Markdown. Divide automaticamente o conteúdo em slides usando separadores --- e aplica templates apropriados com base na estrutura do conteúdo.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
title | string | Sim | O título para a nova apresentação do Google Slides. |
markdown_text | string | Sim | O conteúdo dos slides, formatado como Markdown. SELEÇÃO DE TEMA: adicione Theme: nome no início do markdown. Temas disponíveis: default, corporate_blue, modern_dark, professional_gray, creative_purple, warm_orange, forest_green, minimal_beige. SEPARAÇÃO DE SLIDES: use --- (em linha própria) para separar slides — cada slide detecta seu tipo automaticamente. TIPOS DE SLIDE: 1. Slide título (primeiro slide): # Título Texto de subtítulo 2. Slides de marcadores: use -, * ou caracteres de marcador 3. Slides de tabela: tabelas markdown padrão 4. Slides de citação: > Texto da citação 5. Slides de texto: parágrafos comuns 6. Slides de imagem:  7. Slides de duas colunas: use ` |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter thumbnail de página v2
Seção intitulada “Obter thumbnail de página v2”GOOGLESLIDES_GET_PAGE_THUMBNAIL2
Gera um thumbnail da versão mais recente de uma página específica. Use quando precisar de uma URL de imagem de prévia de um slide. Esta requisição conta como uma leitura cara para fins de cota.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
pageObjectId | string | Sim | O ID de objeto da página cujo thumbnail deve ser recuperado. |
presentationId | string | Sim | O ID da apresentação a recuperar. |
thumbnailProperties.mimeType | string | Não | O tipo MIME opcional da imagem de thumbnail. Por padrão, PNG se não especificado. |
thumbnailProperties.thumbnailSize | string (THUMBNAIL_SIZE_UNSPECIFIED | LARGE | MEDIUM | SMALL) | Não | O tamanho opcional da imagem de thumbnail. LARGE = 1600 px, MEDIUM = 800 px, SMALL = 200 px. Por padrão, LARGE se não especificado. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Atualizar apresentação (lote/Markdown)
Seção intitulada “Atualizar apresentação (lote/Markdown)”GOOGLESLIDES_PRESENTATIONS_BATCH_UPDATE
Atualiza apresentações do Google Slides usando conteúdo Markdown ou texto bruto da API. Suporta temas profissionais, formatação automática e vários tipos de slide (título, marcadores, tabela, citação, imagem, duas colunas).
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
requests | array | Não | Lista de requisições de atualização, cada uma sendo um dicionário com um dos tipos válidos de requisição da API do Slides: createSlide, createShape, createTable, createImage, insertText, updateTextStyle, updateShapeProperties, updatePageProperties, updateParagraphStyle, deleteObject, updateTableCellProperties, updateTableColumnProperties, replaceAllText. Para atualizar fundos de slides, use updatePageProperties (NÃO updateSlideProperties). O campo pageBackgroundFill existe em PageProperties, não em SlideProperties. Obrigatório se markdown_text não for fornecido. |
writeControl | object | Não | Opções que controlam como as requisições de escrita são executadas. |
markdown_text | string | Não | Conteúdo Markdown para adicionar como novos slides a uma apresentação existente. Separe slides com \n---\n. Cada slide detecta seu tipo a partir do conteúdo. Tipos de slide: título (# Título\nSubtítulo), marcadores (-/+/*), tabelas (tabelas markdown), citações (> texto), imagens (), duas colunas (separador ` |
presentationId | string | Sim | O ID da apresentação à qual aplicar as atualizações. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Copiar apresentação do Google Slides a partir de modelo
Seção intitulada “Copiar apresentação do Google Slides a partir de modelo”GOOGLESLIDES_PRESENTATIONS_COPY_FROM_TEMPLATE
Cria uma nova apresentação do Google Slides duplicando um deck modelo existente via cópia de arquivo no Drive. Use quando precisar preservar temas, masters e layouts exatamente como estão no modelo. Após a cópia, use GOOGLESLIDES_PRESENTATIONS_BATCH_UPDATE para substituir textos ou imagens de placeholder.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
new_title | string | Não | O nome/título para a apresentação copiada. Se omitido, um nome padrão como Copy of [original] é usado. |
parent_folder_id | string | Não | O ID da pasta de destino no Google Drive. Se fornecido, a apresentação copiada será colocada nessa pasta. Se omitido, a cópia é colocada na pasta raiz do usuário. |
template_presentation_id | string | Sim | O ID de arquivo do Drive do modelo do Slides a ser copiado. Este é o presentationId do deck existente que você quer duplicar. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter apresentação
Seção intitulada “Obter apresentação”GOOGLESLIDES_PRESENTATIONS_GET
Recupera a versão mais recente de uma apresentação. Use após obter o ID da apresentação.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
fields | string | Não | Seletor separado por vírgulas especificando quais campos incluir na resposta parcial. Campos aninhados usam parênteses que devem estar corretamente balanceados. Campos de nível superior: presentationId, title, locale, revisionId, pageSize, slides, masters, layouts, notesMaster. Para slides/masters/layouts, campos válidos de Page: objectId, pageType, pageElements, pageProperties, revisionId. Para pageElements, campos válidos: objectId, size, transform, title, description, shape, image, video, line, table, wordArt, elementGroup, sheetsChart, speakerSpotlight. Para shape, campos válidos: shapeType, text, shapeProperties, placeholder. Nota: autofit fica em shapeProperties, não diretamente em shape. Use shape(shapeProperties(autofit)), não shape(autofit). Exemplos: presentationId,title, slides(objectId,pageElements(objectId,size)). |
presentationId | string | Não | O ID da apresentação a recuperar. presentationId ou presentationName deve ser fornecido. |
presentationName | string | Não | O nome da apresentação a pesquisar e recuperar. Se fornecido, a ação buscará no Google Drive uma apresentação com esse nome. presentationId ou presentationName deve ser fornecido. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter página da apresentação
Seção intitulada “Obter página da apresentação”GOOGLESLIDES_PRESENTATIONS_PAGES_GET
Recupera a versão mais recente de uma página específica de uma apresentação. Use quando precisar inspecionar detalhes de slide, layout, master ou página de notas.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
pageObjectId | string | Sim | O ID de objeto da página a recuperar. |
presentationId | string | Sim | O ID da apresentação da qual buscar a página. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter thumbnail de página (Descontinuado)
Seção intitulada “Obter thumbnail de página (Descontinuado)”GOOGLESLIDES_PRESENTATIONS_PAGES_GET_THUMBNAIL
DESCONTINUADO: use GOOGLESLIDES_GET_PAGE_THUMBNAIL2 no lugar. Gera e retorna a URL de uma imagem de thumbnail para uma página específica. Use quando precisar de uma prévia rápida de um slide após carregá-lo.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
pageObjectId | string | Sim | O ID de objeto da página cujo thumbnail deve ser recuperado. |
presentationId | string | Sim | O ID da apresentação que contém a página. |
thumbnailProperties.mimeType | string | Não | Tipo MIME opcional da imagem de thumbnail. Atualmente apenas PNG é suportado pela API. Por padrão, PNG se omitido. |
thumbnailProperties.thumbnailSize | string (THUMBNAIL_SIZE_UNSPECIFIED | LARGE | MEDIUM | SMALL) | Não | Tamanho opcional do thumbnail. Um de LARGE, MEDIUM, SMALL ou THUMBNAIL_SIZE_UNSPECIFIED. Por padrão, LARGE se omitido. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |