Operazioni diapositiva

L'API Google Slides ti consente di creare, spostare ed eliminare le diapositive. Gli esempi in questa pagina mostrano alcune operazioni comuni con le diapositive che utilizzano il metodo presentations.batchUpdate.

Questi esempi utilizzano le seguenti variabili:

  • PRESENTATION_ID: indica dove fornire l'ID presentazione. Puoi scoprire il valore di questo ID dall'URL della presentazione.
  • PAGE_ID e PAGE_ID2: indicano dove fornire gli ID oggetto pagina. Puoi recuperare il valore dall'URL o utilizzando una richiesta di lettura dell'API.

Questi esempi sono presentati come richieste HTTP per essere indipendenti dalla lingua. Per scoprire come implementare un aggiornamento collettivo in lingue diverse utilizzando le librerie client dell'API di Google, consulta le seguenti guide: Creare una presentazione e Aggiungere forme e testo.

Copiare una diapositiva

Il seguente presentations.batchUpdate esempio di codice mostra come utilizzare il metodo DuplicateObjectRequest per copiare una diapositiva e inserirla dopo l'originale nella presentazione. La diapositiva originale è specificata da PAGE_ID.

La richiesta ti consente di specificare se alcuni o tutti gli ID elemento della pagina devono essere inclusi nella copia (con alcune limitazioni). In questo esempio, la diapositiva originale contiene un elemento tabella (specificato da TABLE_ELEMENT_ID) mappato a una nuova tabella (specificata da COPY_TABLE_ELEMENT_ID) nella copia della diapositiva (specificata da COPY_PAGE_ID). A tutti gli altri elementi della copia vengono assegnati ID casuali.

Per ulteriori informazioni sulla copia di un PageElement, incluse caselle di testo, immagini, tabelle, forme di base, linee e video incorporati, consulta l'esempio Copiare e modificare un elemento.

Di seguito è riportato il protocollo di richiesta per copiare 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"
        }
      }
    }
  ]
}

Crea una slide

Il seguente presentations.batchUpdate esempio di codice mostra come utilizzare il metodo CreateSlideRequest per creare una diapositiva e inserirla come quarta (utilizzando il valore insertionIndex basato su zero) nella presentazione.

La nuova diapositiva è impostata per utilizzare il PredefinedLayout di TITLE_AND_TWO_COLUMNS. Puoi specificare una stringa da utilizzare come PAGE_ID per la diapositiva (con alcune limitazioni) o consentire all'API di generare il PAGE_ID omettendo il campo nella richiesta.

Di seguito è riportato il protocollo di richiesta per creare 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"
        }
      }
    }
  ]
}

Creare una diapositiva e modificare i segnaposto

Il seguente presentations.batchUpdate esempio di codice mostra come utilizzare il metodo CreateSlideRequest per creare una diapositiva utilizzando il PredefinedLayout di TITLE_AND_TWO_COLUMNS.

Puoi specificare una stringa da utilizzare come PAGE_ID per la diapositiva (con alcune limitazioni). placeholderIdMappings utilizza Type di TITLE. TITLE_ID fa riferimento alla forma del segnaposto della diapositiva, pertanto può essere modificato.

Di seguito è riportato il protocollo di richiesta per creare una diapositiva e modificare i segnaposto:

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

Spostare le diapositive in una nuova posizione

Il seguente presentations.batchUpdate esempio di codice mostra come utilizzare il metodo UpdateSlidesPositionRequest per prendere le due diapositive specificate e spostarle all'inizio della presentazione, mantenendo la loro organizzazione relativa.

Gli ID diapositiva specificati (PAGE_ID e PAGE_ID2) devono essere forniti nell'ordine di presentazione esistente, senza duplicati. Il valore insertionIndex a partire da zero indica dove devono essere inserite le diapositive in base all'ordine prima del trasferimento. Il valore deve essere compreso tra 0 e il numero di diapositive della presentazione, inclusi.

Di seguito è riportato il protocollo di richiesta per spostare le diapositive in una nuova posizione:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "updateSlidesPosition": {
        "slideObjectIds": [
          PAGE_ID,
          PAGE_ID2
          ],
        "insertionIndex": 0
      }
    }
  ]
}

Impostare un'immagine di sfondo della slide

Il seguente presentations.batchUpdate esempio di codice mostra come utilizzare il metodo UpdatePagePropertiesRequest per impostare l'immagine di sfondo di una diapositiva specificata da PAGE_ID. L'API recupera l'immagine utilizzandoIMAGE_URL.

Una maschera di campo viene utilizzata per specificare che deve essere modificato solo lo sfondo della presentazione per preservare le altre proprietà. Anche l'utilizzo di maschere di campo migliora le prestazioni.

In alternativa, puoi utilizzare un metodo UpdatePagePropertiesRequest per impostare lo sfondo di una diapositiva su un colore a tinta unita.

Di seguito è riportato il protocollo di richiesta per impostare un'immagine di sfondo della diapositiva:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "updatePageProperties": {
        "objectId": PAGE_ID,
        "pageProperties": {
          "pageBackgroundFill": {
            "stretchedPictureFill": {
              "contentUrl": IMAGE_URL
            }
          }
        },
        "fields": "pageBackgroundFill"
      }
    }
  ]
}

Genera miniatura

Puoi generare una miniatura dell'ultima versione di una pagina specifica nella presentazione chiamando il metodo presentations.pages.getThumbnail, che restituisce un'immagine in miniatura della pagina come URL dei contenuti. L'URL dell'immagine ha una durata predefinita di 30 minuti.

Puoi anche specificare mimeType e thumbnailSize restituiti utilizzando il campo ThumbnailProperties come parametro di query.

Di seguito è riportato il protocollo di richiesta per generare la miniatura della pagina con l'impostazioneThumbnailProperties:

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