La API de Presentaciones de Google 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 comunes de lectura 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 obtener el valor para esto desde la URL o a través de una solicitud de lectura de API.
Estos ejemplos se presentan como solicitudes HTTP para que tengan lenguaje neutral. Los ejemplos se leen desde 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 estos los ejemplos se usan máscaras de campo para mostrar solo información solicitada y específica de 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 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 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 de API posteriores. Del mismo modo, puedes obtener los ID de objeto de las páginas maestras y de diseño, usando 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 objeto de elemento 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 página de una página.
El siguiente es 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 muestra cómo recuperar una lista de todos los Shapes en una página. Puedes obtener otros tipos de PageElement especificando los parámetros 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 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 página que no corresponden al tipo de forma; en este caso, son elementos de 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
}
}
}
]
}
}
},
...
]
}