קריאה בסיסית

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
                }
              }
            }
          ]
        }
      }
    },
    ...
  ]
}