L'API Presentazioni Google 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 entrambi 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 scoprire il valore di questo ID dall'URL della presentazione.
- PAGE_ID: indica dove fornisci l'ID oggetto della pagina. Puoi recuperare il relativo valore dall'URL o utilizzando una richiesta di lettura dell'API.
Questi esempi sono presentati come richieste HTTP per essere neutrali di lingua. Gli esempi vengono 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 maschere di campo per restituire solo informazioni richieste specifiche sulla presentazione, sulla diapositiva e sull'elemento di pagina. L'uso delle maschere dei campi migliora anche le prestazioni.
Lettura ID oggetti 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 diapositive e possono essere utilizzati per indicare slide specifiche nelle richieste API successive. Puoi ottenere gli ID oggetto delle pagine principali e di layout nello stesso modo, utilizzando fields=masters.objectId e fields=layout.objectId.
Di seguito è riportato il protocollo di richiesta per leggere gli ID oggetto 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"
}
]
}
Lettura degli ID oggetto degli elementi da una pagina
Il seguente esempio di codice di 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 elemento 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"
}
]
}
Leggere gli elementi della forma da una pagina
Il seguente esempio di codice di presentations.pages.get mostra come recuperare un elenco di tutti i Shapes in una pagina. Puoi recuperare altri tipi di PageElement specificandoli tramite il parametro fields. Ad esempio, fields=pageElements(line,table) restituisce solo informazioni sugli elementi di pagina line e table, se presenti nella pagina.
Di seguito è riportato il protocollo di richiesta per leggere gli elementi delle forme 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 di forma richiesti. Le parentesi graffe vuote indicano gli elementi di pagina
non del tipo di 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
}
}
}
]
}
}
},
...
]
}