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