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

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