La API de Presentaciones de Google te permite leer datos de presentaciones, páginas y elementos de página. 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 la presentación. Puedes descubrir el valor de este ID en la URL de la presentación.
- PAGE_ID: Indica dónde proporcionas el ID del objeto de página. Puedes recuperar el valor de esto desde la URL o mediante una solicitud de lectura de la API.
Estos ejemplos se presentan como solicitudes HTTP para que sean independientes del idioma. Los ejemplos se leen de 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 los ejemplos que se muestran aquí, se usan máscaras de campo para mostrar solo la 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.
Lee los IDs de los objetos de diapositivas
En la siguiente muestra de código de presentations.get, se muestra cómo recuperar una lista de todos los IDs de objetos de diapositivas de la presentación. Los IDs se muestran en el orden de presentación de las diapositivas y se pueden usar para indicar diapositivas específicas en solicitudes posteriores a la API. Puedes obtener los IDs de objeto de las páginas maestras y de diseño de la misma manera, con fields=masters.objectId y fields=layout.objectId.
El siguiente es el protocolo de solicitud para leer los IDs de objetos de 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 los objetos 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 objetos de elementos de una página
En la siguiente muestra de código de presentations.pages.get, se muestra cómo recuperar una lista de IDs de objetos para todos los elementos de una página.
El siguiente es el protocolo de solicitud para leer los IDs de objetos de elementos 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"
}
]
}Lee elementos de forma de una página
En la siguiente muestra de código de presentations.pages.get, se muestra cómo recuperar una lista de todos los Shapes en una página. Puedes recuperar otros tipos de 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. Los corchetes vacíos 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 } } } ] } } }, ... ] }