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

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