الكتابة الأساسية

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

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

• PRESENTATION_ID: يشير إلى مكان تقديم عرض تقديمي المعرّف يمكنك اكتشاف قيمة هذا المعرّف من عنوان URL للعرض التقديمي.
• PAGE_ID: يشير إلى مكان تقديم عنصر الصفحة. المعرّف يمكنك استرداد قيمة هذه السمة من عنوان URL أو باستخدام طلب قراءة من واجهة برمجة التطبيقات.
• PAGE_ELEMENT_ID—يشير إلى مكان تقديم الصفحة معرف عنصر العنصر. إِنْتَ يمكنك تحديد هذا المعرف للعناصر التي تقوم بإنشائها (باستخدام بعض القيود) أو السماح لواجهة Slides API بإنشاء حساب تلقائيًا. أرقام تعريف العناصر ويمكن استردادها من خلال طلب قراءة لواجهة برمجة التطبيقات.

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

إضافة مربع نص إلى شريحة

ما يلي: presentations.batchUpdate نموذج التعليمات البرمجية كيفية استخدام CreateShapeRequest لإضافة مربع نص جديد (يحتوي على السلسلة "مربع النص المضاف الخاص بي") إلى الشريحة المحددة في PAGE_ID. تم تحديد طلبين في نص الطلب — واحد لإنشاء شكل مربع النص (بحجم معين الموقع) وثانية لإدراج نص فيها.

يحدد الطلب الأول العنصر رقم التعريف المطلوب استخدامه مربع النص. ويتيح ذلك للطلب الثاني استخدامه في طلب البيانات من واجهة برمجة التطبيقات نفسه، ما يقلل من الأعلى.

فيما يلي بروتوكول الطلب لإضافة مربع نص إلى الشريحة:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate

{
  "requests": [
    {
      "createShape": {
        "objectId": PAGE_ELEMENT_ID,
        "shapeType": "TEXT_BOX",
        "elementProperties": {
          "pageObjectId":  PAGE_ID,
          "size": {
            "width": {
              "magnitude": 150,
              "unit": "PT"
            },
            "height": {
              "magnitude": 50,
              "unit": "PT"
            }
          },
          "transform": {
            "scaleX": 1,
            "scaleY": 1,
            "translateX": 200,
            "translateY": 100,
            "unit": "PT"
          }
        }
      }
    },
    {
      "insertText": {
        "objectId": PAGE_ELEMENT_ID,
        "text": "My Added Text Box",
        "insertionIndex": 0
      }
    }
  ]
}

إضافة صورة إلى شريحة

ما يلي: presentations.batchUpdate نموذج التعليمات البرمجية كيفية استخدام CreateImageRequest لإضافة صورة إلى الشريحة المحددة بواسطة PAGE_ID. تشير رسالة الأشكال البيانية تسترد واجهة برمجة التطبيقات الصورة باستخدام IMAGE_URL. هذا الطلب أيضًا تغيير حجم الصورة وتحديد موضعها في الشريحة.

فيما يلي بروتوكول الطلب لإضافة صورة إلى شريحة:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate

{
  "requests": [
    {
      "createImage": {
        "url": IMAGE_URL,
        "elementProperties": {
          "pageObjectId":  PAGE_ID,
          "size": {
            "width": {
              "magnitude": 30,
              "unit": "PT"
            },
            "height": {
              "magnitude": 30,
              "unit": "PT"
            }
          },
          "transform": {
            "scaleX": 1,
            "scaleY": 1,
            "translateX": 200,
            "translateY": 100,
            "unit": "PT"
          }
        }
      }
    }
  ]
}

حذف عنصر صفحة أو صفحة

ما يلي: presentations.batchUpdate نموذج التعليمات البرمجية كيفية استخدام DeleteObjectRequest طريقة لحذف عنصر الصفحة المحدد بواسطة PAGE_ELEMENT_ID والشريحة المحددة بواسطة PAGE_ID باستخدام طلبين منفصلين.

في ما يلي بروتوكول الطلب لحذف عنصر صفحة أو صفحة:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate

{
  "requests": [
    {
      "deleteObject": {
        "objectId": PAGE_ELEMENT_ID
      },
      "deleteObject": {
        "objectId":  PAGE_ID
      }
    }
  ]
}

