L'API Presentazioni Google ti consente di leggere i dati di presentazioni, pagine ed elementi di pagina. Gli
esempi in questa pagina mostrano come eseguire operazioni di lettura comuni utilizzando i metodi
presentations.get e
presentations.pages.get.
In questi esempi vengono utilizzati i seguenti segnaposto:
- 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.
Questi esempi vengono presentati come richieste HTTP per essere indipendenti dal linguaggio. Gli
esempi letti da questa presentazione
di esempio,
che ha 1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc come
PRESENTATION_ID. Il PAGE_ID della prima slide di questa presentazione è ge63a4b4_1_0.
In questi esempi, vengono utilizzate le maschere di campo per restituire solo informazioni specifiche richieste sulla presentazione, sulla slide e sull'elemento della pagina. L'utilizzo delle maschere dei campi migliora anche il rendimento.
Leggi gli ID degli oggetti delle slide
Il seguente esempio di codice presentations.get mostra come recuperare un elenco di tutti gli ID degli oggetti slide dalla presentazione. Gli ID vengono restituiti nell'ordine di presentazione delle slide e possono essere utilizzati per indicare slide specifiche nelle richieste API successive. Puoi ottenere
gli ID oggetto delle pagine principali e di layout allo stesso modo, utilizzando
fields=masters.objectId e fields=layout.objectId.
Di seguito è riportato il protocollo di richiesta per leggere gli ID degli oggetti delle slide:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID?fields=slides.objectId
La risposta è composta da un oggetto Presentation contenente gli ID oggetto richiesti:
{
"slides": [
{
"objectId": "ge63a4b4_1_0"
},
{
"objectId": "ge63a4b4_1_9"
},
{
"objectId": "ge63a4b4_1_23"
},
{
"objectId": "ge63a4b4_1_35"
},
{
"objectId": "ge63a4b4_1_43"
}
]
}
Leggi gli ID oggetto degli elementi da una pagina
Il seguente esempio di codice presentations.pages.get mostra come recuperare un elenco di ID oggetto per tutti gli elementi di una pagina.
Di seguito è riportato il protocollo di richiesta per leggere gli ID oggetto degli elementi da una pagina:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID?fields=pageElements.objectId
La risposta è composta da un
oggetto Page
contenente gli ID oggetto richiesti:
{
"pageElements": [
{
"objectId": "ge63a4b4_1_5"
},
{
"objectId": "ge63a4b4_1_6"
},
{
"objectId": "ge63a4b4_1_7"
},
{
"objectId": "ge63a4b4_1_8"
}
]
}
Leggi gli elementi di forma da una pagina
Il seguente esempio di codice presentations.pages.get mostra come recuperare un elenco di tutti i Shapes in una pagina. Puoi recuperare altri tipi di PageElement specificandoli con il parametro fields. Ad esempio, fields=pageElements(line,table) restituisce solo informazioni sugli elementi della pagina line e table, se presenti.
Di seguito è riportato il protocollo di richiesta per leggere gli elementi shape da una pagina:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID?fields=pageElements.shape
La risposta è composta da un oggetto Page contenente gli elementi forma richiesti. Le parentesi graffe vuote indicano elementi di pagina
che non sono di tipo forma; in questo caso, sono elementi di pagina immagine.
{
"pageElements": [
{},
{},
{
"shape": {
"shapeProperties" {
"outline" {
"dashStyle": "SOLID",
"outlineFill": {
"solidFill": {
"alpha": 1,
"color": {
"rgbColor": {}
}
},
},
"propertyState": "NOT_RENDERED",
"weight": {
"magnitude": 9525,
"unit": "EMU"
}
},
"shadow": {
"alignment": "BOTTOM_LEFT",
"alpha": 1,
"blurRadius": {
"unit": "EMU"
},
"color": {
"rgbColor": {}
},
"propertyState": "NOT_RENDERED",
"rotateWithShape": false,
"transform": {
"scaleX": 1,
"scaleY": 1,
"unit": "EMU"
},
"type": "OUTER"
},
"shapeBackgroundFill" : {
"propertyState": "NOT_RENDERED",
"solidFill": {
"alpha": 1,
"color": {
"rgbColor: {
"blue": 1,
"green": 1,
"red": 1
}
}
}
}
},
"shapeType": "TEXT_BOX",
"text": {
"textElements": [
{
"endIndex": 11,
"paragraphMarker": {
"style": {
"alignment": "START",
"direction": "LEFT_TO_RIGHT",
"indentEnd": {
"unit": "PT"
},
"indentFirstLine": {
"unit": "PT"
},
"indentStart": {
"unit": "PT"
},
"lineSpacing": 100,
"spaceAbove": {
"unit": "PT"
},
"spaceBelow": {
"unit": "PT"
},
"spacingMode": "COLLAPSE_LISTS"
}
}
},
{
"endIndex": 11,
"textRun": {
"content": "Baby Album\n",
"style": {
"backgroundColor": {},
"baselineOffset": "NONE",
"bold": false,
"fontFamily": "Arial",
"fontSize": {
"magnitude": 14,
"unit": "PT"
},
"foregroundColor": {
"opaqueColor": {
"rgbColor": {}
}
},
"italic": false,
"smallCaps": false,
"strikethrough": false,
"underline": false
}
}
}
]
}
}
},
...
]
}