La API de Google Slides te permite leer presentaciones, páginas y datos de 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 presentación. Puedes descubrir el valor de 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 a la API.
Estos ejemplos se presentan como solicitudes HTTP para que tengan lenguaje neutro. 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 estos ejemplos, se usan máscaras de campo para mostrar solo la información 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.
Leer los ID de objeto de diapositiva
En la siguiente muestra de código de presentations.get
, se indica cómo recuperar una lista de todos los IDs de objetos de diapositiva de la presentación. Los IDs se muestran en el orden de presentación de diapositivas y se pueden usar para indicar diapositivas específicas en solicitudes a la API posteriores. 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
.
El siguiente es el protocolo de solicitud para leer los IDs de objeto de diapositiva:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID?fields=slides.objectId
La respuesta consta de un objeto Presentation
que contiene los ID de objeto 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 objeto de elemento de una página
En la siguiente muestra de código de presentations.pages.get
, se indica cómo recuperar una lista de IDs de objetos para todos los elementos de página que hay en una página.
A continuación, se muestra el protocolo de solicitud para leer los ID 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 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 hay alguno en la página.
A continuación, se muestra 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 objeto Page
que contiene los elementos de forma solicitados. Las llaves vacías indican elementos de la página que no son del tipo de forma; en este caso, son elementos de la página de imágenes.
{ "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 } } } ] } } }, ... ] }