באמצעות 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 שמכיל את רכיבי הצורה המבוקשים. סוגריים מסולסלים ריקים מציינים מרכיבי דף שאינם מסוג shape. במקרה הזה, הם מרכיבי דף של תמונות.
{ "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 } } } ] } } }, ... ] }