Class Master

الرئيسي

مخطط رئيسي في عرض تقديمي

تحتوي الصفحات الرئيسية على جميع عناصر الصفحة الشائعة والخصائص الشائعة لمجموعة من التنسيقات. وتحقّق هذه الميزات ثلاثة أهداف:

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

الطُرق

الطريقةنوع القيمة التي تم إرجاعهاوصف قصير
getBackground()PageBackgroundتعرض هذه السمة خلفية الصفحة.
getColorScheme()ColorSchemeتعرض هذه السمة ColorScheme المرتبط بالصفحة.
getGroups()Group[]تعرض هذه الطريقة قائمة بعناصر Group في الصفحة.
getImages()Image[]تعرض هذه الطريقة قائمة بعناصر Image في الصفحة.
getLayouts()Layout[]تعرض هذه الطريقة تخطيطات الشريحة الرئيسية.
getLines()Line[]تعرض هذه الطريقة قائمة بعناصر Line في الصفحة.
getObjectId()Stringتعرض هذه السمة المعرّف الفريد للصفحة.
getPageElementById(id)PageElement|nullتعرض هذه الدالة PageElement في الصفحة التي تحمل المعرّف المحدّد، أو null إذا لم يكن هناك أي معرّف.
getPageElements()PageElement[]تعرض هذه السمة قائمة بعناصر PageElement المعروضة على الصفحة.
getPageType()PageTypeتعرض هذه السمة نوع الصفحة.
getPlaceholder(placeholderType)PageElement|nullتعرض هذه السمة العنصر النائب PageElement لعنصر PlaceholderType أو null محدّد، أو تعرض null إذا لم يتوفّر عنصر نائب مطابق.
getPlaceholder(placeholderType, placeholderIndex)PageElement|nullتعرض هذه الدالة العنصر النائب PageElement الخاص بـ PlaceholderType وفهرس العنصر النائب المحدّدَين، أو null إذا لم يكن العنصر النائب متوفّرًا.
getPlaceholders()PageElement[]تعرض هذه الطريقة قائمة بكائنات العنصر النائب PageElement في الصفحة.
getShapes()Shape[]تعرض هذه الطريقة قائمة بعناصر Shape في الصفحة.
getSheetsCharts()SheetsChart[]تعرض هذه الطريقة قائمة بعناصر SheetsChart في الصفحة.
getTables()Table[]تعرض هذه الطريقة قائمة بعناصر Table في الصفحة.
getVideos()Video[]تعرض هذه الطريقة قائمة بعناصر Video في الصفحة.
getWordArts()WordArt[]تعرض هذه الطريقة قائمة بعناصر WordArt في الصفحة.
group(pageElements)Groupتجميع كل عناصر الصفحة المحدّدة
insertGroup(group)Groupتُدرج نسخة من Group المقدَّم في الصفحة.
insertImage(blobSource)Imageتُدرِج هذه الدالة صورة في أعلى يمين الصفحة بحجم تلقائي من كائن الصورة الثنائي الكبير المحدّد.
insertImage(blobSource, left, top, width, height)Imageتُدرِج هذه الطريقة صورة في الصفحة بالموضع والحجم المحدّدين من كائن الصورة الثنائية الكبير (BLOB) المحدّد.
insertImage(image)Imageتُدرج نسخة من Image المقدَّم في الصفحة.
insertImage(imageUrl)Imageتُدرِج هذه السمة صورة في أعلى يمين الصفحة بحجم تلقائي من عنوان URL المقدَّم.
insertImage(imageUrl, left, top, width, height)Imageتُدرِج هذه السمة صورة في الصفحة بالموضع والحجم المحدّدَين من عنوان URL المقدَّم.
insertLine(line)Lineتُدرج نسخة من Line المقدَّم في الصفحة.
insertLine(lineCategory, startConnectionSite, endConnectionSite)Lineيُدرج خطًا في الصفحة يربط بين عنصرَي connection sites.
insertLine(lineCategory, startLeft, startTop, endLeft, endTop)Lineيُدرج سطرًا في الصفحة.
insertPageElement(pageElement)PageElementتُدرج نسخة من PageElement المقدَّم في الصفحة.
insertShape(shape)Shapeتُدرج نسخة من Shape المقدَّم في الصفحة.
insertShape(shapeType)Shapeتُستخدَم لإدراج شكل في الصفحة.
insertShape(shapeType, left, top, width, height)Shapeتُستخدَم لإدراج شكل في الصفحة.
insertSheetsChart(sourceChart)SheetsChartتُدرج هذه السمة رسمًا بيانيًا من "جداول بيانات Google" في الصفحة.
insertSheetsChart(sourceChart, left, top, width, height)SheetsChartتُدرِج هذه الدالة رسمًا بيانيًا من "جداول بيانات Google" في الصفحة بالموضع والحجم المحدّدَين.
insertSheetsChart(sheetsChart)SheetsChartتُدرج نسخة من SheetsChart المقدَّم في الصفحة.
insertSheetsChartAsImage(sourceChart)Imageتُدرج هذه السمة رسمًا بيانيًا من "جداول بيانات Google" كـ Image في الصفحة.
insertSheetsChartAsImage(sourceChart, left, top, width, height)Imageتُدرج هذه الدالة رسمًا بيانيًا من "جداول بيانات Google" كـ Image في الصفحة بالموضع والحجم المحدّدَين.
insertTable(numRows, numColumns)Tableتُدرج هذه السمة جدولاً في الصفحة.
insertTable(numRows, numColumns, left, top, width, height)Tableتُدرِج هذه الدالة جدولاً في الصفحة بالموضع والحجم المحدّدَين.
insertTable(table)Tableتُدرج نسخة من Table المقدَّم في الصفحة.
insertTextBox(text)Shapeيُدرِج مربّع نص Shape يحتوي على السلسلة المقدَّمة في الصفحة.
insertTextBox(text, left, top, width, height)Shapeيُدرِج مربّع نص Shape يحتوي على السلسلة المقدَّمة في الصفحة.
insertVideo(videoUrl)Videoتُدرج هذه السمة فيديو في أعلى يمين الصفحة بحجم تلقائي.
insertVideo(videoUrl, left, top, width, height)Videoتُدرج هذه السمة فيديو في الصفحة بالموضع والحجم المحدّدَين.
insertVideo(video)Videoتُدرج نسخة من Video المقدَّم في الصفحة.
insertWordArt(wordArt)WordArtتُدرج نسخة من WordArt المقدَّم في الصفحة.
remove()voidتتم إزالة الصفحة.
replaceAllText(findText, replaceText)Integerيستبدل جميع مثيلات النص المطابق للنص المطلوب البحث عنه بالنص البديل.
replaceAllText(findText, replaceText, matchCase)Integerيستبدل جميع مثيلات النص المطابق للنص المطلوب البحث عنه بالنص البديل.
selectAsCurrentPage()voidيختار Page في العرض التقديمي النشط كـ current page selection ويزيل أي اختيار سابق.

