Method: presentations.create

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 (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)

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)

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:

  • Las formas de marcadores de posición de un diseño maestro contienen las propiedades de forma 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 página principal definen las propiedades de página comunes que heredan sus diseños.
  • Cualquier otra forma de la diapositiva maestra aparece en todas las diapositivas que usan esa diapositiva maestra, independientemente de su diseño.
layouts[]

object (Page)

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

string

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 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

object (Page)

Los maestros de notas de la presentación Esto tiene tres propósitos:

  • Las formas de marcador de posición de un patrón de notas contienen las propiedades de forma y los estilos de texto 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 de BODY contiene las notas del orador.
  • Las propiedades de la página principal de notas definen las propiedades de página comunes que hereda todos los notes pages.
  • Cualquier otra forma en la instancia principal de las notas aparecerá en todos los notes pages.

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.