تعديل نص في شكل محدّد

ما يلي: presentations.batchUpdate نموذج التعليمات البرمجية كيفية استخدام DeleteTextRequest لاستبدال جزء من النص الموجود في الشكل المحدد بواسطة PAGE_ELEMENT_ID لتحقيق ذلك، احذف أولاً النص باستخدام startIndex المستندة إلى الصفر، ثم أدرِج نصًا جديدًا في هذا الموضع. في هذه الدورة، على سبيل المثال، السلسلة النصية الأصلية "My Shape Text: ????" يتم استبداله بـ " نص الشكل: شبه منحرف".

لا يؤثر هذا الطلب إلا في نص بشكل محدد. لاستبدال النص في كل مكان داخل عرض تقديمي، استخدم ReplaceAllTextRequest .

فيما يلي بروتوكول الطلب لتعديل نص في شكل محدد:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate

{
  "requests": [
    {
      "deleteText": {
        "objectId": PAGE_ELEMENT_ID,
        "textRange": {
          "type": "FROM_START_INDEX",
          "startIndex": 15
        }
      }
    },
    {
      "insertText": {
        "objectId": PAGE_ELEMENT_ID,
        "text": "Trapezoid",
        "insertionIndex": 15
      }
    }
  ]
}

استبدال علامة شكل بصورة

العلامات عبارة عن مربعات نصية أو أشكال بها اسم سلسلة فريد، مثل "اسم صاحب الحساب".

ما يلي: presentations.batchUpdate نموذج التعليمات البرمجية كيفية استخدام CreateImageRequest لاستبدال مثيل واحد من علامة شكل بصورة، مع الاحتفاظ الموضع نفسه وتغيير حجمه ليلائم حجم العلامة مع الحفاظ على حجم الصورة نسبة العرض إلى الارتفاع:

يمكن أيضًا استخدام الطلب لاستبدال صورة بأخرى. الطلب إضافة صورة جديدة ثم حذف العلامة.

تستبدل الطريقة CreateImageRequest شكلاً محددًا فقط. لاستبدال العلامة الأشكال في كل مكان داخل عرض تقديمي، واستخدم ReplaceAllShapesWithImageRequest .

تتضمن علامة الشكل ما يلي: PageElement المواقع (والتي يمكن العثور عليها باستخدام presentations.pages.get ):

{
  "objectId": PAGE_ELEMENT_ID,
  "size": {
    "width": {
      "magnitude": 3000000,
      "unit": "EMU"
    },
    "height": {
      "magnitude": 3000000,
      "unit": "EMU"
    }
  },
  "transform": {
    "scaleX": 1.13,
    "scaleY": 0.62,
    "translateX": 4800000,
    "translateY":  450000,
    "unit": "EMU"
  },
  "shape": {
    "shapeType": "RECTANGLE"
  }
}

يتوفّر الشكل على الشريحة التي حدَّدتها PAGE_ID. لتحديد الصورة التي تحل محل الشكل، تسترد واجهة برمجة التطبيقات الصورة باستخدام IMAGE_URL الحفاظ على نسبة العرض إلى الارتفاع للصورة مع الحدّ منها بحجم العلامة CreateImageRequest يحدد حجم الصورة على ناتج حجم العلامة ومقياسها، عوامل مقياس الصورة إلى 1. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة الاحتفاظ بالبيانات. .

فيما يلي بروتوكول الطلب لاستبدال علامة شكل بصورة:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate

{
  "requests": [
    {
      "createImage": {
        "url": IMAGE_URL,
        "elementProperties": {
          "pageObjectId":  PAGE_ID,
          "size": {
            "width": {
              "magnitude": 3000000 * 1.13,
              "unit": "EMU"
            },
            "height": {
              "magnitude": 3000000 * 0.62,
              "unit": "EMU"
            }
          },
          "transform": {
            "scaleX": 1,
            "scaleY": 1,
            "translateX": 4800000,
            "translateY": 450000,
            "unit": "PT"
          }
        }
      }
    },
    {
      "deleteObject": {
        "objectId": PAGE_ELEMENT_ID
      }
    }
  ]
}