Operações de apresentação

Com a API Google Slides, é possível criar arquivos de apresentação e gerenciar os que já existem. 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 ao idioma. Para saber como implementar uma atualização em lote em diferentes linguagens usando as bibliotecas de cliente de 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 "Minha nova 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.

Confira abaixo 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

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 seu Drive, com o ID do arquivo, o nome do arquivo e um link para abrir o arquivo. A solicitação também especifica application/vnd.google-apps.presentation como o tipo MIME.

Confira abaixo o protocolo de solicitação para listar 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 texto em uma apresentação

O exemplo de código presentations.batchUpdate a seguir mostra como usar o método ReplaceAllTextRequest para substituir o 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 em modelos. Neste caso, a substituição de texto diferencia maiúsculas de minúsculas ao definir matchCase como true.

Confira a seguir o protocolo de solicitação para substituir texto em uma apresentação:

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