L'API Presentazioni Google consente di creare, spostare ed eliminare le slide. Gli esempi in questa pagina mostrano alcune operazioni comuni sulle slide utilizzando il metodo presentations.batchUpdate.
Questi esempi utilizzano le seguenti variabili:
- PRESENTATION_ID: indica dove fornisci l'ID presentazione. Puoi trovare il valore di questo ID nell'URL della presentazione.
- PAGE_ID e PAGE_ID2: indica dove fornisci gli ID degli oggetti di pagina. Puoi recuperare il relativo valore dall'URL o utilizzando una richiesta di lettura API.
Questi esempi sono presentati come richieste HTTP per essere neutrali di linguaggio. Per scoprire come implementare un aggiornamento batch in diversi linguaggi utilizzando le librerie client dell'API di Google, consulta le seguenti guide: Creare una slide e Aggiungere forme e testo.
Copiare una slide
Il seguente esempio di codice di presentations.batchUpdate 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 consente di specificare se alcuni o tutti gli ID elemento 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 una PageElement, incluse caselle di testo, immagini, tabelle, forme di base, linee e video incorporati, consulta l'esempio di copiare e modificare un elemento.
Di seguito è riportato il protocollo di richiesta della copia di 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
esempio di codice di presentations.batchUpdate
mostra come utilizzare il metodo
CreateSlideRequest
per creare una slide e inserirla come quarta diapositiva (utilizzando il metodo in base zero
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 restrizioni) oppure consentire all'API di generare PAGE_ID omettendo il campo nella richiesta.
Di seguito è riportato il protocollo di richiesta per la creazione di 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
Il seguente
esempio di codice di presentations.batchUpdate
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).
Il placeholderIdMappings usa Type di TITLE. TITLE_ID fa riferimento alla forma segnaposto della slide
per poterla 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 slide in una nuova posizione
Il seguente esempio di codice di presentations.batchUpdate mostra come utilizzare il metodo UpdateSlidesPositionRequest per spostare le due slide specificate all'inizio della presentazione, mantenendo l'ordine relativo.
Gli ID slide specificati (PAGE_ID e PAGE_ID2)
devono essere forniti nell'ordine di presentazione esistente, senza duplicati. Il insertionIndex in base zero indica dove inserire le slide, in base all'ordine prima dello spostamento. Il valore deve essere compreso tra zero e
il numero di slide nella presentazione incluse.
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
Il seguente
esempio di codice di presentations.batchUpdate
mostra come utilizzare il metodo
UpdatePagePropertiesRequest
per impostare l'immagine di sfondo di una slide specificata dal
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à. Anche l'uso di maschere di campo migliora le prestazioni.
In alternativa, si può utilizzare un metodo UpdatePagePropertiesRequest per impostare
lo sfondo di una slide su un colore a tinta unita.
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 della versione più recente di una pagina specifica nella presentazione chiamando il metodo presentations.pages.getThumbnail, che restituisce un'immagine in miniatura della pagina come URL di contenuti. L'URL 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 il 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"
}