عمليات العناصر

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

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

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

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

• تعديل النص وتصميمه
• إضافة أشكال ونص
• إضافة رسم بياني

إضافة قائمة نقطية إلى مربّع نص

ما يلي: presentations.batchUpdate نموذج التعليمات البرمجية كيفية استخدام InsertTextRequest لإدراج نص في مربع نص فارغ محدد بواسطة PAGE_ELEMENT_ID بعد ذلك تستخدم العينة CreateParagraphBulletsRequest لتحويل كل نص مربع النص إلى قائمة نقطية. عناصر القائمة تفصل بينها \n حرف، بينما يتم التحكم في المسافة البادئة باستخدام \t الأحرف.

فيما يلي بروتوكول الطلب لإنشاء عرض تقديمي:

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

{
  "requests": [
    {
      "insertText": {
        "objectId": PAGE_ELEMENT_ID,
        "text": "My List\n\tItem 1\n\t\tItem 2\n\t\t\tItem 3",
        "insertionIndex": 0
      },
      "createParagraphBullets": {
        "objectId": PAGE_ELEMENT_ID,
        "bulletPreset": "BULLET_ARROW_DIAMOND_DISC",
        "textRange": {
          "type": "ALL"
        }
      }
    }
  ]
}

يمكن أن يؤدي هذا الطلب إلى إنشاء قائمة نقطية تبدو كما يلي:

إضافة شكل إلى شريحة

ما يلي: presentations.batchUpdate نموذج التعليمات البرمجية كيفية استخدام CreateShapeRequest لإضافة شكل موجي إلى الشريحة المحددة بواسطة PAGE_ID. يحدد هذا الطلب نوع الشكل، ثم يغير حجم الشكل ويضعه في الشريحة. ومن ثم تستخدم InsertTextRequest لإضافة نص إلى هذا الشكل. يضبط الطلب معرّف السطر على PAGE_ELEMENT_ID

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

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

{
  "requests": [
    {
      "createShape": {
        "objectId": PAGE_ELEMENT_ID,
        "elementProperties": {
          "pageObjectId": PAGE_ID,
          "size": {
            "width": {
              "magnitude": 3000000,
              "unit": "EMU"
            },
            "height": {
              "magnitude": 3000000,
              "unit": "EMU"
            }
          },
          "transform": {
            "scaleX": 0.6807,
            "scaleY": 0.4585,
            "translateX": 6583050,
            "translateY": 1673950,
            "unit": "EMU"
          }
        },
        "shapeType": "WAVE"
      }
    },
    {
      "insertText": {
        "objectId": PAGE_ELEMENT_ID,
        "text": "My Wave Shape",
        "insertionIndex": 0
      }
    }
  ]
}

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

ما يلي: presentations.batchUpdate نموذج التعليمات البرمجية كيفية استخدام CreateVideoRequest لتضمين فيديو في شريحة محددة بواسطة PAGE_ID. يقوم هذا الطلب بتوسيع نطاق الفيديو وتحديد موضعه في الشريحة، وتعيين موضع الفيديو المعرّف إلى PAGE_ELEMENT_ID المعرّف الفريد للفيديو المصدر هو تم الضبط على VIDEO_ID على سبيل المثال، قد يُظهر فيديو YouTube على https://www.youtube.com/watch?v=7U3axjORYZ0 برقم التعريف 7U3axjORYZ0.

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

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

{
  "requests": [
    {
      "createVideo": {
        "objectId": PAGE_ELEMENT_ID,
        "elementProperties": {
          "pageObjectId": PAGE_ID,
          "size": {
            "width": {
              "magnitude": 12000,
              "unit": "EMU"
            },
            "height": {
              "magnitude": 9000,
              "unit": "EMU"
            }
          },
          "transform": {
            "scaleX": 381,
            "scaleY": 381,
            "translateX": 152400,
            "translateY": 152400,
            "unit": "EMU"
          }
        },
        "source": "YOUTUBE",
        "id": VIDEO_ID
      }
    }
  ]
}

نسخ عنصر وتعديله

ما يلي: presentations.batchUpdate نموذج التعليمات البرمجية كيفية استخدام DuplicateObjectRequest لأخذ شكل موجود (محدد بواسطة PAGE_ELEMENT_ID) وإنشاء نسخة (محددة من قبل COPY_ELEMENT_ID).

تؤدي الطلبات اللاحقة إلى إجراء التغييرات التالية على العنصر المكرر:

• لضبط لون الخلفية على لون المظهر LIGHT2
• نقل النسخة إلى أسفل الصفحة (من موضع الشكل الأصلي)
• لضبط خط النص على 18-pt جورجيا.
• يتم تعديل النص ليصبح "نسخة الشكل الخاص بي".

تستخدم الطلبات هنا أقنعة الحقول للاحتفاظ خصائص الشكل التي لم يتم تغييرها (مثل نمط المخطط). استخدام أقنعة الحقل أيضًا على تحسين الأداء.

