عنصر يمثل منطقة نص منسّقة. النص الموجود في Document
مضمّن في عناصر Text
.
يمكن تضمين أحد عناصر Text
في Equation
أو EquationFunction
أو
ListItem
أو Paragraph
، ولكن لا يمكن أن يحتوي العنصر نفسه على أي عنصر آخر. لمزيد من المعلومات حول بنية المستند، يمكنك الاطّلاع على دليل توسيع مستندات Google.
var body = DocumentApp.getActiveDocument().getBody(); // Use editAsText to obtain a single text element containing // all the characters in the document. var text = body.editAsText(); // Insert text at the beginning of the document. text.insertText(0, 'Inserted text.\n'); // Insert text at the end of the document. text.appendText('\nAppended text.'); // Make the first half of the document blue. text.setForegroundColor(0, text.getText().length / 2, '#00FFFF');
الطُرق
الطريقة | نوع الإرجاع | وصف قصير |
---|---|---|
appendText(text) | Text | لإضافة النص المحدد إلى نهاية هذه المنطقة النصية. |
copy() | Text | عرض نسخة منفصلة من العنصر الحالي بشكل منفصل. |
deleteText(startOffset, endOffsetInclusive) | Text | حذف نطاق نصي. |
editAsText() | Text | للحصول على نسخة Text من العنصر الحالي للتعديل. |
findText(searchPattern) | RangeElement | يبحث في محتوى العنصر عن نمط النص المحدّد باستخدام التعبيرات العادية. |
findText(searchPattern, from) | RangeElement | يبحث في محتوى العنصر عن نمط النص المحدَّد، بدءًا من نتيجة بحث معيّنة. |
getAttributes() | Object | لاسترداد سمات العنصر\u39s. |
getAttributes(offset) | Object | استرداد السمات عند إزاحة الأحرف المحددة. |
getBackgroundColor() | String | استرداد إعداد لون الخلفية. |
getBackgroundColor(offset) | String | استرداد لون الخلفية عند إزاحة الحرف المحددة. |
getFontFamily() | String | لاسترداد إعداد مجموعة الخطوط. |
getFontFamily(offset) | String | استرداد مجموعة الخطوط عند إزاحة الحرف المحددة. |
getFontSize() | Number | لاسترداد إعداد حجم الخط. |
getFontSize(offset) | Number | استرداد حجم الخط عند إزاحة الحرف المحددة. |
getForegroundColor() | String | استرداد إعداد لون الواجهة |
getForegroundColor(offset) | String | استرداد لون الواجهة عند إزاحة الحرف المحددة. |
getLinkUrl() | String | لاسترداد عنوان URL للرابط. |
getLinkUrl(offset) | String | لاسترداد عنوان URL للرابط عند إزاحة الحرف المحددة. |
getNextSibling() | Element | لاسترداد العنصر التالي. |
getParent() | ContainerElement | لاسترداد العنصر الرئيسي للعنصر. |
getPreviousSibling() | Element | لاسترجاع العنصر السابق الذي يشبه العنصر نفسه. |
getText() | String | لاسترداد محتوى العنصر كسلسلة نصية. |
getTextAlignment() | TextAlignment | لمحاذاة النص. |
getTextAlignment(offset) | TextAlignment | محاذاة النص إلى حرف واحد. |
getTextAttributeIndices() | Integer[] | لاسترداد مجموعة فهارس النصوص التي تتوافق مع بداية تشغيل تنسيق النص المميز. |
getType() | ElementType | لاسترداد العنصر ElementType 's. |
insertText(offset, text) | Text | إدراج النص المحدد عند إزاحة الحرف المحددة. |
isAtDocumentEnd() | Boolean | تحدِّد هذه السياسة ما إذا كان العنصر سيكون في نهاية Document . |
isBold() | Boolean | استرداد الإعداد الغامق. |
isBold(offset) | Boolean | استرداد الإعداد الغامق عند إزاحة الحرف المحددة. |
isItalic() | Boolean | استرداد الإعداد المائل. |
isItalic(offset) | Boolean | استرداد الإعداد المائل عند إزاحة الحرف المحددة. |
isStrikethrough() | Boolean | استرداد إعداد يتوسطه خط |
isStrikethrough(offset) | Boolean | استرداد إعداد يتوسطه خط عند إزاحة الحرف المحددة. |
isUnderline() | Boolean | لاسترداد إعداد التسطير. |
isUnderline(offset) | Boolean | استرداد إعداد التسطير عند إزاحة الحرف المحددة. |
merge() | Text | لدمج العنصر مع العنصر التابع السابق من النوع نفسه. |
removeFromParent() | Text | إزالة العنصر من العنصر الرئيسي. |
replaceText(searchPattern, replacement) | Element | استبدال جميع تكرارات نمط نص معين بسلسلة استبدال محددة، باستخدام التعبيرات العادية. |
setAttributes(startOffset, endOffsetInclusive, attributes) | Text | يتم تطبيق السمات المحدّدة على نطاق الأحرف المحدّد. |
setAttributes(attributes) | Text | تحدد سمات العنصر\u39;s. |
setBackgroundColor(startOffset, endOffsetInclusive, color) | Text | لضبط لون الخلفية لنطاق الأحرف المحدد. |
setBackgroundColor(color) | Text | لضبط لون الخلفية. |
setBold(bold) | Text | لضبط الإعداد بالخط الغامق. |
setBold(startOffset, endOffsetInclusive, bold) | Text | لضبط الإعداد بالخط الغامق لنطاق الأحرف المحدّد. |
setFontFamily(startOffset, endOffsetInclusive, fontFamilyName) | Text | لضبط مجموعة الخطوط لنطاق الأحرف المحدّد. |
setFontFamily(fontFamilyName) | Text | لضبط مجموعة الخطوط. |
setFontSize(startOffset, endOffsetInclusive, size) | Text | لتحديد حجم الخط لنطاق الأحرف المحدد. |
setFontSize(size) | Text | لضبط حجم الخط. |
setForegroundColor(startOffset, endOffsetInclusive, color) | Text | تعمل هذه السياسة على ضبط لون المقدّمة لنطاق الأحرف المحدّد. |
setForegroundColor(color) | Text | ضبط لون الواجهة |
setItalic(italic) | Text | لضبط الإعداد المائل. |
setItalic(startOffset, endOffsetInclusive, italic) | Text | لضبط الإعداد المائل لنطاق الأحرف المحدّد. |
setLinkUrl(startOffset, endOffsetInclusive, url) | Text | لضبط عنوان URL للرابط لنطاق الأحرف المحدّد. |
setLinkUrl(url) | Text | لضبط عنوان URL للرابط. |
setStrikethrough(strikethrough) | Text | لضبط إعداد النص الذي يتوسطه خط. |
setStrikethrough(startOffset, endOffsetInclusive, strikethrough) | Text | لضبط إعداد النص الذي يتوسطه خط لنطاق الأحرف المحدد. |
setText(text) | Text | لضبط محتوى النص. |
setTextAlignment(startOffset, endOffsetInclusive, textAlignment) | Text | لضبط محاذاة النص لنطاق أحرف معيّن. |
setTextAlignment(textAlignment) | Text | لضبط محاذاة النص. |
setUnderline(underline) | Text | لضبط إعداد التسطير. |
setUnderline(startOffset, endOffsetInclusive, underline) | Text | لضبط إعداد التسطير لنطاق الأحرف المحدّد. |
المستندات التفصيلية
appendText(text)
لإضافة النص المحدد إلى نهاية هذه المنطقة النصية.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
text | String | النص الذي تريد إلحاقه |
تذكرة ذهاب وعودة
Text
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
copy()
عرض نسخة منفصلة من العنصر الحالي بشكل منفصل.
يتم أيضًا نسخ أي عناصر فرعية موجودة في العنصر. لا يحتوي العنصر الجديد على عنصر رئيسي.
تذكرة ذهاب وعودة
Text
— النسخة الجديدة:
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
deleteText(startOffset, endOffsetInclusive)
حذف نطاق نصي.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
startOffset | Integer | إزاحة الحرف الأول للحذف |
endOffsetInclusive | Integer | إزاحة الحرف الأخير للحذف |
تذكرة ذهاب وعودة
Text
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
editAsText()
للحصول على نسخة Text
من العنصر الحالي للتعديل.
يمكنك استخدام editAsText
للتلاعب بمحتوى العناصر في شكل نص منسَّق. ويتجاهل الوضع editAsText
العناصر غير النصية (مثل InlineImage
وHorizontalRule
).
تتم إزالة العناصر الفرعية المضمّنة بالكامل داخل نطاق نصي محذوف من العنصر.
var body = DocumentApp.getActiveDocument().getBody(); // Insert two paragraphs separated by a paragraph containing an // horizontal rule. body.insertParagraph(0, "An editAsText sample."); body.insertHorizontalRule(0); body.insertParagraph(0, "An example."); // Delete " sample.\n\n An" removing the horizontal rule in the process. body.editAsText().deleteText(14, 25);
تذكرة ذهاب وعودة
Text
— نسخة نصية من العنصر الحالي
findText(searchPattern)
يبحث في محتوى العنصر عن نمط النص المحدّد باستخدام التعبيرات العادية.
لا تتوفّر مجموعة فرعية من ميزات التعبير العادي في JavaScript بشكل كامل، مثل مجموعات الالتقاط ومفاتيح تعديل الوضع.
تتم مطابقة نمط التعبير العادي المقدَّم بشكل مستقل مع كل نص يحتوي على العنصر الحالي.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
searchPattern | String | النمط المطلوب البحث عنه |
تذكرة ذهاب وعودة
RangeElement
- نتيجة بحث تشير إلى موضع نص البحث، أو قيمة فارغة في حال عدم التطابق
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
findText(searchPattern, from)
يبحث في محتوى العنصر عن نمط النص المحدَّد، بدءًا من نتيجة بحث معيّنة.
لا تتوفّر مجموعة فرعية من ميزات التعبير العادي في JavaScript بشكل كامل، مثل مجموعات الالتقاط ومفاتيح تعديل الوضع.
تتم مطابقة نمط التعبير العادي المقدَّم بشكل مستقل مع كل نص يحتوي على العنصر الحالي.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
searchPattern | String | النمط المطلوب البحث عنه |
from | RangeElement | نتيجة البحث للبحث من |
تذكرة ذهاب وعودة
RangeElement
- نتيجة بحث تشير إلى الموضع التالي لنص البحث، أو قيمة فارغة في حال عدم وجود مطابقة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getAttributes()
لاسترداد سمات العنصر\u39s.
النتيجة هي كائن يحتوي على خاصية لكل سمة عنصر صالحة حيث يتوافق
كل اسم سمة مع عنصر في تعداد DocumentApp.Attribute
.
var body = DocumentApp.getActiveDocument().getBody(); // Append a styled paragraph. var par = body.appendParagraph('A bold, italicized paragraph.'); par.setBold(true); par.setItalic(true); // Retrieve the paragraph's attributes. var atts = par.getAttributes(); // Log the paragraph attributes. for (var att in atts) { Logger.log(att + ":" + atts[att]); }
تذكرة ذهاب وعودة
Object
- سمات العنصر
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getAttributes(offset)
استرداد السمات عند إزاحة الأحرف المحددة.
النتيجة هي كائن يحتوي على سمة لكل سمة نصية صالحة حيث يتوافق كل
اسم خاصية مع عنصر في تعداد DocumentApp.Attribute
.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
offset | Integer | إزاحة الحرف |
تذكرة ذهاب وعودة
Object
— سمات item's
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getBackgroundColor()
استرداد إعداد لون الخلفية.
تذكرة ذهاب وعودة
String
: لون الخلفية، بتنسيق تدوين CSS (مثل '#ffffff'
)، أو قيمة فارغة إذا كان العنصر يحتوي على قيم متعددة لهذه السمة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getBackgroundColor(offset)
استرداد لون الخلفية عند إزاحة الحرف المحددة.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
offset | Integer | إزاحة الحرف |
تذكرة ذهاب وعودة
String
- لون الخلفية، بتنسيق تدوين CSS (مثل '#ffffff'
)
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getFontFamily()
لاسترداد إعداد مجموعة الخطوط. يمكن أن يكون الاسم أي خط من قائمة الخطوط في "مستندات Google" أو Google Fonts وهو حسّاس لحالة الأحرف. تستخدم الطُرق getFontFamily()
وsetFontFamily(fontFamilyName)
الآن أسماء السلاسل للخطوط بدلاً من
تعداد
. على الرغم من إيقاف العمل بهذا التعداد، سيظل متاحًا للتوافق مع النصوص البرمجية القديمة.FontFamily
تذكرة ذهاب وعودة
String
: مجموعة الخطوط أو القيمة الفارغة إذا كان العنصر يحتوي على قيم متعدّدة لهذه السمة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getFontFamily(offset)
استرداد مجموعة الخطوط عند إزاحة الحرف المحددة. يمكن أن يكون الاسم أي خط من قائمة الخطوط في "مستندات Google" أو خطوط Google، ويجب أن يكون حساسًا لحالة الأحرف. تستخدم الطُرق getFontFamily()
وsetFontFamily(fontFamilyName)
الآن أسماء السلاسل للخطوط بدلاً من تعداد
. على الرغم من إيقاف العمل بهذا التعداد، سيظل متاحًا للتوافق مع النصوص البرمجية القديمة.FontFamily
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
offset | Integer | إزاحة الحرف |
تذكرة ذهاب وعودة
String
: مجموعة الخطوط
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getFontSize()
لاسترداد إعداد حجم الخط.
تذكرة ذهاب وعودة
Number
- حجم الخط أو قيمة فارغة إذا كان العنصر يحتوي على قيم متعدّدة لهذه السمة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getFontSize(offset)
استرداد حجم الخط عند إزاحة الحرف المحددة.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
offset | Integer | إزاحة الحرف |
تذكرة ذهاب وعودة
Number
- حجم الخط
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getForegroundColor()
استرداد إعداد لون الواجهة
تذكرة ذهاب وعودة
String
: لون الواجهة، بتنسيق بتنسيق CSS (مثل '#ffffff'
)، أو قيمة فارغة إذا كان العنصر يحتوي على قيم متعددة لهذه السمة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getForegroundColor(offset)
استرداد لون الواجهة عند إزاحة الحرف المحددة.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
offset | Integer | إزاحة الحرف |
تذكرة ذهاب وعودة
String
- لون الواجهة، بتنسيق بتنسيق CSS (مثل '#ffffff'
)
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getLinkUrl()
لاسترداد عنوان URL للرابط.
تذكرة ذهاب وعودة
String
— عنوان URL للرابط أو قيمة فارغة إذا كان العنصر يحتوي على قيم متعددة لهذه السمة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getLinkUrl(offset)
لاسترداد عنوان URL للرابط عند إزاحة الحرف المحددة.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
offset | Integer | إزاحة الحرف |
تذكرة ذهاب وعودة
String
— عنوان URL للرابط
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getNextSibling()
لاسترداد العنصر التالي.
العنصر التابع التالي له العنصر الرئيسي نفسه ويتبع العنصر الحالي.
تذكرة ذهاب وعودة
Element
— العنصر التابع التالي.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getParent()
لاسترداد العنصر الرئيسي للعنصر.
يحتوي العنصر الرئيسي على العنصر الحالي.
تذكرة ذهاب وعودة
ContainerElement
— العنصر الرئيسي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getPreviousSibling()
لاسترجاع العنصر السابق الذي يشبه العنصر نفسه.
له العنصر الرئيسي السابق نفسه ويسبق العنصر الحالي.
تذكرة ذهاب وعودة
Element
— العنصر التابع السابق.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getText()
لاسترداد محتوى العنصر كسلسلة نصية.
تذكرة ذهاب وعودة
String
- محتوى العنصر كسلسلة نصية
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getTextAlignment()
لمحاذاة النص. أنواع التوافق المتاحة هي DocumentApp.TextAlignment.NORMAL
وDocumentApp.TextAlignment.SUBSCRIPT
وDocumentApp.TextAlignment.SUPERSCRIPT
.
تذكرة ذهاب وعودة
TextAlignment
: نوع محاذاة النص، أو null
إذا كان النص يحتوي على أنواع متعددة من محاذاة النص، أو إذا لم يتم ضبط محاذاة النص مطلقًا
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getTextAlignment(offset)
محاذاة النص إلى حرف واحد. أنواع التوافق المتاحة هي DocumentApp.TextAlignment.NORMAL
وDocumentApp.TextAlignment.SUBSCRIPT
وDocumentApp.TextAlignment.SUPERSCRIPT
.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
offset | Integer | إزاحة الحرف |
تذكرة ذهاب وعودة
TextAlignment
: نوع محاذاة النص، أو null
إذا لم يتم ضبط محاذاة النص مطلقًا
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getTextAttributeIndices()
لاسترداد مجموعة فهارس النصوص التي تتوافق مع بداية تشغيل تنسيق النص المميز.
تذكرة ذهاب وعودة
Integer[]
: مجموعة فهارس النصوص التي يتغيّر تنسيق النص فيها
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getType()
لاسترداد العنصر ElementType
's.
استخدِم getType()
لتحديد النوع الدقيق لعنصر معيّن.
var body = DocumentApp.getActiveDocument().getBody(); // Obtain the first element in the document body. var firstChild = body.getChild(0); // Use getType() to determine the element's type. if (firstChild.getType() == DocumentApp.ElementType.PARAGRAPH) { Logger.log('The first element is a paragraph.'); } else { Logger.log('The first element is not a paragraph.'); }
تذكرة ذهاب وعودة
ElementType
— نوع العنصر.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertText(offset, text)
إدراج النص المحدد عند إزاحة الحرف المحددة.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
offset | Integer | إزاحة الأحرف التي يمكن إدراجها |
text | String | النص المطلوب إدراجه |
تذكرة ذهاب وعودة
Text
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
isAtDocumentEnd()
تحدِّد هذه السياسة ما إذا كان العنصر سيكون في نهاية Document
.
تذكرة ذهاب وعودة
Boolean
: ما إذا كان العنصر موجودًا في نهاية المستند.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
isBold()
استرداد الإعداد الغامق.
تذكرة ذهاب وعودة
Boolean
: سواء كان النص غامقًا أو فارغًا إذا كان العنصر يحتوي على قيم متعددة لهذه السمة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
isBold(offset)
استرداد الإعداد الغامق عند إزاحة الحرف المحددة.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
offset | Integer | إزاحة الحرف |
تذكرة ذهاب وعودة
Boolean
— الإعداد الغامق
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
isItalic()
استرداد الإعداد المائل.
تذكرة ذهاب وعودة
Boolean
: سواء كان النص مائلاً أو فارغًا إذا كان العنصر يحتوي على قيم متعددة لهذه السمة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
isItalic(offset)
استرداد الإعداد المائل عند إزاحة الحرف المحددة.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
offset | Integer | إزاحة الحرف |
تذكرة ذهاب وعودة
Boolean
— الإعداد المائل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
isStrikethrough()
استرداد إعداد يتوسطه خط
تذكرة ذهاب وعودة
Boolean
: سواء كان النص يتوسطه خط أو يكون فارغًا إذا كان العنصر يحتوي على قيم متعددة لهذه السمة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
isStrikethrough(offset)
استرداد إعداد يتوسطه خط عند إزاحة الحرف المحددة.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
offset | Integer | إزاحة الحرف |
تذكرة ذهاب وعودة
Boolean
— إعداد يتوسطه خط
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
isUnderline()
لاسترداد إعداد التسطير.
تذكرة ذهاب وعودة
Boolean
: سواء كان النص تحته خط أو فارغًا إذا كان العنصر يحتوي على قيم متعددة لهذه السمة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
isUnderline(offset)
استرداد إعداد التسطير عند إزاحة الحرف المحددة.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
offset | Integer | إزاحة الحرف |
تذكرة ذهاب وعودة
Boolean
— إعداد التسطير
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
merge()
لدمج العنصر مع العنصر التابع السابق من النوع نفسه.
يمكن دمج عناصر ElementType
فقط. يتم نقل أي عناصر فرعية مضمّنة في العنصر الحالي إلى العنصر السابق.
تتم إزالة العنصر الحالي من المستند.
var body = DocumentApp.getActiveDocument().getBody(); // Example 1: Merge paragraphs // Append two paragraphs to the document. var par1 = body.appendParagraph('Paragraph 1.'); var par2 = body.appendParagraph('Paragraph 2.'); // Merge the newly added paragraphs into a single paragraph. par2.merge(); // Example 2: Merge table cells // Create a two-dimensional array containing the table's cell contents. var cells = [ ['Row 1, Cell 1', 'Row 1, Cell 2'], ['Row 2, Cell 1', 'Row 2, Cell 2'] ]; // Build a table from the array. var table = body.appendTable(cells); // Get the first row in the table. var row = table.getRow(0); // Get the two cells in this row. var cell1 = row.getCell(0); var cell2 = row.getCell(1); // Merge the current cell into its preceding sibling element. var merged = cell2.merge();
تذكرة ذهاب وعودة
Text
— العنصر المُدمج
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
removeFromParent()
إزالة العنصر من العنصر الرئيسي.
var body = DocumentApp.getActiveDocument().getBody(); // Remove all images in the document body. var imgs = body.getImages(); for (var i = 0; i < imgs.length; i++) { imgs[i].removeFromParent(); }
تذكرة ذهاب وعودة
Text
- العنصر الذي تمت إزالته
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
replaceText(searchPattern, replacement)
استبدال جميع تكرارات نمط نص معين بسلسلة استبدال محددة، باستخدام التعبيرات العادية.
يتم تمرير نمط البحث كسلسلة، وليس كائن تعبير عادي في JavaScript. ونتيجةً لذلك، ستحتاج إلى تخطي أي شرطة مائلة للخلف في النمط.
تستخدم هذه الطرق مكتبة التعبيرات العادية RE2 الخاصة بـ Google\u39; ، ما يحدّ من البنية المتوافقة.
تتم مطابقة نمط التعبير العادي المقدَّم بشكل مستقل مع كل نص يحتوي على العنصر الحالي.
var body = DocumentApp.getActiveDocument().getBody(); // Clear the text surrounding "Apps Script", with or without text. body.replaceText("^.*Apps ?Script.*$", "Apps Script");
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
searchPattern | String | نمط التعبير العادي للبحث عن |
replacement | String | النص المطلوب استخدامه كبديل |
تذكرة ذهاب وعودة
Element
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setAttributes(startOffset, endOffsetInclusive, attributes)
يتم تطبيق السمات المحدّدة على نطاق الأحرف المحدّد.
يجب أن تكون معلّمة السمات المحدّدة عنصرًا يكون فيه كل اسم موقع عنصرًا في تعداد DocumentApp.Attribute
وتكون كل قيمة سمة هي القيمة الجديدة التي سيتم تطبيقها.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
startOffset | Integer | إزاحة نطاق النص |
endOffsetInclusive | Integer | إزاحة نهاية النص |
attributes | Object | سمات العنصر\39 |
تذكرة ذهاب وعودة
Text
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setAttributes(attributes)
تحدد سمات العنصر\u39;s.
يجب أن تكون معلّمة السمات المحدّدة عنصرًا يكون فيه كل اسم موقع عنصرًا في تعداد DocumentApp.Attribute
وتكون كل قيمة سمة هي القيمة الجديدة التي سيتم تطبيقها.
var body = DocumentApp.getActiveDocument().getBody(); // Define a custom paragraph style. var style = {}; style[DocumentApp.Attribute.HORIZONTAL_ALIGNMENT] = DocumentApp.HorizontalAlignment.RIGHT; style[DocumentApp.Attribute.FONT_FAMILY] = 'Calibri'; style[DocumentApp.Attribute.FONT_SIZE] = 18; style[DocumentApp.Attribute.BOLD] = true; // Append a plain paragraph. var par = body.appendParagraph('A paragraph with custom style.'); // Apply the custom style. par.setAttributes(style);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
attributes | Object | سمات العنصر\39;s. |
تذكرة ذهاب وعودة
Text
— العنصر الحالي.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setBackgroundColor(startOffset, endOffsetInclusive, color)
لضبط لون الخلفية لنطاق الأحرف المحدد.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
startOffset | Integer | إزاحة نطاق النص |
endOffsetInclusive | Integer | إزاحة نهاية النص |
color | String | لون الخلفية، منسَّق بتدوين CSS (مثل '#ffffff' ) |
تذكرة ذهاب وعودة
Text
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setBackgroundColor(color)
لضبط لون الخلفية.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
color | String | لون الخلفية، منسَّق بتدوين CSS (مثل '#ffffff' ) |
تذكرة ذهاب وعودة
Text
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setBold(bold)
لضبط الإعداد بالخط الغامق.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
bold | Boolean | الإعداد الغامق |
تذكرة ذهاب وعودة
Text
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setBold(startOffset, endOffsetInclusive, bold)
لضبط الإعداد بالخط الغامق لنطاق الأحرف المحدّد.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
startOffset | Integer | إزاحة نطاق النص |
endOffsetInclusive | Integer | إزاحة نهاية النص |
bold | Boolean | الإعداد الغامق |
تذكرة ذهاب وعودة
Text
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setFontFamily(startOffset, endOffsetInclusive, fontFamilyName)
لضبط مجموعة الخطوط لنطاق الأحرف المحدّد. يمكن أن يكون الاسم أي خط من قائمة الخطوط في "مستندات Google" أو Google Fonts وهو حسّاس لحالة الأحرف.
سيتم عرض أسماء الخطوط التي لم يتم التعرّف عليها كـ التعري. تستخدم الطُرق getFontFamily(offset)
وsetFontFamily(fontFamilyName)
الآن أسماء السلاسل للخطوط بدلاً من تعداد
. على الرغم من إيقاف العمل بهذا التعداد، سيظل متاحًا للتوافق مع النصوص البرمجية القديمة.FontFamily
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
startOffset | Integer | إزاحة نطاق النص |
endOffsetInclusive | Integer | إزاحة نهاية النص |
fontFamilyName | String | اسم مجموعة الخطوط، من قائمة "الخط" في "مستندات Google" أو Google Fonts |
تذكرة ذهاب وعودة
Text
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setFontFamily(fontFamilyName)
لضبط مجموعة الخطوط. يمكن أن يكون الاسم أي خط من قائمة الخطوط في "مستندات Google" أو Google Fonts وهو حسّاس لحالة الأحرف. سيتم عرض أسماء
الخطوط غير المعروفة كـ التعري. تستخدم الطُرق getFontFamily()
وsetFontFamily(fontFamilyName)
الآن أسماء السلاسل للخطوط بدلاً من تعداد
. على الرغم من إيقاف العمل بهذا التعداد، سيظل متاحًا للتوافق مع النصوص البرمجية القديمة.FontFamily
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
fontFamilyName | String | اسم مجموعة الخطوط، من قائمة "الخط" في "مستندات Google" أو Google Fonts |
تذكرة ذهاب وعودة
Text
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setFontSize(startOffset, endOffsetInclusive, size)
لتحديد حجم الخط لنطاق الأحرف المحدد.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
startOffset | Integer | إزاحة نطاق النص |
endOffsetInclusive | Integer | إزاحة نهاية النص |
size | Number | حجم الخط |
تذكرة ذهاب وعودة
Text
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setFontSize(size)
setForegroundColor(startOffset, endOffsetInclusive, color)
تعمل هذه السياسة على ضبط لون المقدّمة لنطاق الأحرف المحدّد.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
startOffset | Integer | إزاحة نطاق النص |
endOffsetInclusive | Integer | إزاحة نهاية النص |
color | String | لون الواجهة، بتنسيق بتنسيق CSS (مثل '#ffffff' ) |
تذكرة ذهاب وعودة
Text
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setForegroundColor(color)
ضبط لون الواجهة
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
color | String | لون الواجهة، بتنسيق بتنسيق CSS (مثل '#ffffff' ) |
تذكرة ذهاب وعودة
Text
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setItalic(italic)
لضبط الإعداد المائل.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
italic | Boolean | إعدادات الخط المائل |
تذكرة ذهاب وعودة
Text
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setItalic(startOffset, endOffsetInclusive, italic)
لضبط الإعداد المائل لنطاق الأحرف المحدّد.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
startOffset | Integer | إزاحة نطاق النص |
endOffsetInclusive | Integer | إزاحة نهاية النص |
italic | Boolean | إعدادات الخط المائل |
تذكرة ذهاب وعودة
Text
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setLinkUrl(startOffset, endOffsetInclusive, url)
لضبط عنوان URL للرابط لنطاق الأحرف المحدّد.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
startOffset | Integer | إزاحة نطاق النص |
endOffsetInclusive | Integer | إزاحة نهاية النص |
url | String | عنوان URL للرابط |
تذكرة ذهاب وعودة
Text
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setLinkUrl(url)
لضبط عنوان URL للرابط.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
url | String | عنوان URL للرابط |
تذكرة ذهاب وعودة
Text
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setStrikethrough(strikethrough)
لضبط إعداد النص الذي يتوسطه خط.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
strikethrough | Boolean | الإعداد الذي يتوسطه خط |
تذكرة ذهاب وعودة
Text
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setStrikethrough(startOffset, endOffsetInclusive, strikethrough)
لضبط إعداد النص الذي يتوسطه خط لنطاق الأحرف المحدد.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
startOffset | Integer | إزاحة نطاق النص |
endOffsetInclusive | Integer | إزاحة نهاية النص |
strikethrough | Boolean | الإعداد الذي يتوسطه خط |
تذكرة ذهاب وعودة
Text
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setText(text)
لضبط محتوى النص.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
text | String | المحتوى النصي الجديد |
تذكرة ذهاب وعودة
Text
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setTextAlignment(startOffset, endOffsetInclusive, textAlignment)
لضبط محاذاة النص لنطاق أحرف معيّن. إنّ أنواع التوافق المتاحة هي
DocumentApp.TextAlignment.NORMAL
وDocumentApp.TextAlignment.SUBSCRIPT
وDocumentApp.TextAlignment.SUPERSCRIPT
.
// Make the first character in the first paragraph be superscript. var text = DocumentApp.getActiveDocument().getBody().getParagraphs()[0].editAsText(); text.setTextAlignment(0, 0, DocumentApp.TextAlignment.SUPERSCRIPT);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
startOffset | Integer | إزاحة البداية لنطاق الأحرف |
endOffsetInclusive | Integer | الإزاحة النهائية لنطاق الأحرف (شاملة) |
textAlignment | TextAlignment | نوع محاذاة النص المراد تطبيقه |
تذكرة ذهاب وعودة
Text
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setTextAlignment(textAlignment)
لضبط محاذاة النص. أنواع التوافق المتاحة هي DocumentApp.TextAlignment.NORMAL
وDocumentApp.TextAlignment.SUBSCRIPT
وDocumentApp.TextAlignment.SUPERSCRIPT
.
// Make the entire first paragraph be superscript. var text = DocumentApp.getActiveDocument().getBody().getParagraphs()[0].editAsText(); text.setTextAlignment(DocumentApp.TextAlignment.SUPERSCRIPT);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
textAlignment | TextAlignment | نوع محاذاة النص المراد تطبيقه |
تذكرة ذهاب وعودة
Text
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setUnderline(underline)
لضبط إعداد التسطير.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
underline | Boolean | إعداد التسطير |
تذكرة ذهاب وعودة
Text
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setUnderline(startOffset, endOffsetInclusive, underline)
لضبط إعداد التسطير لنطاق الأحرف المحدّد.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
startOffset | Integer | إزاحة نطاق النص |
endOffsetInclusive | Integer | إزاحة نهاية النص |
underline | Boolean | إعداد التسطير |
تذكرة ذهاب وعودة
Text
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents