קריאה בסיסית

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