Operações de apresentação

Com a API Google Slides, você pode criar arquivos de apresentação e gerenciar os atuais. Os exemplos nesta página mostram algumas operações comuns de apresentação de página usando o método presentations.batchUpdate.

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 linguagens diferentes usando as bibliotecas de cliente das APIs do Google, consulte os seguintes guias:

Criar uma apresentação

O exemplo de código presentations.create a seguir mostra como criar um arquivo de apresentação em branco chamado "My New Apresentação".

Também é possível criar arquivos de apresentação em branco usando o método files.create da API Google Drive especificando application/vnd.google-apps.presentation como o tipo MIME.

Veja a seguir o protocolo de solicitação para criar uma apresentação:

POST https://slides.googleapis.com/v1/presentations
{
  "title": "My New Presentation"
}

Listar arquivos de apresentação existentes

A API Slides não oferece um método para recuperar uma lista de apresentações, mas a API Drive oferece. O método files.list (apresentado abaixo) usa máscaras de campo para retornar uma lista de arquivos de apresentação do Drive, com o ID, o nome e um link para abrir o arquivo. A solicitação também especifica application/vnd.google-apps.presentation como o tipo MIME.

Veja a seguir o protocolo de solicitação para listar arquivos de apresentação existentes:

GET https://www.googleapis.com/drive/v3/files?q="mimeType=application/vnd.google-apps.presentation"&fields=files(id,name,webViewLink)

A resposta a essa solicitação tem a seguinte estrutura:

{
 "files": [
    {
     "id": "abcdefghijklmnopqrstuvwxyz0123456789",
     "name": "Project Vision",
     "webViewLink": "https://docs.google.com/a/google.com/presentation/d/abcdefghijklmnopqrstuvwxyz0123456789/edit?usp=drivesdk"
    },
    {
     "id": "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789",
     "name": "Untitled Presentation",
     "webViewLink": "https://docs.google.com/a/google.com/presentation/d/ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789/edit?usp=drivesdk"
    },
    ...
  ]
}

Substituir texto em toda a apresentação

O exemplo de código presentations.batchUpdate a seguir mostra como usar o método ReplaceAllTextRequest para substituir texto em toda a apresentação especificada pelo PRESENTATION_ID. Você pode descobrir o valor do ID da apresentação no URL dela.

Todas as instâncias da string "Gizmo Corp." são substituídas pelo texto "Gadget Inc." Isso inclui texto em caixas de texto e outras formas, em slides e nos mestres. Nesse caso, a substituição do texto diferencia maiúsculas de minúsculas configurando matchCase como true.

Veja a seguir o protocolo de solicitação para substituir texto em toda a apresentação:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "replaceAllText": {
          "containsText": {
            "text": "Gizmo Corp.",
            "matchCase": true
          },
          "replaceText": "Gadget Inc."
      }
    }
  ]
}