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

تتيح لك واجهة برمجة تطبيقات "العروض التقديمية من Google" إنشاء العروض التقديمية ونقلها وحذفها. توضح الأمثلة في هذه الصفحة بعض عمليات الشرائح الشائعة التي يمكن تحقيقها باستخدام واجهة برمجة التطبيقات.

تستخدم هذه الأمثلة المتغيرات التالية:

  • presentationId — تشير إلى مكان تقديم معرّف العرض التقديمي. يمكنك اكتشاف قيمة رقم التعريف هذا من عنوان URL للعرض التقديمي.
  • pageId وpageId2 — اذكر مكان تقديم معرِّفات كائن الصفحة. يمكنك استرداد قيمة هذا من عنوان URL أو باستخدام طلب قراءة لواجهة برمجة التطبيقات.

نسخ شريحة

ينشئ طلب presentations.batchUpdate التالي نسخة من الشريحة ويدرجها بعد النسخة الأصلية في العرض التقديمي. تم تحديد الشريحة الأصلية بواسطة pageId.

يتيح لك الطلب تحديد بعض أو جميع أرقام تعريف عناصر الصفحة التي يجب تضمينها في النسخة، مع تطبيق بعض القيود. في هذا المثال، تحتوي الشريحة الأصلية على عنصر جدول (محدّد من خلال المعرّف tableElement_01)، يتم ربطه بجدول جديد (بالمعرّف copiedTable_001) في نسخة الشريحة (التي يتم منحها رقم التعريف copiedSlide_001). يتم منح أرقام التعريف العشوائية لجميع العناصر الأخرى في النسخة.

يظهر بروتوكول الطلب أدناه. يعرض دليل إنشاء شريحة مثالاً ينفذ تحديثًا مجمعًا بلغات مختلفة باستخدام مكتبات برامج Google API.

POST https://slides.googleapis.com/v1/presentations/presentationId:batchUpdate
{
  "requests": [
    {
      "duplicateObject": {
        "objectId": pageId,
        "objectIds": {
          "pageId": "copiedSlide_001",
          "tableElement_01": "copiedTable_001"
        }
      }
    }
  ]
}

إنشاء شريحة

يؤدي طلب presentations.batchUpdate التالي إلى إنشاء شريحة جديدة وإدراجها كشريحة رابعة في العرض التقديمي. تم تعيين الشريحة الجديدة لاستخدام تنسيق "العنوان وعمودين" المحدد مسبقًا. يمكنك تحديد سلسلة لاستخدامها كـ pageId للشريحة (مع بعض القيود)، أو السماح لواجهة برمجة التطبيقات بإنشاء pageId عن طريق حذف الحقل في الطلب.

يظهر بروتوكول الطلب أدناه. يعرض دليل إنشاء شريحة مثالاً ينفذ تحديثًا مجمعًا بلغات مختلفة باستخدام مكتبات برامج Google API.

POST https://slides.googleapis.com/v1/presentations/presentationId:batchUpdate
{
  "requests": [
    {
      "createSlide": {
        "objectId": pageId,
        "insertionIndex": 3,
        "slideLayoutReference": {
          "predefinedLayout": "TITLE_AND_TWO_COLUMNS"
        }
      }
    }
  ]
}

إنشاء شريحة وتعديل العناصر النائبة

ينشئ طلب presentations.batchUpdate التالي شريحة جديدة باستخدام التنسيق المحدَّد مسبقًا "العنوان وعمودان" ويحدِّد العنوان.

POST https://slides.googleapis.com/v1/presentations/presentationId:batchUpdate
{
  "requests": [
    {
      "createSlide": {
        "objectId": pageId,
        "slideLayoutReference": {
          "predefinedLayout": "TITLE_AND_TWO_COLUMNS"
        },
        "placeholderIdMappings": [
          {
            "layoutPlaceholder": {
              "type": "TITLE",
              "index": 0
            },
            "objectId": titleId,
           },
        ],
      }
    },
    {
      "insertText": {
        "objectId": titleId,
        "text": "This is my slide title",
      }
    },
  ]
}

نقل الشرائح إلى موضع جديد

يأخذ طلب presentations.batchUpdate الشريحتين المحددتين وينقلهما إلى بداية العرض التقديمي، مع الحفاظ على ترتيبها النسبي. يجب تقديم أرقام تعريف الشرائح المحددة بترتيب العرض التقديمي الحالي، بدون تكرارات.

يظهر بروتوكول الطلب أدناه. ويوضح دليل إضافة نص وأشكال مثالاً ينفذ تحديثًا مجمعًا بلغات مختلفة باستخدام مكتبات برامج Google API.

POST https://slides.googleapis.com/v1/presentations/presentationId:batchUpdate
{
  "requests": [
    {
      "updateSlidesPosition": {
        "slideObjectIds": [
          pageId,
          pageId2
        ],
        "insertionIndex": 0
      }
    }
  ]
}

تعيين صورة خلفية للشريحة

يعيّن طلب presentations.batchUpdate التالي صورة الخلفية للشريحة المُصغَّرة بمقدار pageId. لا يُستخدم القناع الميداني إلا لتحديث خلفية الشريحة بدون تغيير خصائصها الأخرى. يتم تحديد الصورة من خلال تقديم عنوان URL (imageUrl) تجلبه واجهة برمجة التطبيقات. بدلاً من ذلك، يمكن استخدام طلب updatePageProperties لضبط خلفية الشريحة على لون ثابت.

يظهر بروتوكول الطلب أدناه. يعرض دليل إنشاء شريحة مثالاً ينفذ تحديثًا مجمعًا بلغات مختلفة باستخدام مكتبات برامج Google API.

POST https://slides.googleapis.com/v1/presentations/presentationId:batchUpdate
{
  "requests": [
    {
      "updatePageProperties": {
        "objectId": pageId,
        "pageProperties": {
          "pageBackgroundFill": {
            "stretchedPictureFill": {
              "contentUrl": imageUrl
            }
          }
        },
        "fields": "pageBackgroundFill"
      }
    }
  ]
}