لمزيد من المعلومات حول نسخ شريحة، راجع النموذج نسخ الشريحة.

فيما يلي بروتوكول الطلب لنسخ عنصر وتعديله:

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

{
  "requests": [
    {
      "duplicateObject": {
        "objectId": PAGE_ELEMENT_ID,
        "objectIds": {
          PAGE_ELEMENT_ID: COPY_ELEMENT_ID
        }
      }
    },
    {
      "updateShapeProperties": {
        "objectId": COPY_ELEMENT_ID,
        "fields": "shapeBackgroundFill.solidFill.color",
        "shapeProperties": {
          "shapeBackgroundFill": {
            "solidFill": {
              "color": {
                "themeColor": "LIGHT2"
              }
            }
          }
        }
      }
    },
    {
      "updatePageElementTransform": {
        "objectId": COPY_ELEMENT_ID,
        "applyMode": "RELATIVE",
        "transform": {
          "scaleX": 1,
          "scaleY": 1,
          "translateX": 0,
          "translateY": 1250000,
          "unit": "EMU"
        }
      }
    },
    {
      "updateTextStyle": {
        "objectId": COPY_ELEMENT_ID,
        "fields": "fontFamily,fontSize",
        "textRange": {
          "type": "ALL"
        },
        "style": {
          "fontFamily": "Georgia",
          "fontSize": {
            "magnitude": 18,
            "unit": "PT"
          }
        }
      }
    },
    {
      "deleteText": {
        "objectId": COPY_ELEMENT_ID,
        "textRange": {
          "type": "ALL"
        }
      }
    },
    {
      "insertText": {
        "objectId": COPY_ELEMENT_ID,
        "text": "My Shape Copy",
        "insertionIndex": 0
      }
    }
  ]
}

إليك الشكل الذي قد يبدو عليه الشكل ونسخته بعد هذه التعديلات:

تعديل مخطط صورة أو فيديو

ما يلي: presentations.batchUpdate نموذج التعليمات البرمجية كيفية استخدام UpdateImagePropertiesRequest لتحديث مظهر مخطط الصورة المحددة بواسطة IMAGE_ELEMENT_ID كما تستخدم دالة UpdateVideoPropertiesRequest لتحديث مظهر المخطط لفيديو مضمّن محدد بواسطة VIDEO_ELEMENT_ID

تُجري الطلبات التغييرات التالية على الكائن:

• يضبط لون مخطط الصورة على لون مظهر ACCENT5 مع عرض جزئي والشفافية.
• لضبط لون مخطط الفيديو على لون مظهر ACCENT1 بدون والشفافية.
• لضبط ترجيحات المخطط على 3 نقاط لكل منهما.
• لضبط نمط مخطط الصورة على SOLID.
• لضبط نمط مخطط الفيديو على DASH_DOT.

يمكن استخدام طريقة UpdateImagePropertiesRequest يمكن لطريقة UpdateVideoPropertiesRequest تغيير مظهر الصورة فقط ومخططات الفيديو. وجميع المواقع الأخرى للقراءة فقط. تستخدم الطلبات هنا أقنعة الحقل لتحديد أن المخطط يجب تغييره لحماية الرمز من التغييرات المستقبلية في واجهة برمجة التطبيقات. استخدام الحقل كما تعمل الأقنعة أيضًا على تحسين الأداء.

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

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

{
  "requests": [
    {
      "updateImageProperties": {
        "objectId": IMAGE_ELEMENT_ID,
        "fields": "outline",
        "imageProperties": {
          "outline": {
            "dashStyle": "SOLID",
            "outlineFill": {
              "solidFill": {
                "alpha": 0.8,
                "color": {
                  "themeColor": "ACCENT5"
                }
              }
            },
            "weight": {
              "magnitude": 3,
              "unit": "PT"
            }
          }
        }
      }
    },
    {
      "updateVideoProperties": {
        "objectId": VIDEO_ELEMENT_ID,
        "fields": "outline",
        "videoProperties": {
          "outline": {
            "dashStyle": "DASH_DOT",
            "outlineFill": {
              "solidFill": {
                "alpha": 0.8,
                "color": {
                  "themeColor": "ACCENT1"
                }
              }
            },
            "weight": {
              "magnitude": 3,
              "unit": "PT"
            }
          }
        }
      }
    }
  ]
}

إليك الشكل الذي قد تظهر به صورة وفيديو مضمّن بعد هذه التحديثات:

تعديل مخطط الشكل

ما يلي: presentations.batchUpdate نموذج التعليمات البرمجية كيفية استخدام UpdateShapePropertiesRequest لأخذ شكل موجود (محدد بواسطة PAGE_ELEMENT_ID) وتحديث مظهر مخططه.

تُجري الطلبات التغييرات التالية على الكائن:

• لضبط لون المخطط على لون مظهر ACCENT5 مع عرض جزئي والشفافية.
• لضبط عرض المخطط على 3 نقاط.
• لضبط نمط المخطط على LONG_DASH.

