Crea una presentación en blanco con el título proporcionado en la solicitud. Si se proporciona un elemento presentationId
, se usará como ID de la presentación nueva. De lo contrario, se generará un ID nuevo. Se ignoran los demás campos de la solicitud, incluido el contenido proporcionado. Muestra 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 |
Es 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 propiedades de un diseño de diapositivas. |
title |
Es el título de la presentación. |
masters[] |
La diapositiva maestra en la presentación Un diseño maestro de diapositivas contiene todos los elementos comunes de las páginas y las propiedades comunes para un conjunto de diseños. Tiene tres propósitos:
|
layouts[] |
Los diseños en la presentación Un diseño es una plantilla que determina la organización y el estilo del contenido en las diapositivas que heredan de ese diseño. |
locale |
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 propaga 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 string nebulosa. El formato del ID de revisión puede cambiar con el tiempo, por lo que debe tratarse de manera opaca. El ID de revisión que se muestra solo puede ser válido por 24 horas después de que se muestra y no puede compartirse entre 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) suele significar que la presentación se actualizó. Sin embargo, un ID modificado también puede deberse a factores internos, como cambios de formato de ID. |
notesMaster |
Los maestros de notas de la presentación Esto tiene tres propósitos:
El principal 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.