مستندات تفصيلية

getBackground()

تعرض هذه السمة خلفية الصفحة.

الإرجاع

استبدِل PageBackground بخلفية الصفحة.

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getColorScheme()

تعرض هذه السمة ColorScheme المرتبط بالصفحة.

الإرجاع

استبدِل ColorScheme بنظام الألوان في الصفحة.

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getGroups()

تعرض هذه الطريقة قائمة بعناصر Group في الصفحة.

الإرجاع

Group[]

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getImages()

تعرض هذه الطريقة قائمة بعناصر Image في الصفحة.

الإرجاع

Image[]

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getLayouts()

تعرض هذه الطريقة تخطيطات الشريحة الرئيسية.

الإرجاع

Layout[]

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getLines()

تعرض هذه الطريقة قائمة بعناصر Line في الصفحة.

الإرجاع

Line[]

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getObjectId()

تعرض هذه السمة المعرّف الفريد للصفحة. تتشارك أرقام تعريف العناصر المستخدَمة في الصفحات وعناصر الصفحات مساحة الاسم نفسها.

الإرجاع

String

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getPageElementById(id)

تعرض هذه الدالة PageElement في الصفحة التي تحمل المعرّف المحدّد، أو null إذا لم يكن هناك أي معرّف.

المَعلمات

الاسمالنوعالوصف
idStringمعرّف عنصر الصفحة الذي يتم استرجاعه.

الإرجاع

PageElement|null: عنصر الصفحة الذي يتضمّن المعرّف المحدّد

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getPageElements()

تعرض هذه السمة قائمة بعناصر PageElement المعروضة على الصفحة.

الإرجاع

PageElement[]

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getPageType()

تعرض هذه السمة نوع الصفحة.

الإرجاع

PageType: نوع الصفحة

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getPlaceholder(placeholderType)

تعرض هذه السمة العنصر النائب PageElement لعنصر PlaceholderType أو null محدّد، أو تعرض null إذا لم يتوفّر عنصر نائب مطابق.

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

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const placeholder = slide.getPlaceholder(
    SlidesApp.PlaceholderType.CENTERED_TITLE,
);

المَعلمات

الاسمالنوعالوصف
placeholderTypePlaceholderTypeنوع العنصر النائب المطلوب مطابقته.

الإرجاع

‫PageElement|null: عنصر الصفحة النائب، أو null إذا لم يتم العثور على أي عنصر.

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getPlaceholder(placeholderType, placeholderIndex)

تعرض هذه الدالة العنصر النائب PageElement الخاص بـ PlaceholderType وفهرس العنصر النائب المحدّدَين، أو null إذا لم يكن العنصر النائب متوفّرًا.

إذا كانت هناك عناصر نائبة متعددة من النوع والفهرس نفسهما، سيتم عرض العنصر النائب الأول من مجموعة عناصر الصفحة. 

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const placeholder = slide.getPlaceholder(
    SlidesApp.PlaceholderType.CENTERED_TITLE,
    0,
);

المَعلمات

الاسمالنوعالوصف
placeholderTypePlaceholderTypeنوع العنصر النائب المطلوب مطابقته.
placeholderIndexIntegerفهرس العنصر النائب المطلوب مطابقته.

الإرجاع

