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