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 método presentations.batchUpdate.

Esses exemplos são apresentados como solicitações HTTP para serem neutros em termos de linguagem. Para saber como implementar uma atualização em lote em diferentes idiomas usando as bibliotecas do cliente da Google API, 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 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 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 Slides API não fornece um método para extrair uma lista de apresentações, mas a Drive API 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 abaixo 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 a 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 masters. Neste caso, a substituição do texto diferencia maiúsculas de minúsculas, definindo matchCase como true.

Confira abaixo o protocolo de solicitação para substituir o 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."
      }
    }
  ]
}