Pembacaan dasar

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

Contoh-contoh ini menggunakan placeholder berikut:

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

Contoh ini disajikan sebagai permintaan HTTP agar tidak menggunakan bahasa yang netral. Tujuan contoh baca dari contoh ini presentasi, yang memiliki 1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc sebagai PRESENTATION_ID. PAGE_ID dari pertama slide dalam presentasi ini adalah ge63a4b4_1_0.

Contoh di sini menggunakan mask kolom hanya untuk mengembalikan informasi spesifik yang diminta tentang presentasi, slide, dan halaman . Menggunakan mask kolom juga akan meningkatkan performa.

Membaca ID objek slide

Hal berikut Kode presentations.get contoh menunjukkan cara mengambil daftar semua ID objek slide dari presentasi. ID ditampilkan dalam urutan presentasi {i>slide<i}, dan dapat digunakan untuk menunjukkan slide tertentu dalam permintaan API berikutnya. Anda bisa mendapatkan ID objek halaman master dan halaman tata letak dengan cara yang sama, 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 Presentation objek 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

Hal berikut presentations.pages.get contoh kode menunjukkan cara mengambil daftar ID objek untuk semua elemen halaman pada 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 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 halaman

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

Berikut adalah protokol permintaan untuk membaca elemen bentuk dari sebuah halaman:

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

Respons terdiri dari Objek Page berisi elemen bentuk yang diminta. Kurung kurawal kosong menunjukkan elemen halaman yang tidak sesuai dengan bentuknya; dalam hal 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
                }
              }
            }
          ]
        }
      }
    },
    ...
  ]
}