‫PageElement|null: عنصر الصفحة النائب، أو null إذا لم يتم العثور على أي عنصر.

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getPlaceholders()

تعرض هذه الطريقة قائمة بكائنات العنصر النائب PageElement في الصفحة. 

const master = SlidesApp.getActivePresentation().getMasters()[0];
Logger.log(
    `Number of placeholders in the master: ${master.getPlaceholders().length}`,
);

الإرجاع

PageElement[]

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getShapes()

تعرض هذه الطريقة قائمة بعناصر Shape في الصفحة.

الإرجاع

Shape[]

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getSheetsCharts()

تعرض هذه الطريقة قائمة بعناصر SheetsChart في الصفحة.

الإرجاع

SheetsChart[]

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getTables()

تعرض هذه الطريقة قائمة بعناصر Table في الصفحة.

الإرجاع

Table[]

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getVideos()

تعرض هذه الطريقة قائمة بعناصر Video في الصفحة.

الإرجاع

Video[]

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getWordArts()

تعرض هذه الطريقة قائمة بعناصر WordArt في الصفحة.

الإرجاع

WordArt[]

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

group(pageElements)

تجميع كل عناصر الصفحة المحدّدة

يجب أن يتوفّر عنصران على الأقل في الصفحة نفسها غير مضمّنين في مجموعة أخرى. لا يمكن تجميع بعض عناصر الصفحة، مثل Videos وTables وplaceholder Shapes.

المَعلمات

الاسمالنوعالوصف
pageElementsPageElement[]العناصر المطلوب تجميعها معًا

الإرجاع

استبدِل Group بالمجموعة الجديدة.

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertGroup(group)

تُدرج نسخة من Group المقدَّم في الصفحة.

يتم تحديد موضع العنصر المُدرَج في هذه الصفحة من موضع العنصر المصدر في صفحته المعنية.

إذا كان العنصر المقدَّم هو عنصر نائب يتم نسخه من داخل العرض التقديمي الحالي، سيتم أيضًا اكتساب الخصائص التي يتم اكتسابها من الصفحات الرئيسية أو صفحات التنسيق في العنصر المُدرَج.

إذا كان العنصر المقدَّم هو عنصر نائب يتم نسخه من عرض تقديمي مختلف، سيتم نسخ الخصائص التي يتم توريثها من الصفحات الرئيسية أو صفحات التنسيق إلى العنصر من العرض التقديمي المصدر. 

// Copy a group between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const group = otherPresentationSlide.getGroups()[0];
currentPresentationSlide.insertGroup(
    group);  // Also available for Layout, Master, and Page.

المَعلمات

الاسمالنوعالوصف
groupGroupالمجموعة التي سيتم نسخها وإدراجها

الإرجاع

‫Group: المجموعة التي تم إدراجها

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertImage(blobSource)

تُدرِج هذه الدالة صورة في أعلى يمين الصفحة بحجم تلقائي من كائن الصورة الثنائي الكبير المحدّد.

عند إدراج الصورة، يتم جلبها من BlobSource مرة واحدة ويتم تخزين نسخة منها لعرضها داخل العرض التقديمي. يجب أن يكون حجم الصور أقل من 50 ميغابايت، وألا تتجاوز 25 ميغابكسل، وأن تكون بتنسيق PNG أو JPEG أو GIF. 

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// Get the Drive image file with the given ID.
const image = DriveApp.getFileById('123abc');
slide.insertImage(image);

المَعلمات

الاسمالنوعالوصف
blobSourceBlobSourceبيانات الصورة

الإرجاع

Image: الصورة المُدرَجة

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertImage(blobSource, left, top, width, height)

تُدرِج هذه الطريقة صورة في الصفحة بالموضع والحجم المحدّدين من كائن الصورة الثنائية الكبير (BLOB) المحدّد.

يتم استرداد الصورة من BlobSource المقدَّم مرة واحدة عند وقت الإدراج، ويتم تخزين نسخة منها لعرضها داخل العرض التقديمي. يجب أن يكون حجم الصور أقل من 50 ميغابايت، وألا تتجاوز 25 ميغابكسل، وأن تكون بتنسيق PNG أو JPEG أو GIF.

للحفاظ على نسبة العرض إلى الارتفاع في الصورة، يتم تغيير حجمها وتوسيطها بالنسبة إلى الحجم المقدَّم. 

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// Get the Drive image file with the given ID.
const image = DriveApp.getFileById('123abc');
const position = {
  left: 0,
  top: 0
};
const size = {
  width: 300,
  height: 100
};
slide.insertImage(image, position.left, position.top, size.width, size.height);

المَعلمات

الاسمالنوعالوصف
blobSourceBlobSourceبيانات الصورة
leftNumberالموضع الأفقي للصورة بالنقاط، ويتم قياسه من الزاوية العلوية اليمنى للصفحة.
topNumberالوضع الرأسي للصورة بالنقاط، ويتم قياسه من الزاوية العلوية اليمنى للصفحة.
widthNumberتمثّل هذه السمة عرض الصورة بالنقاط.
heightNumberتمثّل هذه السمة ارتفاع الصورة بالنقاط.

الإرجاع

