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 إذا لم يتم العثور على قيم.

المعلّمات

الاسمالنوعالوصف
idStringرقم تعريف عنصر الصفحة الذي يتم استرداده

تذكرة ذهاب وعودة

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 في حال عدم توفّر عنصر نائب مطابق.

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

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

المعلّمات

الاسمالنوعالوصف
placeholderTypePlaceholderType

تذكرة ذهاب وعودة

PageElement

التفويض

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

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

getPlaceholder(placeholderType, placeholderIndex)

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

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

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

المعلّمات

الاسمالنوعالوصف
placeholderTypePlaceholderType
placeholderIndexInteger

تذكرة ذهاب وعودة

PageElement

التفويض

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

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

getPlaceholders()

عرض قائمة العناصر النائبة PageElement في الصفحة

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

المعلّمات

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

تذكرة ذهاب وعودة

Group — المجموعة الجديدة.

التفويض

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

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

insertGroup(group)

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

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

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

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

// Copy a group between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var 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.

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

المعلّمات

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

تذكرة ذهاب وعودة

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.

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

var slide = SlidesApp.getActivePresentation().getSlides()[0];
// Get the Drive image file with the given ID.
var image = DriveApp.getFileById(fileId);
var position = {left: 0, top: 0};
var 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.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var 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.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var 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.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var shape1 = slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
var 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.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var startPoint = {left: 10, top: 10};
var 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.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var 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.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var 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.
var 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" الذي يتيح تعديله. ويمكن للمتعاونين الآخرين الاطّلاع على الرابط المؤدي إلى جدول البيانات المصدر.

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
var 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" الذي يتيح تعديله. ويمكن للمتعاونين الآخرين الاطّلاع على الرابط المؤدي إلى جدول البيانات المصدر.

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var position = {left: 0, top: 0};
var 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.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var sheetsChart = otherPresentationSlide.getSheetsCharts[0];

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

المعلّمات

الاسمالنوعالوصف
sheetsChartSheetsChartسيتم نسخ الرسم البياني للأوراق وإدراجه.

تذكرة ذهاب وعودة

SheetsChart — الرسم البياني لأوراق البيانات التي تم إدراجها.

التفويض

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

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

insertSheetsChartAsImage(sourceChart)

إدراج رسم بياني من "جداول بيانات Google" Image في الصفحة.

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

لم يتم ربط الصورة التي تم إدراجها للرسم البياني بالرسم البياني المصدر لـ "جداول بيانات Google".

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
var 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".

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var position = {left: 0, top: 0};
var 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.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var 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.
var 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.
var 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.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var 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.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var wordArt = otherPresentationSlide.getWordArts[0];

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

المعلّمات

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

تذكرة ذهاب وعودة

WordArt — كلمة word insert.

التفويض

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

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

isSkipped()

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

تذكرة ذهاب وعودة

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

التفويض

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

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

move(index)

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

المعلّمات

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

التفويض

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

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

refreshSlide()

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

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

var currentPresentation = SlidesApp.getActivePresentation();
var sourcePresentation = SlidesApp.openById('sourcePresentationId');
var sourceSlide = sourcePresentation.getSlides()[0];
var 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)

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

المعلّمات

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

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

المعلّمات

الاسمالنوعالوصف
isSkippedBooleanTrue لتخطي الشريحة في وضع العرض التقديمي.

التفويض

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

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

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

var currentPresentation = SlidesApp.getActivePresentation();
var sourcePresentation = SlidesApp.openById('sourcePresentationId');
var sourceSlide = sourcePresentation.getSlides()[0];
var 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