La API de Presentaciones de Google te permite crear, mover y borrar diapositivas. Los ejemplos en
En esta página, se muestran algunas operaciones comunes de diapositivas con la
presentations.batchUpdate
.
En estos ejemplos, se usan las siguientes variables:
- PRESENTATION_ID: Indica dónde proporcionas la presentación correcto. Puedes descubrirá el valor para este ID desde la URL de presentación.
- PAGE_ID y PAGE_ID2: Indica dónde proporcionas el objeto de página IDs. Puedes recuperar el valor para esto desde la URL o mediante una solicitud de lectura de la API.
Estos ejemplos se presentan como solicitudes HTTP para que no tengan idioma. Para aprender cómo implementar una actualización por lotes en diferentes idiomas con la API de Google las bibliotecas cliente, consulta las siguientes guías: Crea un diapositiva y Agregar formas y de texto.
Copiar una diapositiva
Lo siguiente
presentations.batchUpdate
de muestra de código muestra cómo usar el
DuplicateObjectRequest
para copiar una diapositiva e insertarla después del original en la presentación.
La diapositiva original se especifica mediante PAGE_ID.
La solicitud te permite especificar si algunos o todos los IDs de los elementos de la página deben estar en la copia (con algo de restricciones de uso). En este ejemplo, la diapositiva original contiene un elemento de tabla (especificado por el TABLE_ELEMENT_ID), que se asigna a una tabla nueva (especificada por la COPY_TABLE_ELEMENT_ID) en el texto de la diapositiva (especificado por COPY_PAGE_ID). Todos los demás elementos de la copia se presentan de forma aleatoria de sus IDs.
Para obtener más información sobre cómo copiar un
PageElement,
incluidos cuadros de texto, imágenes, tablas, formas básicas, líneas y videos incorporados,
consulta el ejemplo Cómo copiar y editar una
elemento.
El siguiente es el protocolo de solicitud para copiar una diapositiva:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"duplicateObject": {
"objectId": PAGE_ID,
"objectIds": {
"PAGE_ID": "COPY_PAGE_ID",
"TABLE_ELEMENT_ID": "COPY_TABLE_ELEMENT_ID"
}
}
}
]
}
Crear una diapositiva
Lo siguiente
presentations.batchUpdate
de muestra de código muestra cómo usar el
CreateSlideRequest
para crear una diapositiva e insertarla como la cuarta diapositiva (con el método
insertionIndex) en la presentación.
La diapositiva nueva está configurada para usar la
PredefinedLayout
de TITLE_AND_TWO_COLUMNS. Puedes especificar una cadena para usar como
PAGE_ID para la diapositiva (con algo
restricciones de uso),
o permitir que la API genere el PAGE_ID omitiendo el campo
en la solicitud.
El siguiente es el protocolo de solicitud para crear una diapositiva:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"createSlide": {
"objectId": "PAGE_ID",
"insertionIndex": 3,
"slideLayoutReference": {
"predefinedLayout": "TITLE_AND_TWO_COLUMNS"
}
}
}
]
}
Crea una diapositiva y modifica los marcadores de posición
Lo siguiente
presentations.batchUpdate
de muestra de código muestra cómo usar el
CreateSlideRequest
para crear una diapositiva usando el
PredefinedLayout
de TITLE_AND_TWO_COLUMNS.
Puedes especificar una cadena para usar como PAGE_ID para la diapositiva.
(con algunos
restricciones de uso).
El
placeholderIdMappings
usa el
Type de
TITLE El elemento TITLE_ID hace referencia a la forma del marcador de posición de la diapositiva.
para poder modificarlo.
El siguiente es el protocolo de solicitud para crear una diapositiva y modificar los marcadores de posición:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"createSlide": {
"objectId": PAGE_ID,
"slideLayoutReference": {
"predefinedLayout": "TITLE_AND_TWO_COLUMNS"
},
"placeholderIdMappings": [
{
"layoutPlaceholder": {
"type": "TITLE",
"index": 0
},
"objectId": TITLE_ID,
},
],
}
},
{
"insertText": {
"objectId": TITLE_ID,
"text": "This is my slide title",
}
},
]
}
Mover diapositivas a una posición nueva
Lo siguiente
presentations.batchUpdate
de muestra de código muestra cómo usar el
UpdateSlidesPositionRequest
para tomar las dos diapositivas especificadas y moverlas al principio de la
y mantener su orden relativo.
Los ID de diapositiva especificados (PAGE_ID y PAGE_ID2)
se deben proporcionar en el orden de presentación existente, sin duplicados. El
insertionIndex basado en cero denota dónde se deben insertar las diapositivas, según
del pedido antes de que se realice el traslado. El valor debe estar entre cero y
número de diapositivas de la presentación, inclusive.
El siguiente es el protocolo de solicitud para mover diapositivas a una nueva posición:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"updateSlidesPosition": {
"slideObjectIds": [
PAGE_ID,
PAGE_ID2
],
"insertionIndex": 0
}
}
]
}
Cómo establecer una imagen de fondo para las diapositivas
Lo siguiente
presentations.batchUpdate
de muestra de código muestra cómo usar el
UpdatePagePropertiesRequest
para establecer la imagen de fondo de una diapositiva especificada por el
PAGE_ID La API recupera la imagen usando el
IMAGE_URL
Una máscara de campo se usa para especificar que solo la el fondo de la diapositiva debe cambiarse para preservar las demás propiedades. Usando campo también mejora el rendimiento.
Como alternativa, se puede usar un método UpdatePagePropertiesRequest para establecer la
fondo de una diapositiva a un color sólido.
El siguiente es el protocolo de solicitud para establecer una imagen de fondo de diapositiva:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"updatePageProperties": {
"objectId": PAGE_ID,
"pageProperties": {
"pageBackgroundFill": {
"stretchedPictureFill": {
"contentUrl": IMAGE_URL
}
}
},
"fields": "pageBackgroundFill"
}
}
]
}
Generar miniatura
Puedes generar una miniatura de la versión más reciente de una página específica en la
presentación llamando al
presentations.pages.getThumbnail
que devuelve una imagen en miniatura de la página como una URL de contenido. La imagen
La URL tiene una vida útil predeterminada de 30 minutos.
También puedes especificar el mimeType y el thumbnailSize que se muestran con el
ThumbnailProperties
como parámetro de consulta.
El siguiente es el protocolo de solicitud para generar la miniatura de la página con el
Se estableció ThumbnailProperties:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID/thumbnail?thumbnailProperties.mimeType=PNG&thumbnailProperties.thumbnailSize=MEDIUM
{
"width": 800,
"height": 450,
"contentUrl": "CONTENT_URL"
}