Class Page

الصفحة

صفحة في عرض تقديمي.

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
asLayout()Layoutلعرض الصفحة على هيئة تنسيق.
asMaster()Masterتعرض الصفحة كصفحة رئيسية.
asSlide()Slideلعرض الصفحة على شكل شريحة.
getBackground()PageBackgroundللحصول على خلفية الصفحة.
getColorScheme()ColorSchemeللحصول على ColorScheme المرتبط بالصفحة.
getGroups()Group[]تعرض قائمة من عناصر Group على الصفحة.
getImages()Image[]تعرض قائمة من عناصر Image على الصفحة.
getLines()Line[]تعرض قائمة من عناصر Line على الصفحة.
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 على الصفحة.
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 المقدمة في الصفحة.
remove()voidلإزالة الصفحة.
replaceAllText(findText, replaceText)Integerلاستبدال جميع تكرارات النص المطابق للبحث عن النص باستبدال النص.
replaceAllText(findText, replaceText, matchCase)Integerلاستبدال جميع تكرارات النص المطابق للبحث عن النص باستبدال النص.
selectAsCurrentPage()voidاختيار Page في العرض التقديمي النشط باعتباره current page selection وإزالة أي اختيار سابق

الوثائق التفصيلية

asLayout()

لعرض الصفحة على هيئة تنسيق.

استرجاع الكرة

Layout: الصفحة كتنسيق.

التفويض

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

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

asMaster()

تعرض الصفحة كصفحة رئيسية.

استرجاع الكرة

Master — الصفحة الرئيسية.

التفويض

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

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

asSlide()

لعرض الصفحة على شكل شريحة.

استرجاع الكرة

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

getLines()

تعرض قائمة من عناصر Line على الصفحة.

استرجاع الكرة

Line[]

التفويض

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

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

getObjectId()

الحصول على المعرّف الفريد للصفحة تتشارك معرفات العناصر التي تستخدمها الصفحات وعناصر الصفحة نفس مساحة الاسم.

استرجاع الكرة

String

التفويض

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

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

getPageElementById(id)

لعرض PageElement على الصفحة بالمعرّف المحدّد، أو عرض null في حال عدم وجود أي معرّف.

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

الاسمTypeالوصف
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

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.

المَعلمات

الاسمTypeالوصف
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.

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

الاسمTypeالوصف
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().

المَعلمات

الاسمTypeالوصف
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().

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

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

الاسمTypeالوصف
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]);

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

الاسمTypeالوصف
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.

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

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

استرجاع الكرة

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

التفويض

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

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

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

يدرج شكلاً على الصفحة.

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

الاسمTypeالوصف
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.

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

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

استرجاع الكرة

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

التفويض

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

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

insertTable(numRows, numColumns)

إدراج جدول في الصفحة

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

المَعلمات

الاسمTypeالوصف
numRowsIntegerعدد الصفوف في الجدول.
numColumnsIntegerعدد الأعمدة في الجدول.

استرجاع الكرة

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

التفويض

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

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

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

يدرج جدولاً على الصفحة بالموضع والحجم المقدمين.

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

المَعلمات

الاسمTypeالوصف
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.

المَعلمات

الاسمTypeالوصف
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.

المَعلمات

الاسمTypeالوصف
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.

المَعلمات

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

استرجاع الكرة

Shape — شكل مربّع النص الذي تم إدراجه

التفويض

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

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

insertVideo(videoUrl)

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

تتوفّر حاليًا فيديوهات YouTube فقط.

المَعلمات

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

استرجاع الكرة

Video — الفيديو الذي تم إدراجه

التفويض

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

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

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

يدرج فيديو على الصفحة مع الموضع والحجم المقدمين.

تتوفّر حاليًا فيديوهات YouTube فقط.

المَعلمات

الاسمTypeالوصف
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.

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

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

استرجاع الكرة

WordArt — تم إدراج word art.

التفويض

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

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

remove()

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

التفويض

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

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

replaceAllText(findText, replaceText)

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

المَعلمات

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

استرجاع الكرة

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

التفويض

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

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

replaceAllText(findText, replaceText, matchCase)

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

المَعلمات

الاسمTypeالوصف
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