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

تتيح لك 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
                }
              }
            }
          ]
        }
      }
    },
    ...
  ]
}