Czytanie podstawowe

Google Slides API umożliwia odczytywanie danych prezentacji, stron i elementów stron. Przykłady na tej stronie pokazują, jak wykonywać typowe operacje odczytu za pomocą metod presentations.get i presentations.pages.get.

W tych przykładach używane są te wartości zastępcze:

  • PRESENTATION_ID – wskazuje, gdzie należy podać identyfikator prezentacji. Wartość tego identyfikatora możesz znaleźć w adresie URL prezentacji.
  • PAGE_ID – wskazuje, gdzie należy podać identyfikator obiektu strony. Wartość tego identyfikatora możesz pobrać z adresu URL lub za pomocą żądania odczytu z interfejsu API.

Te przykłady są przedstawione jako żądania HTTP, aby były niezależne od języka. Przykłady odczytują dane z tej przykładowej prezentacji, która ma wartość 1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc jako PRESENTATION_ID. PAGE_ID z pierwszego slajdu w tej prezentacji to ge63a4b4_1_0.

Przykłady używają masek pól, aby zwracać tylko określone informacje o prezentacji, slajdzie i elemencie strony. Używanie masek pól poprawia też wydajność.

Odczytywanie identyfikatorów obiektów slajdów

Poniższy presentations.get przykładowy kod pokazuje, jak pobrać listę wszystkich identyfikatorów obiektów slajdów z prezentacji. Identyfikatory są zwracane w kolejności slajdów w prezentacji i mogą służyć do wskazywania konkretnych slajdów w kolejnych żądaniach do interfejsu API. Identyfikatory obiektów stron wzorcowych i układów możesz uzyskać w ten sam sposób, używając fields=masters.objectId i fields=layout.objectId.

Oto protokół żądania do odczytywania identyfikatorów obiektów slajdów:

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

Odpowiedź składa się z Presentation obiektu zawierającego żądane identyfikatory obiektów:

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

Odczytywanie identyfikatorów obiektów elementów ze strony

Poniższy presentations.pages.get przykładowy kod pokazuje, jak pobrać listę identyfikatorów obiektów wszystkich elementów strony na stronie.

Oto protokół żądania do odczytywania identyfikatorów obiektów elementów ze strony:

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

Odpowiedź składa się z Page obiektu zawierającego żądane identyfikatory obiektów:

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

Odczytywanie elementów kształtów ze strony

Poniższy presentations.pages.get przykładowy kod pokazuje, jak pobrać listę wszystkich Shapes na stronie. Inne rodzaje PageElement możesz pobrać, określając je za pomocą parametru fields. Na przykład, fields=pageElements(line,table) zwraca tylko informacje o line i table elementach strony, jeśli znajdują się one na stronie.

Oto protokół żądania do odczytywania elementów kształtów ze strony:

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

Odpowiedź składa się z obiektu Page zawierającego żądane elementy kształtów. Puste nawiasy klamrowe wskazują elementy strony, które nie są typu kształtu. W tym przypadku są to elementy strony obrazu.

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