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 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 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 atuais

A API Slides não oferece um método para recuperar uma lista de apresentações, mas a API Drive oferece. O files.list 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. 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 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 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 slides mestres. Nesse caso, a substituição de texto diferencia maiúsculas de minúsculas definindo matchCase como true.

Confira abaixo 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."
      }
    }
  ]
}