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

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 หากมีอยู่ในหน้า

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

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