A API Google Slides permite criar, mover e excluir slides. Os exemplos em
esta página mostram algumas operações de slide comuns usando a
presentations.batchUpdate
.
Esses exemplos usam as seguintes variáveis:
- PRESENTATION_ID: indica onde você fornece apresentação ID. Você pode descobrir o valor desse ID no URL da apresentação.
- PAGE_ID e PAGE_ID2: indica onde você fornece o objeto "page" do Google Ads. Você pode recuperar o valor dele no URL ou usando uma solicitação de leitura da API.
Esses exemplos são apresentados como solicitações HTTP para serem neutros em relação à linguagem. Para saber como implementar uma atualização em lote em idiomas diferentes usando a API do Google bibliotecas de clientes, consulte os seguintes guias: Criar uma slide e Adicionar formas e em texto.
Copiar um slide
O seguinte
presentations.batchUpdate
um exemplo de código mostra como usar a
DuplicateObjectRequest
para copiar um slide e inseri-lo após o original na apresentação.
O slide original é especificado por PAGE_ID.
A solicitação permite especificar se alguns ou todos os IDs de elementos da página devem estar em a cópia (com alguns restrições). Neste exemplo, o slide original contém um elemento de tabela (especificado pelo TABLE_ELEMENT_ID), que é mapeada para uma nova tabela (especificada pelo COPY_TABLE_ELEMENT_ID) no texto do slide (especificado pelo COPY_PAGE_ID). Todos os outros elementos da cópia recebem dados aleatórios do Google Ads.
Para mais informações sobre como copiar um
PageElement
,
incluindo caixas de texto, imagens, tabelas, formas básicas, linhas e vídeos incorporados,
consulte o exemplo Copiar e editar um
elemento.
Confira a seguir o protocolo de solicitação para copiar um slide:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "duplicateObject": { "objectId": PAGE_ID, "objectIds": { "PAGE_ID": "COPY_PAGE_ID", "TABLE_ELEMENT_ID": "COPY_TABLE_ELEMENT_ID" } } } ] }
Criar um slide
O seguinte
presentations.batchUpdate
um exemplo de código mostra como usar a
CreateSlideRequest
para criar um slide e inseri-lo como o quarto slide (usando o método
insertionIndex
) na apresentação.
O novo slide está configurado para usar o
PredefinedLayout
de TITLE_AND_TWO_COLUMNS
. Você pode especificar uma string para usar
PAGE_ID para o slide (com alguns
restrições),
ou permitir que a API gere o PAGE_ID omitindo o campo.
na solicitação.
Confira a seguir o protocolo de solicitação para criar um slide:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "createSlide": { "objectId": "PAGE_ID", "insertionIndex": 3, "slideLayoutReference": { "predefinedLayout": "TITLE_AND_TWO_COLUMNS" } } } ] }
Criar um slide e modificar marcadores de posição
O seguinte
presentations.batchUpdate
um exemplo de código mostra como usar a
CreateSlideRequest
método para criar um slide usando o
PredefinedLayout
de TITLE_AND_TWO_COLUMNS
.
Você pode especificar uma string para usar como o PAGE_ID do slide.
(com algumas
restrições).
A
placeholderIdMappings
usa o
Type
de
TITLE
. O TITLE_ID faz referência à forma do marcador de posição do slide
para que ele possa ser modificado.
Confira a seguir o protocolo de solicitação para criar um slide e modificar marcadores de posição:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "createSlide": { "objectId": PAGE_ID, "slideLayoutReference": { "predefinedLayout": "TITLE_AND_TWO_COLUMNS" }, "placeholderIdMappings": [ { "layoutPlaceholder": { "type": "TITLE", "index": 0 }, "objectId": TITLE_ID, }, ], } }, { "insertText": { "objectId": TITLE_ID, "text": "This is my slide title", } }, ] }
Mover slides para outra posição
O seguinte
presentations.batchUpdate
um exemplo de código mostra como usar a
UpdateSlidesPositionRequest
para pegar os dois slides especificados e movê-los para o início da
apresentação, mantendo sua ordem relativa.
Os IDs de slide especificados (PAGE_ID e PAGE_ID2)
devem ser fornecidos na ordem existente da apresentação, sem duplicatas. A
insertionIndex
baseado em zero indica onde os slides devem ser inseridos, com base
no pedido antes da movimentação. O valor deve estar entre zero e
número de slides da apresentação, inclusive.
Confira a seguir o protocolo de solicitação para mover slides para uma nova posição:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "updateSlidesPosition": { "slideObjectIds": [ PAGE_ID, PAGE_ID2 ], "insertionIndex": 0 } } ] }
Definir a imagem de plano de fundo de um slide
O seguinte
presentations.batchUpdate
um exemplo de código mostra como usar a
UpdatePagePropertiesRequest
para definir a imagem de plano de fundo de um slide especificado pelo
PAGE_ID. A API recupera a imagem usando o
IMAGE_URL:
Uma máscara de campo é usada para especificar que apenas o o plano de fundo do slide deve ser alterado para preservar as outras propriedades. Usando o campo máscaras também melhora o desempenho.
Como alternativa, um método UpdatePagePropertiesRequest
pode ser usado para definir a
plano de fundo de um slide para uma cor sólida.
Confira a seguir o protocolo de solicitação para definir a imagem de plano de fundo de um slide:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "updatePageProperties": { "objectId": PAGE_ID, "pageProperties": { "pageBackgroundFill": { "stretchedPictureFill": { "contentUrl": IMAGE_URL } } }, "fields": "pageBackgroundFill" } } ] }
Gerar miniatura
Você pode gerar uma miniatura da versão mais recente de uma página específica no
apresentação chamando
presentations.pages.getThumbnail
, que retorna uma imagem em miniatura da página como um URL de conteúdo. A imagem
O URL tem uma vida útil padrão de 30 minutos.
Também é possível especificar os mimeType
e thumbnailSize
retornados usando o
ThumbnailProperties
como parâmetro de consulta.
Veja a seguir o protocolo de solicitação para gerar a miniatura da página com o parâmetro
ThumbnailProperties
definido:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID/thumbnail?thumbnailProperties.mimeType=PNG&thumbnailProperties.thumbnailSize=MEDIUM
{ "width": 800, "height": 450, "contentUrl": "CONTENT_URL" }