Operações de apresentação

A Google Slides API 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 as presentations.batchUpdate .

Esses exemplos são apresentados como solicitações HTTP para serem neutros em relação à linguagem. Para saber como implementar uma atualização em lote em idiomas diferentes usando a API do Google bibliotecas de cliente, consulte os seguintes guias:

Criar uma apresentação

O seguinte presentations.create exemplo de código mostra como criar um arquivo de apresentação em branco intitulado "Meu novo Apresentação".

Também é possível criar arquivos de apresentação em branco usando a API Google Drive. método files.create especificando application/vnd.google-apps.presentation como MIME tipo.

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 existentes

A Slides API não fornece um método para recuperar uma lista de apresentações, mas a API Drive sim. O método files.list (apresentado abaixo) usa máscaras de campo para retornar uma lista de de apresentação do Google Drive, com o ID e o nome do arquivo, e um link para abrir o arquivo. A solicitação também especifica application/vnd.google-apps.presentation como MIME tipo.

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 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 o texto em toda a apresentação

O seguinte presentations.batchUpdate um exemplo de código mostra como usar a ReplaceAllTextRequest para substituir texto durante toda a apresentação especificado pelo PRESENTATION_ID. É possível descobrir o valor do atributo ID da apresentação do URL da apresentação.

Todas as instâncias da string "Gizmo Corp." é substituído pelo texto "O gadget Inc." Isso inclui texto em caixas de texto e outras formas, em slides e dentro mestres. Nesse caso, a substituição do texto diferencia maiúsculas de minúsculas configurando matchCase para true.

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