Method: presentations.create

Crea una presentación en blanco con el título indicado en la solicitud. Si se proporciona un presentationId, se usa como el ID de la presentación nueva. De lo contrario, se genera un ID nuevo. Se ignoran otros 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 (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 propiedades de un diseño de diapositiva.

title

string

Es el título de la presentación.

masters[]

object (Page)

Los patrones de diapositivas de 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. Tiene tres propósitos:

  • Las formas de marcador de posición de un patrón contienen los estilos de texto y las propiedades de forma predeterminados de todas las formas de marcador de posición en las páginas que usan ese patrón.
  • Las propiedades de la página principal definen las propiedades de página común que heredan sus diseños.
  • Cualquier otra forma de la diapositiva maestra aparecerá en todas las diapositivas que usen esa diapositiva, independientemente de su diseño.
layouts[]

object (Page)

Los diseños de la presentación. Un diseño es una plantilla que determina cómo se organiza y diseña 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 la 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 se modificó 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 se debe tratar de manera opaca. Si se muestra un ID de revisión, solo se garantiza su validez durante 24 horas, y no se puede compartir con los usuarios. Si el ID de revisión no se cambia entre llamadas, la presentación no cambió. En cambio, si cambias el ID (para la misma presentación y el mismo usuario), generalmente significa que la presentación se actualizó. Sin embargo, un ID modificado también puede deberse a factores internos, como modificaciones en el formato del ID.

notesMaster

object (Page)

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

  • Las formas de marcador 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 de marcador de posición SLIDE_IMAGE contiene la miniatura de la diapositiva y una forma de marcador de posición BODY contiene las notas del orador.
  • Las propiedades de la página maestra de notas definen las propiedades de página comunes heredadas por todos los notes pages.
  • Las demás formas del patrón de notas aparecerá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 permisos 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.