تستخدم الطلبات هنا أقنعة الحقول للاحتفاظ خصائص الشكل التي لم يتم تغييرها (مثل لون تعبئة الشكل). استخدام أقنعة الحقل أيضًا على تحسين الأداء.

فيما يلي بروتوكول الطلب لتحرير مخطط الشكل:

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

{
  "requests": [
    {
      "updateShapeProperties": {
        "objectId": PAGE_ELEMENT_ID,
        "fields": "outline",
        "shapeProperties": {
          "outline": {
            "dashStyle": "LONG_DASH",
            "outlineFill": {
              "solidFill": {
                "alpha": 0.6,
                "color": {
                  "themeColor": "ACCENT5"
                }
              }
            },
            "weight": {
              "magnitude": 3,
              "unit": "PT"
            }
          }
        }
      }
    }
  ]
}

إليك الشكل الذي قد يبدو عليه الشكل بعد هذه التعديلات:

تنسيق النص في شكل أو مربّع نص

ما يلي: presentations.batchUpdate نموذج التعليمات البرمجية كيفية استخدام UpdateTextStyleRequest لأخذ شكل موجود (محدد بواسطة PAGE_ELEMENT_ID) وتحديث مظهر النص.

تُجري الطلبات التغييرات التالية على الكائن:

• لضبط لون النص على لون المظهر ACCENT5
• تعيين الخط إلى الخط الغامق والمائل 18-pt Corsiva.
• تسطير النص

تستخدم الطلبات هنا أقنعة الحقول للاحتفاظ خصائص نمط النص التي لم يتم تغييرها (مثل لون الخلفية، أو الروابط أو الاعتمادات المرجعية). يؤدي استخدام أقنعة الحقل أيضًا إلى تحسين الأداء.

فيما يلي بروتوكول الطلب لتنسيق النص في شكل أو مربع نص:

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

{
  "requests": [
    {
      "updateTextStyle": {
        "objectId": PAGE_ELEMENT_ID,
        "fields": "foregroundColor,bold,italic,fontFamily,fontSize,underline",
        "style": {
          "foregroundColor": {
            "opaqueColor": {
              "themeColor": "ACCENT5"
            }
          },
          "bold": true,
          "italic": true,
          "underline": true,
          "fontFamily": "Corsiva",
          "fontSize": {
            "magnitude": 18,
            "unit": "PT"
          }
        },
        "textRange": {
          "type": "ALL"
        }
      }
    }
  ]
}

في ما يلي الشكل الذي قد يبدو عليه نص الشكل بعد هذه التعديلات:

استيراد رسم بياني من "جداول بيانات Google"

ما يلي: presentations.batchUpdate نموذج التعليمات البرمجية كيفية استخدام CreateSheetsChartRequest استيراد مخطط من ورقة ووضعه على شريحة محددة PAGE_ID

يحتاج الطلب إلى رقم تعريف جدول البيانات (الذي يتم تحديده بواسطة SPREADSHEET_ID) ورقم تعريف الرسم البياني لجدول البيانات (المحدّد من خلال SPREADSHEET_CHART_ID). رقم تعريف الرسم البياني داخل يتم تحديد العرض التقديمي في "العروض التقديمية من Google" من خلال PRESENTATION_CHART_ID

يحدد الطلب أيضًا LinkingMode من مخطط الشرائح إلى LINKED بحيث يمكنك تحديث مخططًا مضمنًا إذا تم تحديث المخطط في جدول البيانات المصدر.

فيما يلي بروتوكول الطلب لاستيراد مخطط من "جداول بيانات Google":

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

{
  "requests": [
    {
      "createSheetsChart": {
        "objectId": PRESENTATION_CHART_ID,
        "spreadsheetId": SPREADSHEET_ID,
        "chartId": SPREADSHEET_CHART_ID,
        "linkingMode": "LINKED",
        "elementProperties": {
          "pageObjectId": PAGE_ID,
          "size": {
            "width": {
              "magnitude": 4000000,
              "unit": "EMU"
            },
            "height": {
              "magnitude": 4000000,
              "unit": "EMU"
            }
          },
          "transform": {
            "scaleX": 1,
            "scaleY": 1,
            "translateX": 100000,
            "translateY": 100000,
            "unit": "EMU"
          }
      }
    }
  ]
}

إعادة تحميل رسم بياني من "جداول بيانات Google"

ما يلي: presentations.batchUpdate نموذج التعليمات البرمجية كيفية استخدام RefreshSheetsChartRequest لتحديث مخطط مرتبط في عرض تقديمي، واستبداله بأحدث من هذا المخطط من جدول بيانات مصدر جداول البيانات. تشير رسالة الأشكال البيانية معرّف الرسم البياني في عرض الشرائح (محددة من قِبل PRESENTATION_CHART_ID).

فيما يلي بروتوكول الطلب لتحديث مخطط من "جداول بيانات Google":

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

{
  "requests": [
    {
      "refreshSheetsChart": {
        "objectId": PRESENTATION_CHART_ID
      }
    }
  ]
}