Method: presentations.create

Cria uma apresentação em branco usando o título fornecido na solicitação. Se um presentationId for fornecido, ele será usado como o ID da nova apresentação. Caso contrário, um novo ID será gerado. Outros campos na solicitação, incluindo qualquer conteúdo fornecido, são ignorados. Retorna a apresentação criada.

Solicitação HTTP

POST https://slides.googleapis.com/v1/presentations

O URL usa a sintaxe de transcodificação gRPC.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "presentationId": string,
  "pageSize": {
    object (Size)
  },
  "slides": [
    {
      object (Page)
    }
  ],
  "title": string,
  "masters": [
    {
      object (Page)
    }
  ],
  "layouts": [
    {
      object (Page)
    }
  ],
  "locale": string,
  "revisionId": string,
  "notesMaster": {
    object (Page)
  }
}
Campos
presentationId

string

O ID da apresentação.
pageSize

object (Size)

O tamanho das páginas na apresentação.
slides[]

object (Page)

Os slides da apresentação. Um slide herda propriedades de um layout de slide.
title

string

O título da apresentação.
masters[]

object (Page)

Os slides mestres na apresentação. Uma guia de slides contém todos os elementos comuns da página e as propriedades comuns de um conjunto de layouts. Elas servem a três propósitos:

  • As formas de marcador de posição em um modelo contêm os estilos de texto padrão e as propriedades de forma de todas as formas de marcador de posição nas páginas que usam esse modelo.
  • As propriedades da página principal definem as propriedades comuns herdadas pelos layouts.
  • Todas as outras formas no slide mestre aparecem em todos os slides que usam esse mestre, independentemente do layout.
layouts[]

object (Page)

Os layouts na apresentação. Um layout é um modelo que determina como o conteúdo é organizado e estilizado nos slides que herdam esse layout.
locale

string

A localidade da apresentação, como uma tag de idioma IETF BCP 47.
revisionId

string

Apenas saída. O ID da revisão da apresentação. Pode ser usado em solicitações de atualização para afirmar que a revisão da apresentação não mudou desde a última operação de leitura. Só é preenchido se o usuário tiver acesso de edição à apresentação.

O ID da revisão não é um número sequencial, mas uma string nebulosa. O formato do ID da revisão pode mudar com o tempo, então ele precisa ser tratado de forma opaca. O ID de revisão retornado só é válido por 24 horas após o retorno e não pode ser compartilhado entre usuários. Se o ID da revisão não mudar entre as chamadas, a apresentação não será alterada. Por outro lado, um ID alterado (para a mesma apresentação e usuário) geralmente significa que a apresentação foi atualizada. No entanto, um ID alterado também pode ser devido a fatores internos, como mudanças no formato do ID.
notesMaster

object (Page)

O slide mestre de anotações na apresentação. Ele serve para três propósitos:

  • As formas de marcador de posição em um modelo de notas contêm os estilos de texto padrão e as propriedades de forma de todas as formas de marcador de posição em notes pages. Especificamente, uma forma de marcador de posição SLIDE_IMAGE contém a miniatura do slide, e uma forma de marcador de posição BODY contém as anotações do orador.
  • As propriedades da página mestre de notas definem as propriedades de página comuns herdadas por todos os notes pages.
  • Todas as outras formas no modelo de notas aparecem em todas as notes pages.

O modelo de anotações é somente leitura.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta incluirá uma instância de Presentation.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/presentations

Para mais informações, consulte o guia de autorização.