L'API Presentazioni Google ti consente di aggiungere e modificare elementi nelle pagine delle presentazioni. Gli
esempi in questa pagina mostrano come eseguire operazioni di lettura comuni utilizzando il
metodo presentations.batchUpdate.
In questi esempi vengono utilizzate le seguenti variabili:
- PRESENTATION_ID: indica dove fornisci l'ID presentazione. Puoi trovare il valore di questo ID nell'URL della presentazione.
- PAGE_ID: indica dove fornisci l'ID dell'oggetto pagina. Puoi recuperare il valore dall'URL o utilizzando una richiesta di lettura API.
- PAGE_ELEMENT_ID: indica dove fornisci l'ID oggetto dell'elemento della pagina. Puoi specificare questo ID per gli elementi che crei (con alcune limitazioni) o consentire all'API Presentazioni di crearne uno automaticamente. Gli ID elemento possono essere recuperati tramite una richiesta di lettura dell'API.
Questi esempi vengono presentati come richieste HTTP per essere indipendenti dal linguaggio. Per scoprire come implementare un aggiornamento batch in diversi linguaggi utilizzando le librerie client dell'API di Google, consulta Aggiungere forme e testo.
Aggiungere una casella di testo a una slide
Il seguente esempio di codice presentations.batchUpdate mostra come utilizzare il metodo CreateShapeRequest per aggiungere una nuova casella di testo (contenente la stringa "La mia casella di testo aggiunta") a una slide specificata da PAGE_ID. Nel corpo della richiesta sono specificate due richieste: una per creare la forma della casella di testo (con dimensioni e posizione specificate) e un'altra per inserire testo al suo interno.
La prima richiesta specifica l'ID oggetto da utilizzare per la casella di testo. In questo modo la seconda richiesta può utilizzarlo nella stessa chiamata API, riducendo l'overhead.
Di seguito è riportato il protocollo di richiesta per aggiungere una casella di testo a una slide:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"createShape": {
"objectId": PAGE_ELEMENT_ID,
"shapeType": "TEXT_BOX",
"elementProperties": {
"pageObjectId": PAGE_ID,
"size": {
"width": {
"magnitude": 150,
"unit": "PT"
},
"height": {
"magnitude": 50,
"unit": "PT"
}
},
"transform": {
"scaleX": 1,
"scaleY": 1,
"translateX": 200,
"translateY": 100,
"unit": "PT"
}
}
}
},
{
"insertText": {
"objectId": PAGE_ELEMENT_ID,
"text": "My Added Text Box",
"insertionIndex": 0
}
}
]
}
Aggiungi un'immagine a una slide
Il seguente esempio di codice presentations.batchUpdate mostra come utilizzare il metodo CreateImageRequest per aggiungere un'immagine a una slide specificata da PAGE_ID. L'API
recupera l'immagine utilizzando IMAGE_URL. Inoltre, questa richiesta scala e posiziona l'immagine nella slide.
Di seguito è riportato il protocollo di richiesta per aggiungere un'immagine a una slide:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"createImage": {
"url": IMAGE_URL,
"elementProperties": {
"pageObjectId": PAGE_ID,
"size": {
"width": {
"magnitude": 30,
"unit": "PT"
},
"height": {
"magnitude": 30,
"unit": "PT"
}
},
"transform": {
"scaleX": 1,
"scaleY": 1,
"translateX": 200,
"translateY": 100,
"unit": "PT"
}
}
}
}
]
}
Eliminare una pagina o un elemento di pagina
Il seguente esempio di codice presentations.batchUpdate mostra come utilizzare il metodo DeleteObjectRequest per eliminare l'elemento di pagina specificato da PAGE_ELEMENT_ID e la slide specificata da PAGE_ID utilizzando due richieste separate.
Di seguito è riportato il protocollo di richiesta per eliminare una pagina o un elemento di pagina:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"deleteObject": {
"objectId": PAGE_ELEMENT_ID
},
"deleteObject": {
"objectId": PAGE_ID
}
}
]
}
Modificare il testo in una forma specificata
Il seguente esempio di codice presentations.batchUpdate mostra come utilizzare il metodo DeleteTextRequest per sostituire una parte del testo presente nella forma specificata da PAGE_ELEMENT_ID. A tale scopo, elimina il testo utilizzando
startIndex in base zero, quindi inserisci il nuovo testo in quella posizione. In questo esempio, la stringa di testo originale "My Shape Text: ????" viene sostituita con "My Shape Text: Trapezoid".
Questa richiesta riguarda solo il testo in una forma specificata. Per sostituire il testo in qualsiasi punto di una presentazione, utilizza il metodo ReplaceAllTextRequest.
Di seguito è riportato il protocollo di richiesta per modificare il testo in una forma specificata:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"deleteText": {
"objectId": PAGE_ELEMENT_ID,
"textRange": {
"type": "FROM_START_INDEX",
"startIndex": 15
}
}
},
{
"insertText": {
"objectId": PAGE_ELEMENT_ID,
"text": "Trapezoid",
"insertionIndex": 15
}
}
]
}
Sostituzione di un tag di forma con un'immagine
I tag sono caselle di testo o forme con un nome di stringa univoco, ad esempio "nome-titolare-account".
Il seguente esempio di codice presentations.batchUpdate mostra come utilizzare il metodo CreateImageRequest per sostituire una singola istanza di un tag di forma con un'immagine, mantenendo la stessa posizione e scalandola per adattarla alle dimensioni del tag e mantenendo le proporzioni dell'immagine.
La richiesta può essere utilizzata anche per sostituire un'immagine con un'altra. La richiesta consiste nell'aggiungere la nuova immagine e quindi eliminare il tag.
Il metodo CreateImageRequest sostituisce solo una forma specificata. Per sostituire le forme dei tag in qualsiasi punto di una presentazione, utilizza un metodo ReplaceAllShapesWithImageRequest.
Il tag di forma ha le seguenti proprietà PageElement (che puoi trovare utilizzando una richiesta presentations.pages.get):
{
"objectId": PAGE_ELEMENT_ID,
"size": {
"width": {
"magnitude": 3000000,
"unit": "EMU"
},
"height": {
"magnitude": 3000000,
"unit": "EMU"
}
},
"transform": {
"scaleX": 1.13,
"scaleY": 0.62,
"translateX": 4800000,
"translateY": 450000,
"unit": "EMU"
},
"shape": {
"shapeType": "RECTANGLE"
}
}
La forma si trova nella slide specificata da PAGE_ID. Per specificare
l'immagine che sostituisce la forma, l'API recupera l'immagine utilizzando
IMAGE_URL. Per mantenere le proporzioni dell'immagine limitandole alle dimensioni del tag, il metodo CreateImageRequest imposta sia le dimensioni dell'immagine sul prodotto delle dimensioni e la scala del tag, sia i fattori di scala delle immagini su 1. Per ulteriori informazioni, consulta Preservare le proporzioni.
Di seguito è riportato il protocollo di richiesta per sostituire un tag di forma con un'immagine:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"createImage": {
"url": IMAGE_URL,
"elementProperties": {
"pageObjectId": PAGE_ID,
"size": {
"width": {
"magnitude": 3000000 * 1.13,
"unit": "EMU"
},
"height": {
"magnitude": 3000000 * 0.62,
"unit": "EMU"
}
},
"transform": {
"scaleX": 1,
"scaleY": 1,
"translateX": 4800000,
"translateY": 450000,
"unit": "PT"
}
}
}
},
{
"deleteObject": {
"objectId": PAGE_ELEMENT_ID
}
}
]
}