La API de Google Slides 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 este ID desde la URL o mediante una solicitud de lectura de la API.
Estos ejemplos se presentan como solicitudes HTTP para que sean independientes del lenguaje. Los
ejemplos leen de esta presentación
de ejemplo,
que tiene 1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc como su
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 específica solicitada 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 objetos de diapositivas
En la siguiente
presentations.get muestra de
código 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 la presentación de diapositivas y se pueden usar para indicar diapositivas específicas en solicitudes posteriores a la API. Puedes obtener los IDs de objetos de las páginas principales 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
Presentation
objeto que contiene los IDs de 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
presentations.pages.get
muestra de código, se muestra cómo recuperar una lista de IDs de objetos para todos los elementos de página
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
Page objeto
que contiene los IDs de objetos solicitados:
{
"pageElements": [
{
"objectId": "ge63a4b4_1_5"
},
{
"objectId": "ge63a4b4_1_6"
},
{
"objectId": "ge63a4b4_1_7"
},
{
"objectId": "ge63a4b4_1_8"
}
]
}Lee los elementos de forma de una página
En la siguiente
presentations.pages.get
muestra de código, se muestra cómo recuperar una lista de todas las
Shapes
de una página. Puedes recuperar otros
PageElement
tipos especificándolos con el parámetro fields. Por ejemplo,
fields=pageElements(line,table) solo muestra información sobre
line y
table
elementos de página, si hay alguno en la página.
El siguiente es el protocolo de solicitud para leer los 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
Page objeto
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 } } } ] } } }, ... ] }