Lectura básica

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