La API de Google Slides 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 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 la página. Puedes recuperar el valor de la URL o con 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 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 devolver solo la información específica solicitada sobre la presentación, la diapositiva y el elemento de la página. El uso de máscaras de campo también mejora el rendimiento.
Lee los IDs de los objetos de la diapositiva
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 devuelven 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 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 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"
}
]
}Cómo leer 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 la 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"
}
]
}Cómo leer elementos de forma de una página
En el siguiente ejemplo de código de presentations.pages.get, se muestra cómo recuperar una lista de todos los Shapes de una página. Puedes recuperar otros tipos de PageElement especificándolos con el parámetro fields. Por ejemplo, fields=pageElements(line,table) solo devuelve información sobre los elementos de la página line y table, si hay alguno presente en la página.
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 la página que no son del tipo de forma; en este caso, son elementos de imagen de la página.
{ "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 } } } ] } } }, ... ] }