La API de Presentaciones de Google te permite leer datos de presentaciones, páginas y elementos de páginas. El
los ejemplos en esta página muestran cómo realizar operaciones comunes de lectura utilizando tanto
presentations.get y
presentations.pages.get
.
En estos ejemplos, se usan los siguientes marcadores de posición:
- PRESENTATION_ID: Indica dónde proporcionas la presentación correcto. Puedes descubrirá el valor para este ID desde la URL de presentación.
- PAGE_ID: Indica dónde se proporciona el objeto de página. correcto. Puedes recuperar el valor para esto desde la URL o mediante una solicitud de lectura de la API.
Estos ejemplos se presentan como solicitudes HTTP para que no tengan idioma. El
ejemplos leídos de este ejemplo
una presentación,
que tiene 1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc como su
PRESENTATION_ID El PAGE_ID del
primero
diapositiva
de esta presentación es ge63a4b4_1_0.
En estos ejemplos, se usan máscaras de campo para solo devolver información específica solicitada acerca de la presentación, diapositiva y página . El uso de máscaras de campo también mejora el rendimiento.
Leer los IDs de objeto de las diapositivas
Lo siguiente
Código de presentations.get
muestra cómo recuperar una lista de todos los IDs de objeto de diapositiva del
presentación. Los IDs se devuelven en el orden de presentación de diapositivas y se pueden
para indicar diapositivas específicas en solicitudes posteriores a la API. Puedes obtener la
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 objeto de las 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 objeto 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 los elementos de una página
Lo siguiente
presentations.pages.get
la muestra de código muestra cómo recuperar una lista de IDs de objeto para todos los elementos de la página
en una página.
A continuación, se muestra 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 contenga 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
Lo siguiente
presentations.pages.get
de código de muestra muestra cómo recuperar una lista de todas
Shapes
en una página. Puedes recuperar otros
PageElement
de tipos especificándolos con el parámetro fields. Por ejemplo:
fields=pageElements(line,table) solo devuelve 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 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 contenga los elementos de forma solicitados. Las llaves vacías indican los elementos de página
que no son del 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
}
}
}
]
}
}
},
...
]
}