Lectura básica

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
                }
              }
            }
          ]
        }
      }
    },
    ...
  ]
}