خواندن پایه

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

این نمونه ها از متغیرهای زیر استفاده می کنند:

• PRESENTATION_ID — محل ارائه شناسه ارائه را نشان می دهد. می توانید مقدار این شناسه را از نشانی اینترنتی ارائه کشف کنید.
• 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 را برمی‌گرداند، در صورتی که در صفحه وجود داشته باشد.

درخواست Slides API presentations.pages.get می‌تواند همه ویژگی‌هایی را که یک شکل دارد، از جمله مواردی که API نمی‌تواند ویرایش کند، برگرداند.

در زیر پروتکل درخواست برای خواندن عناصر شکل از یک صفحه است:

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