Class Slide

العرض التقديمي

شريحة في عرض تقديمي

تحتوي هذه الصفحات على المحتوى الذي تقدّمه لجمهورك. تستند معظم الشرائح إلى تصميم رئيسي وتصميم. يمكنك تحديد التنسيق الذي تريد استخدامه لكل شريحة عند إنشائها.

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
duplicate()	Slide	تكرار الشريحة
getBackground()	PageBackground	الحصول على خلفية الصفحة
getColorScheme()	ColorScheme	الحصول على ColorScheme المرتبط بالصفحة
getGroups()	Group[]	عرض قائمة Group عنصر في الصفحة
getImages()	Image[]	عرض قائمة Image عنصر في الصفحة
getLayout()	Layout	تحصل على التنسيق الذي تستند إليه الشريحة أو null إذا لم تكن الشريحة مستندة إلى تنسيق.
getLines()	Line[]	عرض قائمة Line عنصر في الصفحة
getNotesPage()	NotesPage	عرض صفحة الملاحظات المرتبطة بالشريحة
getObjectId()	String	تحصل على المعرّف الفريد للصفحة.
getPageElementById(id)	PageElement	تعرِض هذه السمة العنصر PageElement في الصفحة التي تحمل المعرّف المحدّد، أو null إذا لم يكن هناك أي عنصر.
getPageElements()	PageElement[]	عرض قائمة PageElement عناصر معروضة على الصفحة
getPageType()	PageType	الحصول على نوع الصفحة
getPlaceholder(placeholderType)	PageElement	عرض عنصر العنصر النائب PageElement لعنصر PlaceholderType أو null محدّد إذا لم يكن هناك عنصر نائب مطابق
getPlaceholder(placeholderType, placeholderIndex)	PageElement	عرض عنصر العنصر النائب PageElement لـ PlaceholderType و فهرس العنصر النائب المحدّد، أو null إذا لم يكن العنصر النائب متوفّرًا
getPlaceholders()	PageElement[]	عرض قائمة عناصر العنصر النائب PageElement في الصفحة
getShapes()	Shape[]	عرض قائمة Shape عنصر في الصفحة
getSheetsCharts()	SheetsChart[]	عرض قائمة SheetsChart عنصر في الصفحة
getSlideLinkingMode()	SlideLinkingMode	تعرِض هذه السمة SlideLinkingMode للإشارة إلى ما إذا كانت الشريحة مرتبطة بشريحة أخرى.
getSourcePresentationId()	String	تعرِض هذه السمة معرّف المصدر Presentation أو null إذا لم تكن الشريحة مرتبطة.
getSourceSlideObjectId()	String	تعرِض هذه السمة رقم تعريف الشريحة المصدر أو null إذا لم تكن الشريحة مرتبطة.
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	تُدرج هذه العلامة صورة في الصفحة بالموضع والحجم المقدَّمين من قطعة البيانات المحدّدة للصورة.
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 المقدَّمة في الصفحة.
isSkipped()	Boolean	تعرِض ما إذا تم تخطي الشريحة في وضع العرض التقديمي.
move(index)	void	انقل الشريحة إلى الفهرس المحدّد.
refreshSlide()	void	تؤدي هذه العملية إلى إعادة تحميل الشريحة لعرض أي تغييرات تم إجراؤها على الشريحة المصدر المرتبطة.
remove()	void	إزالة الصفحة
replaceAllText(findText, replaceText)	Integer	استبدال جميع تكرارات النص الذي يتطابق مع النص المراد البحث عنه بالنص البديل
replaceAllText(findText, replaceText, matchCase)	Integer	استبدال جميع تكرارات النص الذي يتطابق مع النص المراد البحث عنه بالنص البديل
selectAsCurrentPage()	void	لاختيار Page في العرض النشط كـ current page selection وإزالة أي اختيار سابق
setSkipped(isSkipped)	void	لضبط ما إذا كان سيتم تخطي الشريحة في وضع العرض التقديمي
unlink()	void	يؤدي ذلك إلى إلغاء ربط Slide الحالي بشريحة المصدر.

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

duplicate()

تكرار الشريحة

يتم إنشاء الشريحة المكرّرة بعد الشريحة الأصلية مباشرةً.

الإرجاع

