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 presentations.batchUpdate metodo.

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 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 batch in diverse lingue utilizzando le librerie client delle API di 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 DuplicateObjectRequest metodo per copiare una slide e inserirla dopo l'originale nella presentazione. La slide originale è specificata da PAGE_ID.

La richiesta consente di specificare se alcuni o tutti gli ID degli elementi di pagina devono essere presenti nella copia (con alcune limitazioni). In questo esempio, la slide originale contiene un elemento tabella (specificato da TABLE_ELEMENT_ID) che viene mappato a una nuova tabella (specificata da the COPY_TABLE_ELEMENT_ID) nella copia della slide (specificata da the 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 Copiare e modificare 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"
        }
      }
    }
  ]
}

Creare una slide

Il seguente presentations.batchUpdate esempio di codice mostra come utilizzare il CreateSlideRequest metodo per creare una slide e inserirla come quarta slide (utilizzando 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), o consentire all'API di generare il 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 CreateSlideRequest metodo per creare una slide utilizzando il PredefinedLayout di TITLE_AND_TWO_COLUMNS.

Puoi specificare una stringa da utilizzare come PAGE_ID per la slide (con alcune limitazioni). Il placeholderIdMappings utilizza il Type di TITLE. Il TITLE_ID fa riferimento alla forma del 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 presentations.batchUpdate esempio di codice mostra come utilizzare il metodo UpdateSlidesPositionRequest per prendere le due slide specificate e spostarle all'inizio della presentazione, mantenendo l'ordinamento relativo.

Gli ID slide specificati (PAGE_ID e PAGE_ID2) devono essere forniti nell'ordine di presentazione esistente, senza duplicati. insertionIndex in base 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 UpdatePagePropertiesRequest metodo per impostare l'immagine di sfondo di una slide specificata da PAGE_ID. L'API recupera l'immagine utilizzando il IMAGE_URL.

Viene utilizzata una maschera di campo per specificare che deve essere modificato solo lo sfondo della slide per preservare le altre proprietà. L'utilizzo delle maschere di campo 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 per una slide:

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

{
  "requests": [
    {
      "updatePageProperties": {
        "objectId": PAGE_ID,
        "pageProperties": {
          "pageBackgroundFill": {
            "stretchedPictureFill": {
              "contentUrl": IMAGE_URL
            }
          }
        },
        "fields": "pageBackgroundFill"
      }
    }
  ]
}

Generare miniatura

Puoi generare una miniatura dell'ultima versione di una pagina specifica della presentazione chiamando il presentations.pages.getThumbnail metodo, 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 ThumbnailProperties campo come parametro di query.

Di seguito è riportato il protocollo di richiesta per generare la miniatura della pagina con ThumbnailProperties impostato:

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