Operações de apresentação

A Google Slides API permite criar arquivos de apresentação e gerenciar os existentes. 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 diferentes idiomas usando as bibliotecas de cliente da API 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 Presentation".

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.

Confira 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 fornece 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 seu 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.

Confira a seguir o protocolo de solicitação para listar os arquivos de apresentação:

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 o texto em toda a apresentação

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

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 em arquivos mestres. Nesse caso, a substituição do texto diferencia maiúsculas de minúsculas ao definir 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."
      }
    }
  ]
}