Image: الصورة المُدرَجة

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertImage(image)

تُدرج نسخة من Image المقدَّم في الصفحة.

يتم تحديد موضع الصور المُدرَجة في هذه الصفحة من موضع الصورة المصدر في صفحتها المعنية.

إذا كانت الصورة المقدَّمة عبارة عن عنصر نائب يتم نسخه من داخل العرض التقديمي الحالي، سيتم أيضًا نقل الخصائص التي يتم استيرادها من الصفحات الرئيسية أو صفحات التنسيق إلى الصورة المُدرَجة.

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

// Copy an image between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const image = otherPresentationSlide.getImages[0];
currentPresentationSlide.insertImage(image);

المَعلمات

الاسمالنوعالوصف
imageImageالصورة التي سيتم نسخها وإدراجها

الإرجاع

Image: الصورة المُدرَجة

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertImage(imageUrl)

تُدرِج هذه السمة صورة في أعلى يمين الصفحة بحجم تلقائي من عنوان URL المقدَّم.

عند إدراج الصورة، يتم جلبها من عنوان URL مرة واحدة ويتم تخزين نسخة منها لعرضها داخل العرض التقديمي. يجب أن يكون حجم الصور أقل من 50 ميغابايت، وألا تتجاوز 25 ميغابكسل، وأن تكون بتنسيق PNG أو JPEG أو GIF.

يجب أن يكون عنوان URL المقدَّم متاحًا للجميع وبحجم لا يزيد عن 2 كيلوبايت. يتم حفظ عنوان URL نفسه مع الصورة وعرضه من خلال Image.getSourceUrl().

المَعلمات

الاسمالنوعالوصف
imageUrlStringعنوان URL الخاص بالصورة

الإرجاع

Image: الصورة المُدرَجة

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertImage(imageUrl, left, top, width, height)

تُدرِج هذه السمة صورة في الصفحة بالموضع والحجم المحدّدَين من عنوان URL المقدَّم.

عند إدراج الصورة، يتم جلبها من عنوان URL مرة واحدة ويتم تخزين نسخة منها لعرضها داخل العرض التقديمي. يجب أن يكون حجم الصور أقل من 50 ميغابايت، وألا تتجاوز 25 ميغابكسل، وأن تكون بتنسيق PNG أو JPEG أو GIF.

يجب أن يكون عنوان URL المقدَّم متاحًا للجميع وبحجم لا يزيد عن 2 كيلوبايت. يتم حفظ عنوان URL نفسه مع الصورة وعرضه من خلال Image.getSourceUrl().

للحفاظ على نسبة العرض إلى الارتفاع في الصورة، يتم تغيير حجمها وتوسيطها بالنسبة إلى الحجم المقدَّم.

المَعلمات

الاسمالنوعالوصف
imageUrlStringعنوان URL الخاص بالصورة
leftNumberالموضع الأفقي للصورة بالنقاط، ويتم قياسه من الزاوية العلوية اليمنى للصفحة.
topNumberالوضع الرأسي للصورة بالنقاط، ويتم قياسه من الزاوية العلوية اليمنى للصفحة.
widthNumberتمثّل هذه السمة عرض الصورة بالنقاط.
heightNumberتمثّل هذه السمة ارتفاع الصورة بالنقاط.

الإرجاع

Image: الصورة المُدرَجة

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertLine(line)

تُدرج نسخة من Line المقدَّم في الصفحة.

يتم تحديد موضع العنصر المُدرَج في هذه الصفحة من موضع العنصر المصدر في صفحته المعنية.

إذا كان العنصر المقدَّم هو عنصر نائب يتم نسخه من داخل العرض التقديمي الحالي، سيتم أيضًا اكتساب الخصائص التي يتم اكتسابها من الصفحات الرئيسية أو صفحات التنسيق في العنصر المُدرَج.

إذا كان العنصر المقدَّم هو عنصر نائب يتم نسخه من عرض تقديمي مختلف، سيتم نسخ الخصائص التي يتم توريثها من الصفحات الرئيسية أو صفحات التنسيق إلى العنصر من العرض التقديمي المصدر. 

// Copy a line between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const line = otherPresentationSlide.getLines[0];
currentPresentationSlide.insertLine(line);

المَعلمات

الاسمالنوعالوصف
lineLineالسطر المطلوب نسخه وإدراجه

الإرجاع

‫Line: السطر الذي تم إدراجه

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertLine(lineCategory, startConnectionSite, endConnectionSite)

يُدرج خطًا في الصفحة يربط بين عنصرَي connection sites. يجب أن يظهر الموقعان الإلكترونيان المرتبطان على هذه الصفحة. 

// Insert a line in the first slide of the presentation connecting two shapes.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const shape1 = slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
const shape2 = slide.insertShape(SlidesApp.ShapeType.CLOUD);
slide.insertLine(
    SlidesApp.LineCategory.BENT,
    shape1.getConnectionSites()[0],
    shape2.getConnectionSites()[1],
);

المَعلمات

