Method: presentations.create

Crea una presentación en blanco con el título que se proporciona 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. Devuelve la presentación creada.

Solicitud HTTP

POST https://slides.googleapis.com/v1/presentations

La URL usa la sintaxis de la transcodificación de 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)
  },
  "comments": [
    {
      object (CommentThread)
    }
  ],
  "commentsViewMode": enum (CommentsViewMode)
}
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)

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

Son los patrones de diapositivas de la presentación. Un patrón de diapositivas contiene todos los elementos comunes de la página y las propiedades comunes para un conjunto de diseños. Cumplen tres propósitos:

  • Las formas de marcador de posición en un patrón contienen los estilos de texto predeterminados y las propiedades de forma 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 comunes de la página que heredan sus diseños.
  • Cualquier otra forma en la diapositiva principal aparece en todas las diapositivas que usan ese patrón, independientemente de su diseño.
layouts[]

object (Page)

Son los diseños de la presentación. Un diseño es una plantilla que determina cómo se organiza y se aplica el estilo al contenido de las diapositivas que 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. Es 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 cadena nebulosa. El formato del ID de revisión puede cambiar con el tiempo, por lo que debe tratarse de forma opaca. Se garantiza que un ID de revisión devuelto solo es válido durante 24 horas después de que se devuelve y no se puede compartir entre usuarios. Si el ID de revisión no cambia entre las llamadas, significa que la presentación no cambió. Por el contrario, un ID cambiado (para la misma presentación y el mismo usuario) suele significar que la presentación se actualizó. Sin embargo, un ID cambiado también puede deberse a factores internos, como cambios en el formato del ID.
notesMaster

object (Page)

Es el patrón de notas de la presentación. Cumple tres propósitos:

  • Las formas de marcador de posición en un patrón de notas contienen los estilos de texto predeterminados y las propiedades de forma de todas las formas de marcador de posición en notes pages. En particular, 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 comunes de la página que heredan todas las notes pages.
  • Cualquier otra forma en el patrón de notas aparece en todas las notes pages.

El patrón de notas es de solo lectura.
comments[]

object (CommentThread)

Solo salida. Son los subprocesos de comentarios asociados con la presentación.

commentsViewMode

enum (CommentsViewMode)

Solo salida. Es el modo de vista de comentarios aplicado a la presentación.

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.