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 ( |
Campos | |
---|---|
presentationId |
O ID da apresentação. |
pageSize |
O tamanho das páginas da apresentação. |
slides[] |
Os slides da apresentação. Um slide herda as propriedades de um layout. |
title |
O título da apresentação. |
masters[] |
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:
|
layouts[] |
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 |
O local da apresentação, como uma tag de idioma IETF BCP 47. |
revisionId |
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 |
O mestre das notas da apresentação. Ele serve a três propósitos:
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.