Operazioni diapositiva

L'API Google Slides consente di creare, spostare ed eliminare le slide. Gli esempi riportati in questa pagina mostrano alcune operazioni comuni sulle slide utilizzando 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: indica dove fornisci gli ID oggetto pagina. Puoi recuperare il valore da questo URL o utilizzando una richiesta di lettura dell'API.

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

Copiare una slide

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

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

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

Di seguito è riportato il protocollo di richiesta per copiare una slide:

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 slide e inserirla come quarta slide (utilizzando l'indice insertionIndex) nella presentazione.

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

Di seguito è riportato il protocollo di richiesta per creare una slide:

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 slide e modificare i segnaposto

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

Puoi specificare una stringa da utilizzare come PAGE_ID per la slide (con alcune limitazioni). placeholderIdMappings utilizza Type di TITLE. TITLE_ID fa riferimento alla forma segnaposto della slide in modo che possa essere modificata.

Di seguito è riportato il protocollo di richiesta per creare una slide 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 slide in una nuova posizione

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

Gli ID slide specificati (PAGE_ID e PAGE_ID2) devono essere forniti nell'ordine di presentazione esistente, senza duplicati. L'indice insertionIndex basato su zero indica dove devono essere inserite le slide, in base all'ordine prima dello spostamento. Il valore deve essere compreso tra zero e il numero di slide nella presentazione, inclusi.

Di seguito è riportato il protocollo di richiesta per spostare le slide 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 per una slide

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

Una maschera di campo viene utilizzata per specificare che solo lo sfondo della slide deve essere modificato per preservare le altre proprietà. L'utilizzo delle maschere dei campi migliora anche il rendimento.

In alternativa, è possibile utilizzare un metodo UpdatePagePropertiesRequest per impostare lo sfondo di una slide su un colore uniforme.

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

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 della 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 i valori 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 il set 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"
}