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

تتيح لك واجهة برمجة تطبيقات "العروض التقديمية من 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
                }
              }
            }
          ]
        }
      }
    },
    ...
  ]
}