L'API Google Slides consente di leggere i dati di presentazioni, pagine ed elementi di pagina. Gli esempi riportati in questa pagina mostrano come eseguire operazioni di lettura comuni utilizzando sia i metodi presentations.get sia presentations.pages.get.
Questi esempi utilizzano i seguenti segnaposto:
- PRESENTATION_ID: indica dove fornire l'ID presentazione. Puoi scoprire il valore di questo ID dall'URL della presentazione.
- PAGE_ID: indica dove fornire l'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. Gli esempi vengono letti da questa presentazione di esempio, che ha 1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc come PRESENTATION_ID. Il PAGE_ID della
prima
slide
in questa presentazione è ge63a4b4_1_0.
Gli esempi riportati di seguito utilizzano le maschere di campo per restituire solo le informazioni richieste specifiche sulla presentazione, sulla diapositiva e sull'elemento della pagina. Anche l'utilizzo delle maschere di campo migliora le prestazioni.
Leggere gli ID oggetto delle diapositive
L'esempio di codice
presentations.get riportato di seguito mostra come recuperare un elenco di tutti gli ID oggetto della presentazione. Gli ID vengono restituiti nell'ordine di presentazione delle diapositive e possono essere utilizzati per indicare diapositive specifiche nelle richieste API successive. Puoi ottenere gli ID oggetto delle pagine master 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 delle diapositive:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID?fields=slides.objectId
La risposta è costituita 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"
}
]
}
Leggere gli ID oggetto elemento da una pagina
Il seguente
presentations.pages.get
esempio di codice 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 è costituita 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 di forma da una pagina
Il seguente
presentations.pages.get
esempio di codice mostra come recuperare un elenco di tutti i
Shapes
in una pagina. Puoi recuperare altri tipi di
PageElement
specificandoli utilizzando il parametro fields. Ad esempio,
fields=pageElements(line,table) restituisce solo informazioni su
line e
table
elementi della pagina, se presenti.
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 è costituita da un oggetto
Page
contenente gli elementi della forma richiesti. Le parentesi graffe vuote indicano elementi di pagina
che non sono di tipo forma; in questo caso, si tratta di elementi di pagina di immagini.
{
"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
}
}
}
]
}
}
},
...
]
}