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

تتيح لك واجهة برمجة تطبيقات "العروض التقديمية من Google" قراءة بيانات العرض التقديمي والصفحة وعناصر الصفحة. توضح الأمثلة في هذه الصفحة كيفية إجراء عمليات القراءة الشائعة باستخدام الطريقتين presentations.get وpresentations.pages.get.

تستخدم هذه الأمثلة المتغيرات التالية:

• presentationId — تشير إلى مكان تقديم معرّف العرض التقديمي. يمكنك اكتشاف قيمة رقم التعريف هذا من عنوان URL للعرض التقديمي.
• pageId — تشير إلى المكان الذي تقدم فيه رقم تعريف كائن الصفحة. يمكنك استرداد قيمة هذا من عنوان URL أو باستخدام طلب قراءة لواجهة برمجة التطبيقات.

تمت قراءة هذه الأمثلة من هذا العرض التقديمي، الذي يتضمن 1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc باعتباره presentationId. pageId من الشريحة الأولى في هذا العرض التقديمي هي ge63a4b4_1_0.

تستخدم الأمثلة هنا أقنعة الحقل لعرض معلومات مطلوبة محددة فقط حول العرض التقديمي والشرائح وعناصر الصفحة. ويؤدي استخدام أقنعة الحقل بهذه الطريقة إلى تحسين الأداء.

قراءة أرقام تعريف كائنات الشرائح

يسترد طلب presentations.get التالي قائمة بجميع معرّفات كائنات الشرائح من العرض التقديمي. يتم عرض المعرّفات بترتيب عرض الشرائح، ويمكن استخدامها للإشارة إلى شرائح معينة في طلبات واجهة برمجة التطبيقات التالية. يمكنك الحصول على معرّفات الكائنات للصفحات الرئيسية وصفحات التنسيق بالطريقة نفسها، وذلك باستخدام fields=masters.objectId وfields=layout.objectId.

GET https://slides.googleapis.com/v1/presentations/presentationId?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/presentationId/pages/pageId?fields=pageElements.objectId

الاستجابة لاستدعاء هذه الطريقة هي كائن Page يحتوي على المكوّنات المطلوبة:

{
  "pageElements": [
    {
      "objectId": "ge63a4b4_1_5"
    },
    {
      "objectId": "ge63a4b4_1_6"
    },
    {
      "objectId": "ge63a4b4_1_7"
    },
    {
      "objectId": "ge63a4b4_1_8"
    }
  ]
}

قراءة عناصر الشكل من صفحة

يسترد طلب presentations.pages.get التالي قائمة بجميع عناصر الشكل على الصفحة. يمكنك استرداد أنواع عناصر الصفحة الأخرى من خلال تحديدها باستخدام المعلمة fields. على سبيل المثال، لا يعرض fields=pageElements(line,table) سوى معلومات عن عناصر صفحة السطر والجدول، في حال توفّر أي عنصر في الصفحة.

يظهر بروتوكول الطلب لهذا المثال أدناه.

GET https://slides.googleapis.com/v1/presentations/presentationId/pages/pageId?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
                }
              }
            }
          ]
        }
      }
    },
    ...
  ]
}