الاسمالنوعالوصف
lineCategoryLineCategoryفئة السطر المطلوب إدراجه.
startConnectionSiteConnectionSiteموقع الربط الذي سيتم ربط بداية الخط به.
endConnectionSiteConnectionSiteموقع الربط الذي سيتم ربط نهاية الخط به

الإرجاع

‫Line: السطر الذي تم إدراجه

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertLine(lineCategory, startLeft, startTop, endLeft, endTop)

يُدرج سطرًا في الصفحة. 

// Insert a line in the first slide of the presentation.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const startPoint = {
  left: 10,
  top: 10
};
const endPoint = {
  left: 40,
  top: 40
};
slide.insertLine(
    SlidesApp.LineCategory.STRAIGHT,
    startPoint.left,
    startPoint.top,
    endPoint.left,
    endPoint.top,
);

المَعلمات

الاسمالنوعالوصف
lineCategoryLineCategoryفئة السطر المطلوب إدراجه.
startLeftNumberالموضع الأفقي لنقطة بداية الخط، ويتم قياسه بالنقاط من الزاوية العلوية اليسرى للصفحة.
startTopNumberالموضع العمودي لنقطة بداية الخط، ويتم قياسه بالنقاط من الزاوية العلوية اليمنى للصفحة.
endLeftNumberالموضع الأفقي لنقطة نهاية الخط، ويتم قياسه بالنقاط من الزاوية العلوية اليمنى للصفحة.
endTopNumberالموضع العمودي لنقطة نهاية الخط، ويتم قياسه بالنقاط من الزاوية العلوية اليمنى للصفحة.

الإرجاع

‫Line: السطر الذي تم إدراجه

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertPageElement(pageElement)

تُدرج نسخة من PageElement المقدَّم في الصفحة.

يتم تحديد موضع العنصر المُدرَج في هذه الصفحة من موضع العنصر المصدر في صفحته المعنية.

إذا كان العنصر المقدَّم هو عنصر نائب يتم نسخه من داخل العرض التقديمي الحالي، سيتم أيضًا اكتساب الخصائص التي يتم اكتسابها من الصفحات الرئيسية أو صفحات التنسيق في العنصر المُدرَج.

إذا كان العنصر المقدَّم هو عنصر نائب يتم نسخه من عرض تقديمي مختلف، سيتم نسخ الخصائص التي يتم توريثها من الصفحات الرئيسية أو صفحات التنسيق إلى العنصر من العرض التقديمي المصدر. 

// Copy a page element between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const pageElement = otherPresentationSlide.getPageElements()[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertPageElement(pageElement);

المَعلمات

الاسمالنوعالوصف
pageElementPageElementعنصر الصفحة المطلوب نسخه وإدراجه

الإرجاع

‫PageElement: عنصر الصفحة المُدرَج

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertShape(shape)

تُدرج نسخة من Shape المقدَّم في الصفحة.

يتم تحديد موضع العنصر المُدرَج في هذه الصفحة من موضع العنصر المصدر في صفحته المعنية.

إذا كان العنصر المقدَّم هو عنصر نائب يتم نسخه من داخل العرض التقديمي الحالي، سيتم أيضًا اكتساب الخصائص التي يتم اكتسابها من الصفحات الرئيسية أو صفحات التنسيق في العنصر المُدرَج.

إذا كان العنصر المقدَّم هو عنصر نائب يتم نسخه من عرض تقديمي مختلف، سيتم نسخ الخصائص التي يتم توريثها من الصفحات الرئيسية أو صفحات التنسيق إلى العنصر من العرض التقديمي المصدر. 

// Copy a shape between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const shape = otherPresentationSlide.getShapes[0];
currentPresentationSlide.insertShape(
    shape);  // Also available for Layout, Master, and Page.

المَعلمات

الاسمالنوعالوصف
shapeShapeالشكل المطلوب نسخه وإدراجه

الإرجاع

Shape: الشكل المُدرَج

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertShape(shapeType)

تُستخدَم لإدراج شكل في الصفحة.

يتم إدراج الشكل بحجم تلقائي في الزاوية العلوية اليسرى من الصفحة. 

// Insert a shape in the first slide of the presentation.
const slide = SlidesApp.getActivePresentation().getSlides()[0];

// Also available for Layout, Master, and Page.
slide.insertShape(SlidesApp.ShapeType.RECTANGLE);

المَعلمات

الاسمالنوعالوصف
shapeTypeShapeTypeنوع الشكل المطلوب إدراجه

الإرجاع

Shape: الشكل المُدرَج

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertShape(shapeType, left, top, width, height)

تُستخدَم لإدراج شكل في الصفحة.

المَعلمات

الاسمالنوعالوصف
shapeTypeShapeTypeنوع الشكل المطلوب إدراجه
leftNumberالموضع الأفقي للشكل، ويتم قياسه من الزاوية العلوية اليمنى من الصفحة.
topNumberالوضع الرأسي للشكل، ويتم قياسه من الزاوية العلوية اليسرى للصفحة.
widthNumberتمثّل هذه السمة عرض الشكل.
heightNumberتمثّل هذه السمة ارتفاع الشكل.

الإرجاع

Shape: الشكل المُدرَج

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertSheetsChart(sourceChart)

