عمليات الشرائح

تتيح لك 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"
}