Slide: الشريحة المكرّرة

التفويض

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

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

---

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

---

getLayout()

تحصل على التنسيق الذي تستند إليه الشريحة أو null إذا لم تكن الشريحة مستندة إلى تنسيق.

الإرجاع

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

---

getNotesPage()

عرض صفحة الملاحظات المرتبطة بالشريحة

الإرجاع

NotesPage

التفويض

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

• 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 إذا لم يكن هناك أي عنصر.

المعلمات

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

الإرجاع

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

التفويض

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

• 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 محدّد إذا لم يكن هناك عنصر نائب مطابق

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

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

المعلمات

الاسم	النوع	الوصف
placeholderType	PlaceholderType

الإرجاع

PageElement

التفويض

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

• 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,
);

المعلمات

الاسم	النوع	الوصف
placeholderType	PlaceholderType
placeholderIndex	Integer

الإرجاع

PageElement

التفويض

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

• 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

---

getSlideLinkingMode()

تعرِض هذه السمة SlideLinkingMode للإشارة إلى ما إذا كانت الشريحة مرتبطة بشريحة أخرى.

الإرجاع

SlideLinkingMode - وضع ربط الشرائح

التفويض

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

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

---

getSourcePresentationId()

تعرِض هذه السمة معرّف المصدر Presentation أو null إذا لم تكن الشريحة مرتبطة.

لا يكون لدى الشريحة رقم تعريف مصدر Presentation إلا عندما تكون مرتبطة بشريحة ضمن عرض تقديمي آخر.

الإرجاع

String: رقم تعريف عرض المصدر أو null

التفويض

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

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

---

getSourceSlideObjectId()

تعرِض هذه السمة رقم تعريف الشريحة المصدر أو null إذا لم تكن الشريحة مرتبطة.

لا تحتوي الشريحة على رقم تعريف شريحة مصدر إلا عند ربطها بشريحة ضمن عرض تقديمي آخر.

الإرجاع

String: رقم تعريف الشريحة المصدر أو null

التفويض

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

• 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.

المعلمات

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

الإرجاع

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.

المعلمات

الاسم	النوع	الوصف
group	Group	المجموعة التي سيتمّ نسخها وإدراجها.

الإرجاع

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);

المعلمات

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

الإرجاع

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

التفويض

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

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

---

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

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

يتم جلب الصورة من 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);

المعلمات

الاسم	النوع	الوصف
blobSource	BlobSource	بيانات الصورة
left	Number	الموضع الأفقي للصورة بالنقاط، ويتم قياسه من أعلى يمين الصفحة.
top	Number	الموضع العمودي للصورة بالنقاط، ويتم قياسه من أعلى يمين الصفحة.
width	Number	عرض الصورة بالنقاط
height	Number	ارتفاع الصورة بالنقاط.

الإرجاع

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);

المعلمات

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

الإرجاع

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().

المعلمات

الاسم	النوع	الوصف
imageUrl	String	عنوان 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().

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

المعلمات

الاسم	النوع	الوصف
imageUrl	String	عنوان URL للصورة
left	Number	الموضع الأفقي للصورة بالنقاط، ويتم قياسه من أعلى يمين الصفحة.
top	Number	الموضع العمودي للصورة بالنقاط، ويتم قياسه من أعلى يمين الصفحة.
width	Number	عرض الصورة بالنقاط
height	Number	ارتفاع الصورة بالنقاط.

الإرجاع

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);

المعلمات

الاسم	النوع	الوصف
line	Line	السطر الذي سيتم نسخه وإدراجه.

الإرجاع

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],
);

المعلمات

الاسم	النوع	الوصف
lineCategory	LineCategory	فئة السطر المطلوب إدراجه.
startConnectionSite	ConnectionSite	موقع الربط الذي سيتم فيه ربط بداية الخط
endConnectionSite	ConnectionSite	موقع الربط الذي سيتم فيه ربط نهاية الخط

الإرجاع

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,
);

المعلمات

