Method: presentations.create

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 (Size)
  },
  "slides": [
    {
      object (Page)
    }
  ],
  "title": string,
  "masters": [
    {
      object (Page)
    }
  ],
  "layouts": [
    {
      object (Page)
    }
  ],
  "locale": string,
  "revisionId": string,
  "notesMaster": {
    object (Page)
  }
}
Campos
presentationId

string

El ID de la presentación.
pageSize

object (Size)

El tamaño de las páginas de la presentación.
slides[]

object (Page)

Las diapositivas de la presentación. Una diapositiva hereda las propiedades de un diseño de diapositiva.
title

string

Es el título de la presentación.
masters[]

object (Page)

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:

  • Las formas de marcadores de posición de un diseño maestro contienen las propiedades y los estilos de texto predeterminados de todas las formas de marcador de posición en las páginas que usan ese diseño maestro.
  • Las propiedades de la página principal definen las propiedades comunes de la página que heredan sus diseños.
  • Las demás formas de la diapositiva maestra aparecerán en todas las diapositivas que usen ese diseño, independientemente de su diseño.
layouts[]

object (Page)

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

string

Es la configuración regional de la presentación, como una etiqueta de idioma IETF BCP 47.
revisionId

string

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

object (Page)

El patrón de notas de la presentación. Tiene tres propósitos:

  • Las formas de marcadores de posición en un diseño maestro de notas contienen los estilos de texto y las propiedades de forma predeterminados de todas las formas de marcador de posición en notes pages. Específicamente, una forma del marcador de posición SLIDE_IMAGE contiene la miniatura de la diapositiva y una forma del marcador de posición BODY contiene las notas del orador.
  • Las propiedades de la página principal de notas definen las propiedades comunes de la página heredadas por todos los notes pages.
  • Las demás formas del diseño maestro de notas se mostrarán en todos los notes pages.

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.