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. Os outros campos da solicitação, incluindo o conteúdo fornecido, serã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 da apresentação.

slides[]

object (Page)

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

title

string

O título da apresentação.

masters[]

object (Page)

Os slides-mestre da apresentação. Um slide mestre contém todos os elementos de página comuns e as propriedades comuns de um conjunto de layouts. Eles servem a três propósitos:

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

object (Page)

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

locale

string

O local 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 declarar que a revisão da apresentação não foi alterada desde a última operação de leitura. Preenchido apenas se o usuário tiver acesso para editar a apresentação.

O ID de revisão não é um número sequencial, mas uma string nebulosa. O formato do ID de revisão pode mudar com o tempo e, por isso, precisa ser tratado de modo opaco. Um ID de revisão retornado tem a garantia de ser válido apenas por 24 horas após ser retornado e não pode ser compartilhado entre usuários. Se o ID de revisão não for alterado entre chamadas, a apresentação não foi 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 mestre das notas da apresentação. Ele serve a três propósitos:

  • As formas de marcador de posição em um mestre de notas contêm os estilos de texto e as propriedades de forma padrão de todas as formas de marcador de posição no 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 apresentador.
  • As propriedades da página mestra de notas definem as propriedades de página comuns herdadas por todos os notes pages.
  • Todas as outras formas no mestre de notas aparecem em todas as notes pages.

O mestre de notas é 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.