تتيح لك Google Slides API إنشاء الشرائح ونقلها وحذفها. تعرض الأمثلة الواردة في هذه الصفحة بعض عمليات الشرائح الشائعة باستخدام طريقة presentations.batchUpdate.
تستخدم هذه الأمثلة المتغيرات التالية:
- PRESENTATION_ID: يشير إلى مكان توفير رقم تعريف العرض التقديمي. يمكنك اكتشاف قيمة هذا المعرّف من عنوان URL للعرض التقديمي.
- PAGE_ID وPAGE_ID2: يشير إلى مكان توفير معرّفات عنصر الصفحة. يمكنك استرداد قيمة هذا من عنوان URL أو باستخدام طلب قراءة واجهة برمجة التطبيقات.
ويتم تقديم هذه الأمثلة على شكل طلبات HTTP لكي تكون محايدة لغويًا. لمعرفة كيفية تنفيذ تحديث مجمّع بلغات مختلفة باستخدام مكتبات عملاء واجهة Google API، يمكنك الاطّلاع على الأدلة التالية: إنشاء عرض تقديمي وإضافة أشكال ونصوص.
نسخ شريحة
يوضح نموذج التعليمات البرمجية presentations.batchUpdate التالي كيفية استخدام طريقة DuplicateObjectRequest لنسخ شريحة وإدخالها بعد الأصل في العرض التقديمي.
تم تحديد الشريحة الأصلية بواسطة PAGE_ID.
يتيح لك الطلب تحديد ما إذا كان يجب تضمين بعض أو كل معرّفات عناصر الصفحة في النسخة (مع تطبيق بعض القيود). في هذا المثال، تحتوي الشريحة الأصلية على عنصر جدول (محدد بواسطة TABLE_ELEMENT_ID)، تم ربطه بجدول جديد (محدد بواسطة COPY_TABLE_ELEMENT_ID) في نسخة الشريحة (المحدد في COPY_PAGE_ID). ويتم منح معرّفات عشوائية لجميع العناصر الأخرى الموجودة على النسخة.
للحصول على مزيد من المعلومات حول نسخ عنصر PageElement، بما في ذلك مربّعات النص والصور والجداول والأشكال الأساسية والخطوط والفيديوهات المضمّنة، اطّلِع على نموذج نسخ عنصر وتعديله.
في ما يلي بروتوكول الطلب لنسخ شريحة:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"duplicateObject": {
"objectId": PAGE_ID,
"objectIds": {
"PAGE_ID": "COPY_PAGE_ID",
"TABLE_ELEMENT_ID": "COPY_TABLE_ELEMENT_ID"
}
}
}
]
}
إنشاء شريحة
يوضّح نموذج التعليمات البرمجية presentations.batchUpdate التالي كيفية استخدام طريقة
CreateSlideRequest
لإنشاء شريحة وإدخالها كشريحة رابعة (باستخدام الطريقة الصفرية insertionIndex) في العرض التقديمي.
تم إعداد الشريحة الجديدة لاستخدام PredefinedLayout من TITLE_AND_TWO_COLUMNS. يمكنك تحديد سلسلة لاستخدامها بصفتها PAGE_ID للشريحة (مع بعض
القيود)،
أو السماح لواجهة برمجة التطبيقات بإنشاء PAGE_ID عن طريق حذف الحقل
في الطلب.
فيما يلي بروتوكول الطلب لإنشاء شريحة:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"createSlide": {
"objectId": "PAGE_ID",
"insertionIndex": 3,
"slideLayoutReference": {
"predefinedLayout": "TITLE_AND_TWO_COLUMNS"
}
}
}
]
}
إنشاء شريحة وتعديل العناصر النائبة
يوضّح نموذج التعليمات البرمجية presentations.batchUpdate التالي كيفية استخدام طريقة CreateSlideRequest لإنشاء شريحة باستخدام PredefinedLayout في TITLE_AND_TWO_COLUMNS.
ويمكنك تحديد سلسلة لاستخدامها كـ PAGE_ID للشريحة (مع بعض
القيود).
تستخدم السمة
placeholderIdMappings
Type من
TITLE. تشير TITLE_ID إلى شكل العنصر النائب
للشريحة بحيث يمكن تعديله.
فيما يلي بروتوكول الطلب لإنشاء شريحة وتعديل العناصر النائبة:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"createSlide": {
"objectId": PAGE_ID,
"slideLayoutReference": {
"predefinedLayout": "TITLE_AND_TWO_COLUMNS"
},
"placeholderIdMappings": [
{
"layoutPlaceholder": {
"type": "TITLE",
"index": 0
},
"objectId": TITLE_ID,
},
],
}
},
{
"insertText": {
"objectId": TITLE_ID,
"text": "This is my slide title",
}
},
]
}
نقل الشرائح إلى موضع جديد
يوضح نموذج التعليمات البرمجية presentations.batchUpdate التالي كيفية استخدام طريقة UpdateSlidesPositionRequest لأخذ الشريحتين المحددتين ونقلهما إلى بداية العرض التقديمي، مع الحفاظ على ترتيبهما النسبي.
يجب توفير معرّفات الشرائح المحددة (PAGE_ID وPAGE_ID2)
بترتيب العرض التقديمي الحالي، بدون تكرارات. تشير السمة insertionIndex التي تستند إلى الصفر إلى المكان الذي يجب إدراج الشرائح فيه، بناءً على الترتيب قبل حدوث عملية النقل. يجب أن تكون القيمة بين صفر وعدد الشرائح
في العرض التقديمي، بشكل شامل.
في ما يلي بروتوكول الطلب لنقل الشرائح إلى موضع جديد:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"updateSlidesPosition": {
"slideObjectIds": [
PAGE_ID,
PAGE_ID2
],
"insertionIndex": 0
}
}
]
}
ضبط صورة خلفية للشريحة
يوضّح نموذج التعليمات البرمجية presentations.batchUpdate التالي كيفية استخدام طريقة
UpdatePagePropertiesRequest
لضبط صورة خلفية الشريحة التي تحدّدها
PAGE_ID. تسترد واجهة برمجة التطبيقات الصورة باستخدام
IMAGE_URL.
يُستخدم قناع الحقل لتحديد ضرورة تغيير خلفية الشريحة فقط للحفاظ على الخصائص الأخرى. استخدام أقنعة الحقول يؤدي إلى تحسين الأداء أيضًا.
بدلاً من ذلك، يمكن استخدام طريقة UpdatePagePropertiesRequest لضبط
خلفية الشريحة على لون ثابت.
في ما يلي بروتوكول الطلب لضبط صورة خلفية للشريحة:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"updatePageProperties": {
"objectId": PAGE_ID,
"pageProperties": {
"pageBackgroundFill": {
"stretchedPictureFill": {
"contentUrl": IMAGE_URL
}
}
},
"fields": "pageBackgroundFill"
}
}
]
}
إنشاء صورة مصغّرة
يمكنك إنشاء صورة مصغّرة لأحدث نسخة من صفحة محدّدة في
العرض التقديمي من خلال استدعاء طريقة
presentations.pages.getThumbnail،
التي تعرض صورة مصغّرة للصفحة كعنوان URL للمحتوى. عمر عنوان URL
الخاص بالصورة هو 30 دقيقة بشكل تلقائي.
ويمكنك أيضًا تحديد المَعلمتَين mimeType وthumbnailSize الذين يتم عرضهما باستخدام الحقل
ThumbnailProperties
كمَعلمة طلب بحث.
في ما يلي بروتوكول الطلب لإنشاء صورة مصغّرة للصفحة باستخدام مجموعة ThumbnailProperties:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID/thumbnail?thumbnailProperties.mimeType=PNG&thumbnailProperties.thumbnailSize=MEDIUM
{
"width": 800,
"height": 450,
"contentUrl": "CONTENT_URL"
}