קריאה בסיסית

Google Slides API מאפשר לקרוא נתונים של מצגות, דפים ורכיבים בדפים. הדוגמאות בדף הזה מראות איך לבצע פעולות קריאה נפוצות באמצעות השיטה presentations.get ו-presentations.pages.get.

בדוגמאות הבאות נעשה שימוש ב-placeholders הבאים:

  • PRESENTATION_ID – מציין איפה מספקים את מזהה המצגת. אפשר לאתר את הערך של המזהה הזה בכתובת ה-URL של המצגת.
  • PAGE_ID – מציין איפה מספקים את מזהה האובייקט של הדף. אפשר לאחזר את הערך מכתובת ה-URL או באמצעות בקשת קריאה ל-API.

הדוגמאות האלה מוצגות כבקשות HTTP כדי לא לשנות את השפה. הדוגמאות מבוססות על המצגת לדוגמה, שהPRESENTATION_ID שלה הוא 1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc. ה-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
                }
              }
            }
          ]
        }
      }
    },
    ...
  ]
}