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

Criar uma apresentação

O exemplo de código presentations.create abaixo mostra como criar um arquivo de apresentação em branco com o título "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

A API Slides não fornece um método para extrair uma lista de apresentações, mas a API Drive fornece. 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 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 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 texto em toda uma apresentação

O exemplo de código presentations.batchUpdate abaixo 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 da apresentação.

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 mestres. 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 o 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."
      }
    }
  ]
}