الاسم	النوع	الوصف
lineCategory	LineCategory	فئة السطر المطلوب إدراجه.
startLeft	Number	الموضع الأفقي لنقطة بداية الخط، ويتم قياسه بالنقاط من أعلى يمين الصفحة.
startTop	Number	الموضع العمودي لنقطة بداية الخط، ويتم قياسه بالنقاط من أعلى يمين الصفحة.
endLeft	Number	الموضع الأفقي لنقطة نهاية الخط، ويتم قياسه بالنقاط من أعلى يمين الصفحة.
endTop	Number	الموضع العمودي لنقطة نهاية الخط، ويتم قياسه بالنقاط من أعلى يمين الصفحة.

الإرجاع

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);

المعلمات

الاسم	النوع	الوصف
pageElement	PageElement	عنصر الصفحة الذي سيتم نسخه وإدراجه.

الإرجاع

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.

المعلمات

الاسم	النوع	الوصف
shape	Shape	الشكل الذي سيتم نسخه وإدراجه.

الإرجاع

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);

المعلمات

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

الإرجاع

Shape: الشكل الذي تم إدراجه

التفويض

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

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

---

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

لإدراج شكل في الصفحة

المعلمات

الاسم	النوع	الوصف
shapeType	ShapeType	نوع الشكل المطلوب إدراجه.
left	Number	الموضع الأفقي للشكل، ويتم قياسه من الزاوية العلوية اليسرى من الصفحة.
top	Number	الموضع العمودي للشكل، ويتم قياسه من أعلى يمين الصفحة.
width	Number	عرض الشكل
height	Number	ارتفاع الشكل

الإرجاع

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);

المعلمات

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

الإرجاع

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,
);

المعلمات

الاسم	النوع	الوصف
sourceChart	EmbeddedChart	الرسم البياني في جدول بيانات ليتم إدراجه في الصفحة
left	Number	الموضع الأفقي للرسم البياني بالنقاط، ويتم قياسه من أعلى يمين الصفحة.
top	Number	الموضع العمودي للرسم البياني بالنقاط، ويتم قياسه من أعلى يمين الصفحة.
width	Number	عرض الرسم البياني بالنقاط.
height	Number	ارتفاع الرسم البياني بالنقاط.

الإرجاع

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);

المعلمات

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

الإرجاع

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.

المعلمات

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

الإرجاع

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,
);

المعلمات

الاسم	النوع	الوصف
sourceChart	EmbeddedChart	الرسم البياني في جدول بيانات ليتم إدراجه في الصفحة
left	Number	الموضع الأفقي للرسم البياني بالنقاط، ويتم قياسه من أعلى يمين الصفحة.
top	Number	الموضع العمودي للرسم البياني بالنقاط، ويتم قياسه من أعلى يمين الصفحة.
width	Number	عرض الرسم البياني بالنقاط.
height	Number	ارتفاع الرسم البياني بالنقاط.

الإرجاع

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

التفويض

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

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

---

insertTable(numRows, numColumns)

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

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

المعلمات

الاسم	النوع	الوصف
numRows	Integer	عدد الصفوف في الجدول
numColumns	Integer	عدد الأعمدة في الجدول

الإرجاع

Table: الجدول المُدرَج

التفويض

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

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

---

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

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

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

المعلمات

الاسم	النوع	الوصف
numRows	Integer	عدد الصفوف في الجدول
numColumns	Integer	عدد الأعمدة في الجدول
left	Number	الموضع الأفقي للجدول، ويتم قياسه من أعلى يمين الصفحة.
top	Number	الموضع العمودي للجدول، ويتم قياسه من أعلى يمين الصفحة.
width	Number	عرض الجدول.
height	Number	الحد الأدنى لارتفاع الجدول يعتمد الارتفاع الفعلي للجدول المعروض على عوامل مثل حجم خط النص.

الإرجاع

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.

المعلمات

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

الإرجاع

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.

المعلمات

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

الإرجاع

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.

المعلمات

الاسم	النوع	الوصف
text	String	السلسلة التي يجب أن يحتوي عليها شكل مربّع النص
left	Number	الموضع الأفقي لشكل مربّع النص، ويتم قياسه من أعلى يمين الصفحة.
top	Number	الموضع العمودي لشكل مربّع النص، ويتم قياسه من أعلى يمين الصفحة.
width	Number	عرض شكل مربّع النص
height	Number	ارتفاع شكل مربّع النص

الإرجاع

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

التفويض

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

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

---

insertVideo(videoUrl)

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

