Pembacaan dasar

Google Slides API memungkinkan Anda membaca data presentasi, halaman, dan elemen halaman. Contoh di halaman ini menunjukkan cara melakukan operasi baca umum menggunakan metode presentations.get dan presentations.pages.get.

Contoh ini menggunakan placeholder berikut:

  • PRESENTATION_ID—Menunjukkan tempat Anda memberikan ID presentasi. Anda dapat menemukan nilai untuk ID ini dari URL presentasi.
  • PAGE_ID—Menunjukkan tempat Anda memberikan ID objek halaman. Anda dapat mengambil nilai ini dari URL atau dengan menggunakan permintaan baca API.

Contoh-contoh ini disajikan sebagai permintaan HTTP yang netral bahasa. Contoh dibaca dari presentasi contoh ini, yang memiliki 1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc sebagai PRESENTATION_ID-nya. PAGE_ID dari slide pertama dalam presentasi ini adalah ge63a4b4_1_0.

Contoh di sini menggunakan mask kolom untuk hanya menampilkan informasi tertentu yang diminta tentang presentasi, slide, dan elemen halaman. Penggunaan mask kolom juga meningkatkan performa.

Membaca ID objek slide

Contoh kode presentations.get berikut menunjukkan cara mengambil daftar semua ID objek slide dari presentasi. ID ditampilkan dalam urutan presentasi slide, dan dapat digunakan untuk menunjukkan slide tertentu dalam permintaan API berikutnya. Anda bisa mendapatkan ID objek halaman master dan tata letak dengan cara yang sama, menggunakan fields=masters.objectId dan fields=layout.objectId.

Berikut adalah protokol permintaan untuk membaca ID objek slide:

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

Respons terdiri dari objek Presentation yang berisi ID objek yang diminta:

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

Membaca ID objek elemen dari halaman

Contoh kode presentations.pages.get berikut menunjukkan cara mengambil daftar ID objek untuk semua elemen halaman di halaman.

Berikut adalah protokol permintaan untuk membaca ID objek elemen dari halaman:

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

Respons terdiri dari objek Page yang berisi ID objek yang diminta:

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

Membaca elemen bentuk dari sebuah halaman

Contoh kode presentations.pages.get berikut menunjukkan cara mengambil daftar semua Shapes di halaman. Anda dapat mengambil jenis PageElement lainnya dengan menentukannya menggunakan parameter fields. Misalnya, fields=pageElements(line,table) hanya menampilkan informasi tentang elemen halaman line dan table, jika ada di halaman.

Berikut adalah protokol permintaan untuk membaca elemen bentuk dari halaman:

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

Respons terdiri dari objek Page yang berisi elemen bentuk yang diminta. Tanda kurung kurawal kosong menunjukkan elemen halaman yang bukan dari jenis bentuk; dalam hal ini, elemen ini adalah elemen halaman gambar.

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