Google Slides API מאפשר לקרוא נתוני מצגות, דפים ורכיבים בדפים.
בדף הזה מראים איך לבצע פעולות קריאה נפוצות באמצעות
presentations.get
ו-
presentations.pages.get
שיטות.
בדוגמאות האלה נעשה שימוש ב-placeholders הבאים:
- 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 } } } ] } } }, ... ] }