קריאה בסיסית

באמצעות 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
                }
              }
            }
          ]
        }
      }
    },
    ...
  ]
}