خواندن پایه

API اسلایدهای گوگل به شما امکان می‌دهد داده‌های ارائه، صفحه و عناصر صفحه را بخوانید. مثال‌های این صفحه نحوه انجام عملیات خواندن رایج را با استفاده از هر دو روش presentations.get و presentations.pages.get نشان می‌دهند.

این مثال‌ها از متغیرهای زیر استفاده می‌کنند:

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