La API de Presentaciones de Google te permite leer datos de presentaciones, páginas y elementos de páginas. En los ejemplos de esta página, se muestra cómo realizar operaciones de lectura comunes con los métodos presentations.get y presentations.pages.get.
En estos ejemplos, se usan los siguientes marcadores de posición:
- PRESENTATION_ID: Indica dónde proporcionas el ID de presentación. Puedes descubrir el valor para este ID desde la URL de presentación.
- PAGE_ID: Indica dónde proporcionas el ID de objeto de página. Puedes recuperar el valor para esto desde la URL o mediante una solicitud de lectura de la API.
Estos ejemplos se presentan como solicitudes HTTP para que no tengan idioma. En los ejemplos que se leen en esta presentación de ejemplo, que tiene 1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc como PRESENTATION_ID. El PAGE_ID de la primera diapositiva de esta presentación es ge63a4b4_1_0.
En estos ejemplos, se usan máscaras de campo para mostrar solo información solicitada específica sobre la presentación, la diapositiva y el elemento de página. El uso de máscaras de campo también mejora el rendimiento.
Leer los IDs de objeto de las diapositivas
En la siguiente muestra de código de presentations.get, se indica cómo obtener una lista de todos los IDs de objeto de diapositiva de la presentación. Los ID se muestran en el orden de presentación de diapositivas y se pueden usar para indicar diapositivas específicas en solicitudes posteriores a la API. Puedes obtener los ID de objeto de las páginas principales y de diseño de la misma manera, con fields=masters.objectId y fields=layout.objectId.
A continuación, se muestra el protocolo de solicitud para leer los IDs de objeto de las diapositivas:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID?fields=slides.objectId
La respuesta consta de un objeto Presentation que contiene los IDs de objeto solicitados:
{
"slides": [
{
"objectId": "ge63a4b4_1_0"
},
{
"objectId": "ge63a4b4_1_9"
},
{
"objectId": "ge63a4b4_1_23"
},
{
"objectId": "ge63a4b4_1_35"
},
{
"objectId": "ge63a4b4_1_43"
}
]
}
Lee los IDs de objeto de los elementos de una página
En la siguiente muestra de código presentations.pages.get, se indica cómo recuperar una lista de IDs de objeto para todos los elementos de página incluidos en ella.
A continuación, se muestra el protocolo de solicitud para leer los IDs de objeto de elemento de una página:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID?fields=pageElements.objectId
La respuesta consta de un objeto Page que contiene los IDs de objeto solicitados:
{
"pageElements": [
{
"objectId": "ge63a4b4_1_5"
},
{
"objectId": "ge63a4b4_1_6"
},
{
"objectId": "ge63a4b4_1_7"
},
{
"objectId": "ge63a4b4_1_8"
}
]
}
Cómo leer elementos de forma de una página
En la siguiente muestra de código de presentations.pages.get, se indica cómo recuperar una lista de todos los Shapes en una página. Puedes recuperar otros tipos PageElement si los especificas con el parámetro fields. Por ejemplo, fields=pageElements(line,table) solo muestra información sobre los elementos de página line y table, si los hay.
El siguiente es el protocolo de solicitud para leer elementos de forma de una página:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID?fields=pageElements.shape
La respuesta consta de un objeto Page que contiene los elementos de forma solicitados. Las llaves vacías indican elementos de página que no son del tipo de forma; en este caso, son elementos de página de imagen.
{
"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
}
}
}
]
}
}
},
...
]
}