Crea una presentación en blanco con el título proporcionado en la solicitud. Si se proporciona un presentationId
, se utiliza como ID de la nueva presentación. De lo contrario, se genera un ID nuevo. Se ignorarán los demás campos de la solicitud, incluido cualquier contenido proporcionado. Devuelve la presentación creada.
Solicitud HTTP
POST https://slides.googleapis.com/v1/presentations
La URL usa la sintaxis de la transcodificación gRPC.
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
Representación JSON |
---|
{ "presentationId": string, "pageSize": { object ( |
Campos | |
---|---|
presentationId |
El ID de la presentación. |
pageSize |
El tamaño de las páginas de la presentación. |
slides[] |
Las diapositivas de la presentación. Una diapositiva hereda las propiedades de un diseño de diapositiva. |
title |
Es el título de la presentación. |
masters[] |
Los patrones de diapositivas en la presentación. Un patrón de diapositivas contiene todos los elementos de página comunes y las propiedades comunes de un conjunto de diseños. Tienen tres propósitos:
|
layouts[] |
Los diseños de la presentación. Un diseño es una plantilla que determina la organización y el estilo del contenido en las diapositivas que se heredan de ese diseño. |
locale |
Es la configuración regional de la presentación, como una etiqueta de idioma IETF BCP 47. |
revisionId |
Solo salida. El ID de revisión de la presentación. Se puede usar en solicitudes de actualización para confirmar que la revisión de la presentación no cambió desde la última operación de lectura. Solo se completa si el usuario tiene acceso de edición a la presentación. El ID de revisión no es un número secuencial, sino una cadena nebulosa. El formato del ID de revisión puede cambiar con el tiempo, por lo que debe tratarse de manera opaca. Solo se garantiza que un ID de revisión que se muestra sea válido durante 24 horas después de haberse mostrado y no se puede compartir entre los usuarios. Si el ID de revisión no se modifica entre llamadas, la presentación no se modifica. Por el contrario, un ID modificado (para la misma presentación y el mismo usuario) generalmente significa que la presentación se actualizó. Sin embargo, los IDs modificados también pueden deberse a factores internos, como cambios en el formato de los IDs. |
notesMaster |
El patrón de notas de la presentación. Tiene tres propósitos:
El patrón de notas es de solo lectura. |
Cuerpo de la respuesta
Si el proceso se realiza de forma correcta, el cuerpo de la respuesta contiene una instancia recién creada de Presentation
.
Permisos de autorización
Se necesita uno de los siguientes alcances de OAuth:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/presentations
Para obtener más información, consulta la guía de autorización.