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

تتيح لك واجهة برمجة التطبيقات 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 في صفحة. يمكنك استرداد أنواع أخرى من خلال تحديدها باستخدام المَعلمة fields.PageElement على سبيل المثال، لا تعرض 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
                }
              }
            }
          ]
        }
      }
    },
    ...
  ]
}