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

تتيح لك واجهة برمجة التطبيقات "العروض التقديمية من Google" قراءة بيانات العرض التقديمي والصفحة وعناصر الصفحة. توضّح الأمثلة في هذه الصفحة كيفية تنفيذ عمليات القراءة الشائعة باستخدام كلٍّ من الطريقتَين 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
                }
              }
            }
          ]
        }
      }
    },
    ...
  ]
}