تُدرج هذه السمة رسمًا بيانيًا من "جداول بيانات Google" في الصفحة.

يتم إدراج الرسم البياني بحجم تلقائي في أعلى يمين الصفحة.

يكون الرسم البياني المُدرَج مرتبطًا بالرسم البياني المصدر في "جداول بيانات Google"، ما يتيح تعديله. يمكن للمتعاونين الآخرين رؤية الرابط المؤدي إلى جدول البيانات المصدر. 

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertSheetsChart(chart);

المَعلمات

الاسمالنوعالوصف
sourceChartEmbeddedChartالرسم البياني في جدول البيانات الذي سيتم إدراجه في الصفحة

الإرجاع

SheetsChart: الرسم البياني المُدرَج في الصفحة

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertSheetsChart(sourceChart, left, top, width, height)

تُدرِج هذه الدالة رسمًا بيانيًا من "جداول بيانات Google" في الصفحة بالموضع والحجم المحدّدَين.

للحفاظ على نسبة العرض إلى الارتفاع في الرسم البياني، يتم تغيير حجم الرسم البياني وتوسيطه بالنسبة إلى الحجم المقدَّم.

يكون الرسم البياني المُدرَج مرتبطًا بالرسم البياني المصدر في "جداول بيانات Google"، ما يتيح تعديله. يمكن للمتعاونين الآخرين رؤية الرابط المؤدي إلى جدول البيانات المصدر. 

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const position = {
  left: 0,
  top: 0
};
const size = {
  width: 200,
  height: 200
};

// Also available for Layout, Master, and Page.
slide.insertSheetsChart(
    chart,
    position.left,
    position.top,
    size.width,
    size.height,
);

المَعلمات

الاسمالنوعالوصف
sourceChartEmbeddedChartالرسم البياني في جدول البيانات الذي سيتم إدراجه في الصفحة
leftNumberالموضع الأفقي للرسم البياني بالنقاط، ويتم قياسه من الزاوية العلوية اليمنى للصفحة.
topNumberالموضع العمودي للرسم البياني بالنقاط، ويتم قياسه من الزاوية العلوية اليمنى للصفحة.
widthNumberتمثّل هذه السمة عرض الرسم البياني بالنقاط.
heightNumberتمثّل هذه السمة ارتفاع الرسم البياني بالنقاط.

الإرجاع

SheetsChart: الرسم البياني المُدرَج في الصفحة

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertSheetsChart(sheetsChart)

تُدرج نسخة من SheetsChart المقدَّم في الصفحة.

يتم تحديد موضع العنصر المُدرَج في هذه الصفحة من موضع العنصر المصدر في صفحته المعنية.

إذا كان العنصر المقدَّم هو عنصر نائب يتم نسخه من داخل العرض التقديمي الحالي، سيتم أيضًا اكتساب الخصائص التي يتم اكتسابها من الصفحات الرئيسية أو صفحات التنسيق في العنصر المُدرَج.

إذا كان العنصر المقدَّم هو عنصر نائب يتم نسخه من عرض تقديمي مختلف، سيتم نسخ الخصائص التي يتم توريثها من الصفحات الرئيسية أو صفحات التنسيق إلى العنصر من العرض التقديمي المصدر. 

// Copy a sheets chart between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const sheetsChart = otherPresentationSlide.getSheetsCharts[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertSheetsChart(sheetsChart);

المَعلمات

الاسمالنوعالوصف
sheetsChartSheetsChartتمثّل هذه السمة الرسم البياني المطلوب نسخه وإدراجه في جداول بيانات Google.

الإرجاع

SheetsChart: الرسم البياني الذي تم إدراجه في ورقة البيانات

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertSheetsChartAsImage(sourceChart)

تُدرج هذه السمة رسمًا بيانيًا من "جداول بيانات Google" كـ Image في الصفحة.

يتم إدراج صورة الرسم البياني بحجم تلقائي في أعلى يمين الصفحة.

لا ترتبط صورة الرسم البياني المُدرَجة بالرسم البياني المصدر في "جداول بيانات Google". 

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertSheetsChartAsImage(
    chart);  // Also available for Layout, Master, and Page.

المَعلمات

الاسمالنوعالوصف
sourceChartEmbeddedChartالرسم البياني في جدول البيانات الذي سيتم إدراجه في الصفحة

الإرجاع

Image: الصورة المُدرَجة للرسم البياني في الصفحة

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertSheetsChartAsImage(sourceChart, left, top, width, height)

تُدرج هذه الدالة رسمًا بيانيًا من "جداول بيانات Google" كـ Image في الصفحة بالموضع والحجم المحدّدَين.

للحفاظ على نسبة العرض إلى الارتفاع لصورة الرسم البياني، يتم تغيير حجم الصورة وتوسيطها بالنسبة إلى الحجم المقدَّم.

لا ترتبط صورة الرسم البياني المُدرَجة بالرسم البياني للمصدر في "جداول بيانات Google". 

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const position = {
  left: 0,
  top: 0
};
const size = {
  width: 200,
  height: 200
};

