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