Method: presentations.create

Crea una presentación en blanco con el título que se proporcionó 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 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 (Size)
  },
  "slides": [
    {
      object (Page)
    }
  ],
  "title": string,
  "masters": [
    {
      object (Page)
    }
  ],
  "layouts": [
    {
      object (Page)
    }
  ],
  "locale": string,
  "revisionId": string,
  "notesMaster": {
    object (Page)
  }
}
Campos
presentationId

string

Es el ID de la presentación.
pageSize

object (Size)

Es 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 diapositivas.
title

string

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

object (Page)

Las diapositivas maestras de la presentación. Una diapositiva maestra contiene todos los elementos de página comunes y las propiedades comunes para un conjunto de diseños. Tienen tres propósitos:

  • Las formas de marcador de posición de una maestra contienen los estilos de texto y las propiedades de forma predeterminados de todas las formas de marcador de posición de las páginas que usan esa maestra.
  • Las propiedades de la página principal definen las propiedades de página comunes que heredan sus diseños.
  • Cualquier otra forma de la diapositiva principal aparecerá en todas las diapositivas que usen esa diapositiva principal, 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 aplica diseño al contenido en las diapositivas que heredan 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 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 cadena nebulosa. El formato del ID de revisión puede cambiar con el tiempo, por lo que se debe tratar de forma opaca. Se garantiza que un ID de revisión que se muestra solo será válido durante 24 horas después de que se muestre y no se puede compartir entre usuarios. Si el ID de revisión no cambia entre llamadas, significa que la presentación no cambió. Por el contrario, un ID modificado (para la misma presentación y el mismo usuario) suele significar que se actualizó la presentación. Sin embargo, un ID cambiado también puede deberse a factores internos, como cambios en el formato del ID.
notesMaster

object (Page)

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

  • Las formas de marcador de posición en un modelo 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 principal de notas definen las propiedades de página comunes que heredan todos los notes pages.
  • Cualquier otra forma en el modelo de notas aparecerá en todas las notes pages.

El editor principal 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.