القراءة الأساسية

تتيح لك Google Slides API قراءة بيانات عناصر العرض التقديمي والصفحات والصفحة. تشير رسالة الأشكال البيانية الأمثلة في هذه الصفحة كيفية إجراء عمليات القراءة الشائعة باستخدام كلٍ من presentations.get و presentations.pages.get الطرق.

تستخدم هذه الأمثلة العناصر النائبة التالية:

• PRESENTATION_ID: يشير إلى مكان تقديم عرض تقديمي المعرّف يمكنك اكتشاف قيمة هذا المعرّف من عنوان URL للعرض التقديمي.
• PAGE_ID: يشير إلى مكان تقديم عنصر الصفحة. المعرّف يمكنك استرداد قيمة هذه السمة من عنوان URL أو باستخدام طلب قراءة من واجهة برمجة التطبيقات.

ويتم تقديم هذه الأمثلة في صورة طلبات HTTP لتكون محايدة اللغة. تشير رسالة الأشكال البيانية أمثلة تمت قراءتها من هذا المثال العرض التقديمي، الذي يبلغ 1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc باعتباره PRESENTATION_ID PAGE_ID من الأول شريحة في هذا العرض التقديمي هي ge63a4b4_1_0.

تستخدم الأمثلة هنا أقنعة الحقول بهدف إرجاع المعلومات المحددة المطلوبة حول العرض التقديمي والشريحة والصفحة العنصر. يؤدي استخدام أقنعة الحقل أيضًا إلى تحسين الأداء.

قراءة أرقام تعريف كائنات الشرائح

ما يلي: رمز presentations.get طريقة استرداد قائمة بجميع معرّفات كائنات الشريحة من عرضنا التقديمي. يتم إرجاع المعرفات بترتيب عرض الشرائح، ويمكن للإشارة إلى شرائح محددة في طلبات واجهة برمجة التطبيقات اللاحقة. يمكنك الحصول على معرفات الكائنات للصفحات الرئيسية والصفحات الرئيسية بنفس الطريقة، باستخدام "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
                }
              }
            }
          ]
        }
      }
    },
    ...
  ]
}