Operaciones con diapositivas

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. por lo que se puede modificar.

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