Operações de apresentação

A API Google Slides 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 presentations.batchUpdate método.

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 idiomas usando as bibliotecas de cliente da API do Google, consulte os seguintes guias:

Criar uma apresentação

O exemplo de código a seguir presentations.create mostra como criar um arquivo de apresentação em branco intitulado "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 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 atuais

A API Slides não oferece um método para recuperar uma lista de apresentações, mas a API Drive sim. O método (apresentado abaixo) usa máscaras de campo para retornar uma lista de arquivos de apresentação do Drive, com o ID do arquivo, o nome do arquivo e um link para abrir o arquivo.files.list 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 arquivos de apresentação atuais:

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.

Cada instância da string "Gizmo Corp." é substituída pelo texto "Gadget Inc.". Isso inclui texto em caixas de texto e outras formas, em slides e em modelos. Nesse caso, a substituição de texto diferencia maiúsculas de minúsculas definindo 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."
      }
    }
  ]
}