Grundlagen

Mit der Google Slides API können Sie Daten zu Präsentationen, Seiten und Seitenelementen lesen. Die Beispiele auf dieser Seite zeigen, wie Sie mit den Methoden presentations.get und presentations.pages.get häufige Lesevorgänge ausführen.

In diesen Beispielen werden die folgenden Platzhalter verwendet:

  • PRESENTATION_ID: Gibt an, wo Sie die Präsentations ID angeben. Sie finden den Wert für diese ID in der Präsentations-URL.
  • PAGE_ID—Gibt an, wo Sie die Objekt-ID der Seite angeben. Sie können den Wert für diese ID aus der URL oder mit einer API-Leseanfrage abrufen.

Diese Beispiele werden als HTTP-Anfragen dargestellt, um sprachneutral zu sein. In den Beispielen werden Daten aus dieser Beispiel präsentation gelesen, deren 1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc PRESENTATION_ID ist. Die PAGE_ID der ersten Folie in dieser Präsentation ist ge63a4b4_1_0.

In den Beispielen hier werden Feldmasken verwendet, um nur bestimmte angeforderte Informationen zur Präsentation, Folie und zum Seiten element zurückzugeben. Die Verwendung von Feldmasken verbessert auch die Leistung.

Objekt-IDs von Folien lesen

Das folgende presentations.get Code beispiel zeigt, wie Sie eine Liste aller Objekt-IDs von Folien aus der Präsentation abrufen. Die IDs werden in der Reihenfolge der Folien in der Präsentation zurückgegeben und können verwendet werden, um bestimmte Folien in nachfolgenden API-Anfragen anzugeben. Sie können die Objekt-IDs von Master- und Layoutseiten auf dieselbe Weise abrufen, indem Sie fields=masters.objectId und fields=layout.objectId verwenden.

Das folgende Protokoll zeigt, wie Sie Objekt-IDs von Folien lesen:

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"
    }
  ]
}

Objekt-IDs von Elementen auf einer Seite lesen

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

Das folgende Protokoll zeigt, wie Sie Objekt-IDs von Elementen auf einer Seite lesen:

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 von einer Seite lesen

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

Das folgende Protokoll zeigt, wie Sie Formelemente von einer Seite lesen:

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 geben Seitenelemente an, die nicht vom Typ „Form“ sind. In diesem Fall sind es Bild-Seitenelemente.

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