لا تتوفّر حاليًا سوى فيديوهات YouTube.

المعلمات

الاسم	النوع	الوصف
videoUrl	String	عنوان URL للفيديو المطلوب إدراجه.

الإرجاع

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

التفويض

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

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

---

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

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

لا تتوفّر حاليًا سوى فيديوهات YouTube.

المعلمات

الاسم	النوع	الوصف
videoUrl	String	عنوان URL للفيديو المطلوب إدراجه.
left	Number	الموضع الأفقي للفيديو بالنقاط، ويتم قياسه من أعلى يمين الصفحة.
top	Number	الموضع العمودي للفيديو بالنقاط، ويتم قياسه من أعلى يمين الصفحة.
width	Number	عرض الفيديو بالنقاط
height	Number	ارتفاع الفيديو بالنقاط

الإرجاع

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.

المعلمات

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

الإرجاع

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);

المعلمات

الاسم	النوع	الوصف
wordArt	WordArt	المجموعة التي سيتمّ نسخها وإدراجها.

الإرجاع

WordArt: عنصر word art الذي تم إدراجه

التفويض

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

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

---

isSkipped()

تعرِض ما إذا تم تخطي الشريحة في وضع العرض التقديمي.

الإرجاع

Boolean — True في حال تخطّي الشريحة في وضع العرض التقديمي

التفويض

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

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

---

move(index)

انقل الشريحة إلى الفهرس المحدّد.

المعلمات

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

التفويض

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

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

---

refreshSlide()

تؤدي هذه العملية إلى إعادة تحميل الشريحة لعرض أي تغييرات تم إجراؤها على الشريحة المصدر المرتبطة. إذا كانت هذه الشريحة غير مرتبطة، يتم عرضها بدون إجراء أي تغييرات.

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

ملاحظة: تؤدي إعادة التحميل إلى استبدال أي تغييرات تم إجراؤها على الслайд الحالي لعرض حالة الشريحة المصدر.

const currentPresentation = SlidesApp.getActivePresentation();
const sourcePresentation = SlidesApp.openById('sourcePresentationId');
const sourceSlide = sourcePresentation.getSlides()[0];
const linkedSlide = currentPresentation.append(
    sourceSlide,
    SlidesApp.SlideLinkingMode.LINKED,
);

sourceSlide.insertText(
    'hello world');  // Only the source slide has the text box.

linkedSlide.refreshSlide();  // The linked slide now has the text box.

عمليات الرمي

Error - إذا لم تعُد إمكانية الوصول للقراءة إلى العرض التقديمي المصدر متاحة.

التفويض

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

• 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)

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

المعلمات

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

الإرجاع

Integer - تم تغيير عدد مرات التكرار

التفويض

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

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

---

replaceAllText(findText, replaceText, matchCase)

استبدال جميع تكرارات النص الذي يتطابق مع النص المراد البحث عنه بالنص البديل

المعلمات

الاسم	النوع	الوصف
findText	String	النص المطلوب البحث عنه.
replaceText	String	النص الذي سيتم استبدال النص المطابق به.
matchCase	Boolean	إذا كان الخيار 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

---

setSkipped(isSkipped)

لضبط ما إذا كان سيتم تخطي الشريحة في وضع العرض التقديمي

المعلمات

الاسم	النوع	الوصف
isSkipped	Boolean	True لتخطّي الشريحة في وضع العرض التقديمي

التفويض

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

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

---

unlink()

يؤدي ذلك إلى إلغاء ربط Slide الحالي بشريحة المصدر. إذا لم تكن هذه الشريحة مرتبطة، يتم عرض القيمة بدون إجراء أي تغييرات.

const currentPresentation = SlidesApp.getActivePresentation();
const sourcePresentation = SlidesApp.openById('sourcePresentationId');
const sourceSlide = sourcePresentation.getSlides()[0];
const linkedSlide = currentPresentation.append(
    sourceSlide,
    SlidesApp.SlideLinkingMode.LINKED,
);

linkedSlide.unlink();

linkedSlide.getSourcePresentationId();  // returns null
linkedSlide.getSourceSlideObjectId();   // returns null
linkedSlide
    .getSlideLinkingMode();  // returns SlidesApp.SlideLinkingMode.NOT_LINKED

التفويض

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

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