Class Master

خبير

خبير في عرض تقديمي.

يحتوي الجزء الرئيسي على جميع عناصر الصفحة الشائعة والخصائص المشتركة لمجموعة من التخطيطات. هم لخدمة ثلاثة أغراض:

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

الطُرق

الطريقةنوع الإرجاعوصف قصير
getBackground()PageBackgroundالحصول على خلفية الصفحة
getColorScheme()ColorSchemeالحصول على ColorScheme المرتبط بالصفحة.
getGroups()Group[]عرض قائمة عناصر Group في الصفحة.
getImages()Image[]عرض قائمة عناصر Image في الصفحة.
getLayouts()Layout[]الحصول على تخطيطات هذا الشرائح الرئيسية.
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إدراج صورة أعلى الجانب الأيمن من الصفحة بحجم افتراضي من الحجم المحدد الكائن الثنائي الكبير (blob)
insertImage(blobSource, left, top, width, height)Imageيتم إدراج صورة في الصفحة باستخدام الموضع والحجم المحدّدَين من الكائن الثنائي الكبير (blob) المحدد للصورة.
insertImage(image)Imageإدراج نسخة من Image المقدَّم في الصفحة
insertImage(imageUrl)Imageيتم إدراج صورة في أعلى يمين الصفحة بالحجم التلقائي من عنوان URL المقدَّم.
insertImage(imageUrl, left, top, width, height)Imageيتم إدراج صورة في الصفحة باستخدام الموضع والحجم المحدّدَين من عنوان URL المقدَّم.
insertLine(line)Lineإدراج نسخة من Line المقدَّم في الصفحة
insertLine(lineCategory, startConnectionSite, endConnectionSite)Lineيتم إدراج سطر في الصفحة يربط بين connection sites.
insertLine(lineCategory, startLeft, startTop, endLeft, endTop)Lineيدرج سطرًا في الصفحة.
insertPageElement(pageElement)PageElementإدراج نسخة من PageElement المقدَّم في الصفحة
insertShape(shape)Shapeإدراج نسخة من Shape المقدَّم في الصفحة
insertShape(shapeType)Shapeيدرج شكلاً في الصفحة.
insertShape(shapeType, left, top, width, height)Shapeيدرج شكلاً في الصفحة.
insertSheetsChart(sourceChart)SheetsChartيدرج رسمًا بيانيًا من "جداول بيانات Google" في الصفحة.
insertSheetsChart(sourceChart, left, top, width, height)SheetsChartيدرج رسمًا بيانيًا لـ "جداول بيانات Google" في الصفحة بالموضع والحجم المحدّدَين.
insertSheetsChart(sheetsChart)SheetsChartإدراج نسخة من SheetsChart المقدَّم في الصفحة
insertSheetsChartAsImage(sourceChart)Imageيدرج رسمًا بيانيًا من "جداول بيانات Google" على شكل Image في الصفحة.
insertSheetsChartAsImage(sourceChart, left, top, width, height)Imageيدرج رسمًا بيانيًا لـ "جداول بيانات Google" كـ Image في الصفحة بالموضع المحدد الحجم.
insertTable(numRows, numColumns)Tableلإدراج جدول في الصفحة.
insertTable(numRows, numColumns, left, top, width, height)Tableلإدراج جدول على الصفحة بالموضع والحجم المحدّدَين
insertTable(table)Tableإدراج نسخة من Table المقدَّم في الصفحة
insertTextBox(text)Shapeإدراج مربّع نص Shape يحتوي على السلسلة المتوفّرة في الصفحة
insertTextBox(text, left, top, width, height)Shapeإدراج مربّع نص Shape يحتوي على السلسلة المتوفّرة في الصفحة
insertVideo(videoUrl)Videoلإدراج فيديو بحجم افتراضي في أعلى يمين الصفحة.
insertVideo(videoUrl, left, top, width, height)Videoإدراج فيديو على الصفحة بالموضع والحجم المحدّدَين
insertVideo(video)Videoإدراج نسخة من Video المقدَّم في الصفحة
insertWordArt(wordArt)WordArtإدراج نسخة من WordArt المقدَّم في الصفحة
remove()voidلإزالة الصفحة
replaceAllText(findText, replaceText)Integerلاستبدال جميع مثيلات مطابقة النص (البحث عن النص) باستبدال النص.
replaceAllText(findText, replaceText, matchCase)Integerلاستبدال جميع مثيلات مطابقة النص (البحث عن النص) باستبدال النص.
selectAsCurrentPage()voidيؤدي هذا الإجراء إلى اختيار Page في العرض التقديمي النشط باعتباره current page selection وإزالة أي اختيار سابق.

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

getBackground()

الحصول على خلفية الصفحة

الإرجاع

PageBackground — خلفية الصفحة.

التفويض

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

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

getColorScheme()

الحصول على ColorScheme المرتبط بالصفحة.

الإرجاع

ColorScheme — نظام ألوان الصفحة.

التفويض

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

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

getGroups()

عرض قائمة عناصر Group في الصفحة.

الإرجاع

Group[]

التفويض

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

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

getImages()

عرض قائمة عناصر Image في الصفحة.

الإرجاع

Image[]

التفويض

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

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

getLayouts()

الحصول على تخطيطات هذا الشرائح الرئيسية.

الإرجاع

Layout[]

التفويض

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

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

getLines()

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

الإرجاع

Line[]

التفويض

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

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

getObjectId()

الحصول على المعرّف الفريد للصفحة تتشارك أرقام تعريف الكائنات المستخدمة بواسطة الصفحات وعناصر الصفحة في نفس مساحة الاسم.

الإرجاع

String

التفويض

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

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

getPageElementById(id)

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

المعلمات

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

الإرجاع

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

التفويض

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

  • 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

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)

إدراج صورة أعلى الجانب الأيمن من الصفحة بحجم افتراضي من الحجم المحدد الكائن الثنائي الكبير (blob)

يؤدي إدراج الصورة إلى استرجاعها من "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)

يتم إدراج صورة في الصفحة باستخدام الموضع والحجم المحدّدَين من الكائن الثنائي الكبير (blob) المحدد للصورة.

تم استرجاع الصورة من 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 — الكلمة الفنية المُدرجة

التفويض

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

  • 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