Grundlagen

Mit der Google Slides API können Sie Präsentations-, Seiten- und Seitenelementdaten lesen. Die Beispiele auf dieser Seite zeigen, wie gängige Lesevorgänge mit den Methoden presentations.get und presentations.pages.get ausgeführt werden.

In diesen Beispielen werden die folgenden Platzhalter verwendet:

  • PRESENTATION_ID gibt an, wo Sie die Präsentations-ID angeben. Sie können den Wert für diese ID der Präsentations-URL entnehmen.
  • PAGE_ID gibt an, wo Sie die Seitenobjekt-ID angeben. Sie können den Wert dafür aus der URL oder mithilfe einer API-Leseanfrage abrufen.

Diese Beispiele werden als HTTP-Anfragen dargestellt, um sprachneutral zu sein. Die Beispiele stammen aus dieser Beispielpräsentation, deren PRESENTATION_ID 1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc ist. Die PAGE_ID der ersten Folie dieser Präsentation ist ge63a4b4_1_0.

In den Beispielen hier werden Feldmasken verwendet, damit nur bestimmte angeforderte Informationen zur Präsentation, zur Folie und zum Seitenelement zurückgegeben werden. Durch die Verwendung von Feldmasken wird auch die Leistung verbessert.

IDs der Folienobjekte lesen

Im folgenden Codebeispiel für presentations.get sehen Sie, wie eine Liste aller Folienobjekt-IDs aus der Präsentation abgerufen wird. Die IDs werden in der Reihenfolge der Folienpräsentation zurückgegeben und können verwendet werden, um in nachfolgenden API-Anfragen bestimmte Folien zu kennzeichnen. Die Objekt-IDs der Master- und Layoutseiten können auf dieselbe Weise mit fields=masters.objectId und fields=layout.objectId abgerufen werden.

Im Folgenden finden Sie das Anfrageprotokoll zum Lesen der Folienobjekt-IDs:

GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID?fields=slides.objectId

Die Antwort besteht aus einem Presentation-Objekt, das die angeforderten Objekt-IDs enthält:

{
  "slides": [
    {
      "objectId": "ge63a4b4_1_0"
    },
    {
      "objectId": "ge63a4b4_1_9"
    },
    {
      "objectId": "ge63a4b4_1_23"
    },
    {
      "objectId": "ge63a4b4_1_35"
    },
    {
      "objectId": "ge63a4b4_1_43"
    }
  ]
}

Element-Objekt-IDs auf einer Seite lesen

Das folgende Codebeispiel für presentations.pages.get zeigt, wie eine Liste von Objekt-IDs für alle Seitenelemente auf einer Seite abgerufen wird.

Mit dem folgenden Anfrageprotokoll werden Element-Objekt-IDs von einer Seite gelesen:

GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID?fields=pageElements.objectId

Die Antwort besteht aus einem Page-Objekt, das die angeforderten Objekt-IDs enthält:

{
  "pageElements": [
    {
      "objectId": "ge63a4b4_1_5"
    },
    {
      "objectId": "ge63a4b4_1_6"
    },
    {
      "objectId": "ge63a4b4_1_7"
    },
    {
      "objectId": "ge63a4b4_1_8"
    }
  ]
}

Formelemente auf einer Seite lesen

Das folgende Codebeispiel presentations.pages.get zeigt, wie eine Liste aller Shapes auf einer Seite abgerufen wird. Sie können andere PageElement-Arten abrufen, indem Sie sie mit dem Parameter fields angeben. Beispielsweise gibt fields=pageElements(line,table) nur Informationen zu Seitenelementen line und table zurück, falls diese auf der Seite vorhanden sind.

Im Folgenden finden Sie das Anfrageprotokoll zum Lesen von Formelementen einer Seite:

GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID?fields=pageElements.shape

Die Antwort besteht aus einem Page-Objekt, das die angeforderten Formelemente enthält. Die leeren geschweiften Klammern kennzeichnen Seitenelemente, die nicht den Formtyp haben. In diesem Fall sind es Bildseitenelemente.

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