// Also available for Layout, Master, and Page.
slide.insertSheetsChartAsImage(
    chart,
    position.left,
    position.right,
    size.width,
    size.height,
);

المَعلمات

الاسمالنوعالوصف
sourceChartEmbeddedChartالرسم البياني في جدول البيانات الذي سيتم إدراجه في الصفحة
leftNumberالموضع الأفقي للرسم البياني بالنقاط، ويتم قياسه من الزاوية العلوية اليمنى للصفحة.
topNumberالموضع العمودي للرسم البياني بالنقاط، ويتم قياسه من الزاوية العلوية اليمنى للصفحة.
widthNumberتمثّل هذه السمة عرض الرسم البياني بالنقاط.
heightNumberتمثّل هذه السمة ارتفاع الرسم البياني بالنقاط.

الإرجاع

Image: الصورة المُدرَجة للرسم البياني في الصفحة

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertTable(numRows, numColumns)

تُدرج هذه السمة جدولاً في الصفحة.

يتم توسيط الجدول في الصفحة مع الحجم التلقائي وتوزيع الصفوف والأعمدة بالتساوي.

المَعلمات

الاسمالنوعالوصف
numRowsIntegerتمثّل هذه السمة عدد الصفوف في الجدول.
numColumnsIntegerتمثّل هذه السمة عدد الأعمدة في الجدول.

الإرجاع

Table: الجدول الذي تم إدراجه

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertTable(numRows, numColumns, left, top, width, height)

تُدرِج هذه الدالة جدولاً في الصفحة بالموضع والحجم المحدّدَين.

يتم توزيع الصفوف والأعمدة بالتساوي في الجدول الذي تم إنشاؤه.

المَعلمات

الاسمالنوعالوصف
numRowsIntegerتمثّل هذه السمة عدد الصفوف في الجدول.
numColumnsIntegerتمثّل هذه السمة عدد الأعمدة في الجدول.
leftNumberالموضع الأفقي للجدول، ويتم قياسه من الزاوية العلوية اليمنى للصفحة.
topNumberالوضع الرأسي للجدول، ويتم قياسه من الزاوية العلوية اليمنى للصفحة.
widthNumberعرض الجدول
heightNumberتمثّل هذه السمة الحدّ الأدنى لارتفاع الجدول. يعتمد الارتفاع الفعلي للجدول المعروض على عوامل مثل حجم خط النص.

الإرجاع

Table: الجدول الذي تم إدراجه

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertTable(table)

تُدرج نسخة من Table المقدَّم في الصفحة.

يتم تحديد موضع العنصر المُدرَج في هذه الصفحة من موضع العنصر المصدر في صفحته المعنية.

إذا كان العنصر المقدَّم هو عنصر نائب يتم نسخه من داخل العرض التقديمي الحالي، سيتم أيضًا اكتساب الخصائص التي يتم اكتسابها من الصفحات الرئيسية أو صفحات التنسيق في العنصر المُدرَج.

إذا كان العنصر المقدَّم هو عنصر نائب يتم نسخه من عرض تقديمي مختلف، سيتم نسخ الخصائص التي يتم توريثها من الصفحات الرئيسية أو صفحات التنسيق إلى العنصر من العرض التقديمي المصدر. 

// Copy a table between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const table = otherPresentationSlide.getTables[0];
currentPresentationSlide.insertTable(
    table);  // Also available for Layout, Master, and Page.

المَعلمات

الاسمالنوعالوصف
tableTableالجدول المطلوب نسخه وإدراجه

الإرجاع

Table: الجدول الذي تم إدراجه

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertTextBox(text)

يُدرِج مربّع نص Shape يحتوي على السلسلة المقدَّمة في الصفحة.

يتم إدراج شكل مربّع النص بحجم تلقائي في أعلى يمين الصفحة. 

// Insert text box with "Hello" on the first slide of presentation.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertTextBox('Hello');  // Also available for Layout, Master, and Page.

المَعلمات

الاسمالنوعالوصف
textStringالسلسلة التي يجب أن يحتوي عليها شكل مربّع النص

الإرجاع

Shape: شكل مربّع النص المُدرَج

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertTextBox(text, left, top, width, height)

يُدرِج مربّع نص Shape يحتوي على السلسلة المقدَّمة في الصفحة. 

// Insert text box with "Hello" on the first slide of presentation. This text
// box is a square with a length of 10 points on each side.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertTextBox(
    'Hello', 0, 0, 10, 10);  // Also available for Layout, Master, and Page.

المَعلمات

الاسمالنوعالوصف
textStringالسلسلة التي يجب أن يحتوي عليها شكل مربّع النص
leftNumberالموضع الأفقي لشكل مربّع النص، ويتم قياسه من الزاوية العلوية اليمنى للصفحة.
topNumberالموضع العمودي لشكل مربّع النص، ويتم قياسه من الزاوية العلوية اليمنى للصفحة.
widthNumberتمثّل هذه السمة عرض شكل مربّع النص.
heightNumberتمثّل هذه السمة ارتفاع شكل مربّع النص.

الإرجاع

Shape: شكل مربّع النص المُدرَج

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertVideo(videoUrl)

