การอ่านพื้นฐาน

Google Slides API ให้คุณอ่านข้อมูลงานนำเสนอ หน้าเว็บ และองค์ประกอบหน้าเว็บได้ ตัวอย่างในหน้านี้แสดงวิธีดำเนินการอ่านทั่วไปโดยใช้ทั้งเมธอด presentations.get และ presentations.pages.get

ตัวอย่างเหล่านี้ใช้ตัวยึดตําแหน่งต่อไปนี้

• PRESENTATION_ID - ระบุตำแหน่งที่คุณระบุรหัสงานนำเสนอ คุณจะค้นพบค่าสำหรับรหัสนี้ได้จาก URL ของงานนำเสนอ
• PAGE_ID - ระบุตำแหน่งที่คุณระบุรหัสออบเจ็กต์หน้าเว็บ คุณสามารถดึงค่านี้ได้จาก URL หรือใช้คําขออ่าน API

ตัวอย่างเหล่านี้จะแสดงเป็นคำขอ HTTP เพื่อเป็นกลางทางภาษา ตัวอย่างที่อ่านจากตัวอย่างการนำเสนอนี้ ซึ่งมี1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vucเป็นPRESENTATION_ID PAGE_ID ของสไลด์แรกในงานนำเสนอนี้คือ ge63a4b4_1_0

ตัวอย่างที่นี่ใช้มาสก์ช่องเพื่อแสดงเฉพาะข้อมูลที่ร้องขอเกี่ยวกับองค์ประกอบของงานนำเสนอ สไลด์ และหน้าเว็บ การใช้มาสก์ฟิลด์ยังช่วยปรับปรุงประสิทธิภาพด้วย

อ่านรหัสออบเจ็กต์สไลด์

ตัวอย่างโค้ด presentations.get ต่อไปนี้แสดงวิธีเรียกข้อมูลรายการรหัสออบเจ็กต์สไลด์ทั้งหมดจากงานนำเสนอ ระบบจะแสดงผลรหัสตามลําดับการนำเสนอของสไลด์ และสามารถใช้เพื่อระบุสไลด์ที่เฉพาะเจาะจงในคําขอ API ที่ตามมา คุณรับรหัสออบเจ็กต์ของหน้าหลักและหน้าเลย์เอาต์ได้โดยใช้ fields=masters.objectId และ fields=layout.objectId ในลักษณะเดียวกัน

ต่อไปนี้คือโปรโตคอลคำขอเพื่ออ่านรหัสออบเจ็กต์สไลด์

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

การตอบกลับประกอบด้วยออบเจ็กต์ Presentation ที่มีรหัสออบเจ็กต์ที่ขอ

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

อ่านรหัสออบเจ็กต์องค์ประกอบจากหน้าเว็บ

ตัวอย่างโค้ด presentations.pages.get ต่อไปนี้แสดงวิธีเรียกข้อมูลรายการรหัสออบเจ็กต์สำหรับองค์ประกอบหน้าเว็บทั้งหมดในหน้าเว็บ

ต่อไปนี้คือโปรโตคอลคำขอเพื่ออ่านรหัสออบเจ็กต์องค์ประกอบจากหน้าเว็บ

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

การตอบกลับประกอบด้วยออบเจ็กต์ Page ซึ่งมีรหัสออบเจ็กต์ที่ขอ

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

อ่านองค์ประกอบรูปร่างจากหน้าเว็บ

ตัวอย่างโค้ด presentations.pages.get ต่อไปนี้แสดงวิธีเรียกข้อมูลรายการ Shapes ทั้งหมดในหน้าเว็บ คุณสามารถเรียกข้อมูลประเภทอื่นๆ ของ PageElement ได้โดยการระบุโดยใช้พารามิเตอร์ fields ตัวอย่างเช่น fields=pageElements(line,table) จะแสดงเฉพาะข้อมูลเกี่ยวกับองค์ประกอบ line และ table เท่านั้น หากมีอยู่ในหน้า

คำขอ

Slides API presentations.pages.get สามารถแสดงผลพร็อพเพอร์ตี้ทั้งหมดของรูปร่าง รวมถึงพร็อพเพอร์ตี้ที่ API แก้ไขไม่ได้

ต่อไปนี้คือโปรโตคอลคำขอเพื่ออ่านองค์ประกอบรูปร่างจากหน้าเว็บ

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

การตอบกลับประกอบด้วยออบเจ็กต์ Page ซึ่งมีองค์ประกอบรูปร่างที่ขอ วงเล็บปีกกาว่างๆ หมายถึงองค์ประกอบของหน้าเว็บที่ไม่ใช่ประเภทรูปร่าง ในกรณีนี้คือองค์ประกอบหน้ารูปภาพ

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