Esta página foi traduzida pela API Cloud Translation.

Operações de slides

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"
}