تُدرج هذه السمة فيديو في أعلى يمين الصفحة بحجم تلقائي.

لا يمكن استخدام سوى الفيديوهات العلنية على YouTube.

المَعلمات

الاسمالنوعالوصف
videoUrlStringتمثّل هذه السمة عنوان URL للفيديو الذي سيتم إدراجه.

الإرجاع

Video: الفيديو المُدرَج

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertVideo(videoUrl, left, top, width, height)

تُدرج هذه السمة فيديو في الصفحة بالموضع والحجم المحدّدَين.

لا يمكن استخدام سوى الفيديوهات العلنية على YouTube.

المَعلمات

الاسمالنوعالوصف
videoUrlStringتمثّل هذه السمة عنوان URL للفيديو الذي سيتم إدراجه.
leftNumberالموضع الأفقي للفيديو بالنقاط، ويتم قياسه من الزاوية العلوية اليمنى للصفحة.
topNumberالموضع العمودي للفيديو بالنقاط، ويتم قياسه من الزاوية العلوية اليسرى للصفحة.
widthNumberتمثّل هذه السمة عرض الفيديو بالنقاط.
heightNumberتمثّل هذه السمة ارتفاع الفيديو بالنقاط.

الإرجاع

Video: الفيديو المُدرَج

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertVideo(video)

تُدرج نسخة من Video المقدَّم في الصفحة.

يتم تحديد موضع العنصر المُدرَج في هذه الصفحة من موضع العنصر المصدر في صفحته المعنية.

إذا كان العنصر المقدَّم هو عنصر نائب يتم نسخه من داخل العرض التقديمي الحالي، سيتم أيضًا اكتساب الخصائص التي يتم اكتسابها من الصفحات الرئيسية أو صفحات التنسيق في العنصر المُدرَج.

إذا كان العنصر المقدَّم هو عنصر نائب يتم نسخه من عرض تقديمي مختلف، سيتم نسخ الخصائص التي يتم توريثها من الصفحات الرئيسية أو صفحات التنسيق إلى العنصر من العرض التقديمي المصدر. 

// Copy a video between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const video = otherPresentationSlide.getVideos[0];
currentPresentationSlide.insertVideo(
    video);  // Also available for Layout, Master, and Page.

المَعلمات

الاسمالنوعالوصف
videoVideoالفيديو الذي سيتم نسخه وإدراجه

الإرجاع

Video: الفيديو المُدرَج

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertWordArt(wordArt)

تُدرج نسخة من WordArt المقدَّم في الصفحة.

يتم تحديد موضع العنصر المُدرَج في هذه الصفحة من موضع العنصر المصدر في صفحته المعنية.

إذا كان العنصر المقدَّم هو عنصر نائب يتم نسخه من داخل العرض التقديمي الحالي، سيتم أيضًا اكتساب الخصائص التي يتم اكتسابها من الصفحات الرئيسية أو صفحات التنسيق في العنصر المُدرَج.

إذا كان العنصر المقدَّم هو عنصر نائب يتم نسخه من عرض تقديمي مختلف، سيتم نسخ الخصائص التي يتم توريثها من الصفحات الرئيسية أو صفحات التنسيق إلى العنصر من العرض التقديمي المصدر. 

// Copy a word art between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const wordArt = otherPresentationSlide.getWordArts[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertWordArt(wordArt);

المَعلمات

الاسمالنوعالوصف
wordArtWordArtالمجموعة التي سيتم نسخها وإدراجها

الإرجاع

WordArt: تمثّل word art المُدرَج.

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

remove()

تتم إزالة الصفحة.

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

replaceAllText(findText, replaceText)

يستبدل جميع مثيلات النص المطابق للنص المطلوب البحث عنه بالنص البديل. عملية البحث غير حسّاسة لحالة الأحرف.

المَعلمات

الاسمالنوعالوصف
findTextStringالنص المطلوب البحث عنه.
replaceTextStringالنص الذي سيتم استبدال النص المطابق به

الإرجاع

Integer: تم تغيير عدد مرات الظهور.

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

replaceAllText(findText, replaceText, matchCase)

يستبدل جميع مثيلات النص المطابق للنص المطلوب البحث عنه بالنص البديل.

المَعلمات

الاسمالنوعالوصف
findTextStringالنص المطلوب البحث عنه.
replaceTextStringالنص الذي سيتم استبدال النص المطابق به
matchCaseBooleanإذا كانت القيمة true، تكون عملية البحث حسّاسة لحالة الأحرف، وإذا كانت القيمة false، تكون عملية البحث غير حسّاسة لحالة الأحرف.

الإرجاع

Integer: تم تغيير عدد مرات الظهور.

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

selectAsCurrentPage()

يختار Page في العرض التقديمي النشط كـ current page selection ويزيل أي اختيار سابق.

لا يمكن للنص البرمجي الوصول إلى تحديد المستخدم الذي يشغّل النص البرمجي إلا إذا كان النص البرمجي مرتبطًا بالعرض التقديمي. 

// Select the first slide as the current page selection and replace any previous
// selection.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.selectAsCurrentPage();  // Also available for Layout, Master, and Page.

التفويض

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

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations