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