Questa pagina è stata tradotta dall'API Cloud Translation.

Operazioni diapositiva

L'API Presentazioni Google ti consente di creare, spostare ed eliminare le slide. Gli esempi su questa pagina mostra alcune operazioni comuni delle slide usando presentations.batchUpdate .

In questi esempi vengono utilizzate le seguenti variabili:

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

Questi esempi vengono presentati come richieste HTTP per essere indipendenti dal linguaggio. Per apprendere come implementare un aggiornamento batch in lingue diverse utilizzando l'API di Google librerie client, consulta le seguenti guide: Creare un slide e Aggiungi forme e testo.

Copiare una slide

Le seguenti presentations.batchUpdate l'esempio di codice mostra come utilizzare 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 il testo (con alcuni limitazioni). In questo esempio, la slide originale contiene un elemento tabella (specificato dal TABLE_ELEMENT_ID), mappata a una nuova tabella (specificata da COPY_TABLE_ELEMENT_ID) nel testo della slide (specificato dal COPY_PAGE_ID). Tutti gli altri elementi nella copia sono casuali ID.

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

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

Le seguenti presentations.batchUpdate l'esempio di codice mostra come utilizzare CreateSlideRequest per creare una slide e inserirla come quarta slide (utilizzando il metodo insertionIndex) nella presentazione.

La nuova slide è impostata per utilizzare 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 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"
        }
      }
    }
  ]
}

Crea una slide e modifica i segnaposto

Le seguenti presentations.batchUpdate l'esempio di codice mostra come utilizzare CreateSlideRequest per creare una slide usando PredefinedLayout di TITLE_AND_TWO_COLUMNS.

Puoi specificare una stringa da utilizzare come PAGE_ID per la slide (con alcune limitazioni). La placeholderIdMappings utilizza Type di TITLE. L'elemento TITLE_ID fa riferimento alla forma del segnaposto della slide per poterlo modificare.

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

Sposta le slide in una nuova posizione

Le seguenti presentations.batchUpdate l'esempio di codice mostra come utilizzare UpdateSlidesPositionRequest per spostare le due slide specificate all'inizio del presentazione, mantenendo l'ordine relativo.

Gli ID slide specificati (PAGE_ID e PAGE_ID2) devono essere forniti nell'ordine di presentazione esistente, senza duplicati. La la insertionIndex in base zero indica dove devono essere inserite le slide, in base dell'ordine prima dello spostamento. Il valore deve essere compreso tra zero e i numero di slide incluse nella presentazione.

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

Imposta un'immagine di sfondo per la slide

Le seguenti presentations.batchUpdate l'esempio di codice mostra come utilizzare UpdatePagePropertiesRequest per impostare l'immagine di sfondo di una slide specificata 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 conservare le altre proprietà. Campo in uso mascherine migliora anche il rendimento.

In alternativa, è possibile utilizzare un metodo UpdatePagePropertiesRequest per impostare di una slide a un colore a tinta unita.

Di seguito è riportato il protocollo di richiesta per impostare un'immagine di sfondo per la 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 nel di presentazione chiamando il metodo presentations.pages.getThumbnail , che restituisce un'immagine in miniatura della pagina come URL di contenuti. L'immagine L'URL ha una durata predefinita di 30 minuti.

Puoi anche specificare i valori mimeType e thumbnailSize restituiti utilizzando il valore ThumbnailProperties 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"
}