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