الطلب
تعديل واحد لتطبيقه على مستند.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد
request . تمثّل هذه السمة الطلب المحدّد المطلوب تطبيقه. يجب توفّر حقل واحد بالضبط.
يمكن أن تكون السمة request
واحدة فقط من العناصر التالية:
|
|
replaceAllText
|
استبدال جميع مثيلات النص المحدد. |
insertText
|
إدراج نص في الموقع المحدّد |
updateTextStyle
|
يعدّل نمط النص في النطاق المحدد. |
createParagraphBullets
|
تنشئ التعداد النقطي للفقرات. |
deleteParagraphBullets
|
حذف التعداد النقطي من الفقرات |
createNamedRange
|
تنشئ نطاقًا مُعنوَنًا. |
deleteNamedRange
|
حذف نطاق مُعنوَن |
updateParagraphStyle
|
تعديل نمط الفقرة في النطاق المحدد. |
deleteContentRange
|
حذف المحتوى من المستند |
insertInlineImage
|
إدراج صورة مضمّنة في الموقع المحدّد |
insertTable
|
إدراج جدول في الموقع المحدّد |
insertTableRow
|
إدراج صف فارغ في جدول |
insertTableColumn
|
إدراج عمود فارغ في الجدول |
deleteTableRow
|
لحذف صف من الجدول. |
deleteTableColumn
|
حذف عمود من الجدول |
insertPageBreak
|
إدراج فاصل صفحة في المكان المحدّد |
deletePositionedObject
|
حذف عنصر تم تحديد موضعه من المستند |
updateTableColumnProperties
|
تعدّل خصائص الأعمدة في الجدول. |
updateTableCellStyle
|
تعديل نمط خلايا الجدول |
updateTableRowStyle
|
يعدّل نمط الصف في الجدول. |
replaceImage
|
تستبدل صورة في المستند. |
updateDocumentStyle
|
يعدِّل نمط المستند. |
mergeTableCells
|
لدمج الخلايا في جدول |
unmergeTableCells
|
يتم إلغاء دمج الخلايا في الجدول. |
createHeader
|
تنشئ عنوانًا. |
createFooter
|
تنشئ هذه العلامة تذييلاً. |
createFootnote
|
تنشئ حاشية سفلية. |
replaceNamedRangeContent
|
لاستبدال المحتوى في نطاق مُعنوَن. |
updateSectionStyle
|
تعديل نمط القسم للنطاق المحدَّد. |
insertSectionBreak
|
إدراج فاصل أقسام في الموقع المحدّد |
deleteHeader
|
حذف عنوان من المستند |
deleteFooter
|
حذف تذييل من المستند |
pinTableHeaderRows
|
يعدِّل عدد صفوف العناوين المُثبَّتة في جدول. |
استبدال كل النصوص
استبدال جميع مثيلات النص المطابق لمعايير بـ replace text
.
تمثيل JSON |
---|
{ "replaceText": string, // Union field |
الحقول | |
---|---|
replaceText
|
النص الذي سيحل محل النص المطابق |
حقل الاتحاد
criteria . المعايير المستخدمة لمطابقة النص المطلوب استبداله.
يمكن أن تكون السمة criteria
واحدة فقط من العناصر التالية:
|
|
containsText
|
يعثر على النص في المستند الذي يطابق هذه السلسلة الفرعية. |
سلسلة فرعية للمعايير
معيار يتطابق مع سلسلة نصية محدّدة في المستند.
تمثيل JSON |
---|
{ "text": string, "matchCase": boolean } |
الحقول | |
---|---|
text
|
النص المطلوب البحث عنه في المستند. |
matchCase
|
تحدّد هذه السياسة ما إذا كان البحث يجب أن يحترم حالة الأحرف التالية:
|
طلب نص
إدراج نص في الموقع المحدّد
تمثيل JSON |
---|
{ "text": string, // Union field |
الحقول | |
---|---|
text
|
النص الذي سيتم إدراجه.
وسيؤدي إدراج حرف جديد ضمنيًا إلى إنشاء سيتم تحديد أنماط النص للنص الذي يتم إدراجه تلقائيًا، مع الحفاظ على نمط النص المجاور بشكل عام. في معظم الحالات، يتطابق نمط النص للنص الذي تم إدراجه مع النص الذي يظهر قبل فهرس الإدراج مباشرةً. ستتم إزالة بعض أحرف التحكم (U+0000-U+0008 وU+000C-U+001F) والأحرف من منطقة الاستخدام الخاص لأساسيات الخطة المتعددة اللغات على يونيكود (U+E000-U+F8FF). |
حقل الاتحاد
insertion_location . الموقع الذي سيتم إدراج النص فيه.
يمكن أن تكون السمة insertion_location
واحدة فقط من العناصر التالية:
|
|
location
|
إدراج النص في فهرس محدد في المستند.
يجب إدراج النص داخل حدود |
endOfSegmentLocation
|
إدراج نص في نهاية الرأس أو التذييل أو الحاشية السفلية أو نص المستند |
الموقع الجغرافي
موقع معيّن في المستند.
تمثيل JSON |
---|
{ "segmentId": string, "index": integer } |
الحقول | |
---|---|
segmentId
|
رقم تعريف العنوان أو التذييل أو الحاشية السفلية التي كان الموقع الجغرافي فيها يشير رقم تعريف الشريحة الفارغ إلى نص المستند. |
index
|
الفهرس المستند إلى الصفر، بوحدات رموز UTF-16.
يرتبط المؤشر ببداية الشريحة التي تحدّدها |
نهاية الشريحة
الموقع الجغرافي في نهاية نص العنوان أو العنوان أو التذييل أو الحاشية السفلية يقع الموقع مباشرةً قبل السطر الأخير الأخير في شريحة المستند.
تمثيل JSON |
---|
{ "segmentId": string } |
الحقول | |
---|---|
segmentId
|
رقم تعريف العنوان أو التذييل أو الحاشية السفلية التي كان الموقع الجغرافي فيها يشير رقم تعريف الشريحة الفارغ إلى نص المستند. |
تعديل نمط النص
عدِّل نمط النص.
تمثيل JSON |
---|
{ "textStyle": { object ( |
الحقول | |
---|---|
textStyle
|
الأنماط المطلوب ضبطها على النص. إذا كانت قيمة نمط معيّن تتطابق مع قيمة النمط الرئيسي، سيتم ضبط هذا النمط على اكتساب.
قد تتسبب تغييرات معينة في نمط النص في إجراء تغييرات أخرى من أجل انعكاس سلوك أداة تحرير المستندات. يمكنك الاطّلاع على مستندات |
fields
|
الحقول التي يجب تعديلها.
يجب تحديد حقل واحد على الأقل. إنّ الجذر
على سبيل المثال، لتعديل نمط النص بالخط الغامق، اضبط
لإعادة ضبط السمة على قيمتها التلقائية، يجب تضمين اسم الحقل في قناع الحقل مع ترك الحقل نفسه بدون ضبط. |
حقل الاتحاد
insertion_location . نوع النطاق المستخدَم في تعديل نمط النص.
يمكن أن تكون السمة insertion_location
واحدة فقط من العناصر التالية:
|
|
range
|
نطاق النص للأسلوب. يمكن توسيع النطاق ليشمل أسطر جديدة. إذا كان النطاق يحتوي بالكامل على فقرة تنتمي إلى قائمة، يتم أيضًا تعديل النقطة في الفقرة بنمط النمط المطابق. لا يمكن إدراج النطاقات داخل نوع UpdateTextStyleRequest نسبي. |
إنشاء طلب ParagraphBullets
يتم إنشاء رموز نقطية لجميع الفقرات التي تتداخل مع النطاق المحدّد.
يتم تحديد مستوى التداخل لكل فقرة من خلال حساب علامات التبويب الرئيسية أمام كل فقرة. لتجنب المسافة الزائدة بين النقطة النقطية والفقرة المقابلة، تتم إزالة علامات التبويب الرئيسية هذه عن طريق هذا الطلب. وقد يؤدي هذا إلى تغيير فهارس أجزاء النص.
إذا كانت الفقرة التي تسبق تعديل الفقرات مباشرةً في قائمة تتضمّن إعدادًا مسبقًا مطابقًا، تتم إضافة الفقرات التي يتم تعديلها إلى تلك القائمة السابقة.
تمثيل JSON |
---|
{ "range": { object ( |
الحقول | |
---|---|
range
|
النطاق المراد تطبيق الإعداد المسبق لعنصر القائمة النقطية عليه. |
bulletPreset
|
أنواع الرموز الرسومية النقطية التي سيتم استخدامها. |
BulletGlyphPreset
الأنماط المُعدَّة مسبقًا للنصوص البرمجية للقوائم.
تستخدم هذه الأنماط هذه الأنواع من التعداد النقطي:
-
ARROW
: سهم، يتوافق مع نقطة رمز يونيكود U+2794 -
ARROW3D
: سهم بتظليل ثلاثي الأبعاد، يقابل نقطة رمز يونيكود U+27a2 -
CHECKBOX
: مربّع مجوف يقابل نقطة الرمز يونيكود U+274f -
CIRCLE
: دائرة مفرغة، مقابل نقطة رمز يونيكود U+25cb -
DIAMOND
: ماسة ثابتة، مقابل نقطة رمز يونيكود U+25c6 -
DIAMONDX
: الشكل الماسي الذي يتضمّن علامة x، مطابقًا لنقطة الرمز يونيكود U+2756 -
HOLLOWDIAMOND
: ماسة مفرغة، مقابل نقطة رمز يونيكود U+25c7 -
DISC
: دائرة متصلة تقابل نقطة رمز يونيكود U+25cf -
SQUARE
: مربّع متصل يطابق نقطة الرمز يونيكود U+25a0 -
STAR
: نجمة، تتطابق مع نقطة رمز يونيكود U+2605 -
ALPHA
: حرف صغير، مثل "a" أو "b" أو "c". -
UPPERALPHA
: حرف كبير، مثل "A" أو "B" أو "C". -
DECIMAL
: رقم، مثل "1" أو "2" أو "3". -
ZERODECIMAL
: رقم يتم فيه احتساب الرقم المكوّن من رقم واحد مسبوقًا بصفر، مثل "01" أو "02" أو "03". إنّ الأرقام التي تحتوي على أكثر من رقم لا تكون مسبوقة بصفر. -
ROMAN
: رقم روماني صغير، مثل 'i' أو 'ii' أو 'iii'. -
UPPERROMAN
: رقم روماني كبير، مثل "I" أو "II" أو "III". -
LEFTTRIANGLE
: مثلث يشير إلى اليسار ويقابل نقطة رمز يونيكود U+25c4
عمليات التعداد | |
---|---|
BULLET_GLYPH_PRESET_UNSPECIFIED
|
ولم يتم تحديد الإعداد المُعدَّل للرسومات النقطية. |
BULLET_DISC_CIRCLE_SQUARE
|
قائمة نقطية تتضمّن
حرفَي DISC
وCIRCLE
وSQUARE
لأوّل 3 مستويات دمج في القائمة
|
BULLET_DIAMONDX_ARROW3D_SQUARE
|
قائمة نقطية تتضمّن
حرفَي DIAMONDX
وARROW3D
وSQUARE
لأوّل 3 مستويات دمج في القائمة
|
BULLET_CHECKBOX
|
قائمة نقطية تتضمّن
رموزًا نصية نقطية
CHECKBOX
لجميع مستويات دمج القوائم
|
BULLET_ARROW_DIAMOND_DISC
|
قائمة نقطية تتضمّن
حرفَي ARROW
وDIAMOND
وDISC
لأوّل 3 مستويات دمج في القائمة
|
BULLET_STAR_CIRCLE_SQUARE
|
قائمة نقطية تتضمّن
حرفَي STAR
وCIRCLE
وSQUARE
لأوّل 3 مستويات دمج في القائمة
|
BULLET_ARROW3D_CIRCLE_SQUARE
|
قائمة نقطية تتضمّن
حرفَي ARROW3D
وCIRCLE
وSQUARE
لأوّل 3 مستويات دمج في القائمة
|
BULLET_LEFTTRIANGLE_DIAMOND_DISC
|
قائمة نقطية تتضمّن
حرفَي LEFTTRIANGLE
وDIAMOND
وDISC
لأوّل 3 مستويات دمج في القائمة
|
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE
|
قائمة نقطية تتضمّن
حرفَي DIAMONDX
وHOLLOWDIAMOND
وSQUARE
لأوّل 3 مستويات دمج في القائمة
|
BULLET_DIAMOND_CIRCLE_SQUARE
|
قائمة نقطية تتضمّن
حرفَي DIAMOND
وCIRCLE
وSQUARE
لأوّل 3 مستويات دمج في القائمة
|
NUMBERED_DECIMAL_ALPHA_ROMAN
|
قائمة مرقّمة تتضمّن
DECIMAL و
ALPHA
وROMAN
رموز رسومية رقمية لأول 3 مستويات لدمج القائمة، متبوعةً بنقاط.
|
NUMBERED_DECIMAL_ALPHA_ROMAN_PARENS
|
قائمة مرقّمة تتضمّن
DECIMAL و
ALPHA
وROMAN
حروف رسومية رقمية لأول 3 مستويات لإدراجها متبوعة بأقواس.
|
NUMBERED_DECIMAL_NESTED
|
قائمة مرقّمة تتضمّن حروفًا أبجدية رقمية مكوّنة من DECIMAL مع الفصل بينها بنقاط، حيث يستخدم كل مستوى دمج الرمز الرسومي لمستوى التداخل السابق كبادئة. على سبيل المثال: "1." "1.1". '2.', "2.2".
|
NUMBERED_UPPERALPHA_ALPHA_ROMAN
|
قائمة مرقّمة تتضمّن
UPPERALPHA و
ALPHA
وROMAN
رموز رسومية رقمية لأول 3 مستويات لدمج القائمة، متبوعةً بنقاط.
|
NUMBERED_UPPERROMAN_UPPERALPHA_DECIMAL
|
قائمة مرقّمة تتضمّن
UPPERROMAN و
UPPERALPHA
وDECIMAL
رموز رسومية رقمية لأول 3 مستويات لدمج القائمة، متبوعةً بنقاط.
|
NUMBERED_ZERODECIMAL_ALPHA_ROMAN
|
قائمة مرقّمة تتضمّن
ZERODECIMAL و
ALPHA
وROMAN
رموز رسومية رقمية لأول 3 مستويات لدمج القائمة، متبوعةً بنقاط.
|
حذف حذفPARgraphBulletsRequest
حذف التعداد النقطي من جميع الفقرات التي تتداخل مع النطاق المحدد.
سيتم الاحتفاظ بمستوى التداخل لكل فقرة بشكل مرئي عن طريق إضافة مسافة بادئة إلى بداية الفقرة المقابلة.
تمثيل JSON |
---|
{
"range": {
object (
|
الحقول | |
---|---|
range
|
النطاق المراد حذف الرموز النقطية منه. |
CreateNamedRangeRequest (إنشاء طلب)
تنشئ السمة NamedRange
للإشارة إلى النطاق المحدّد.
تمثيل JSON |
---|
{
"name": string,
"range": {
object (
|
الحقول | |
---|---|
name
|
اسم NameNameRange. ليس بالضرورة أن تكون الأسماء فريدة. يجب أن تحتوي الأسماء على حرف واحد على الأقل ولا يزيد عن 256 حرفًا، ويتم قياسها بوحدات رموز UTF-16. |
range
|
النطاق المراد تطبيق الاسم عليه. |
حذفNameNameRangeRequest
حذف NamedRange
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد
named_range_reference . القيمة التي تحدد النطاق أو النطاقات المطلوب حذفها. ويجب ضبط معرّف واحد بالضبط.
يمكن أن تكون السمة named_range_reference
واحدة فقط من العناصر التالية:
|
|
namedRangeId
|
رقم تعريف النطاق المُعنوَن المراد حذفه |
name
|
اسم النطاقات التي سيتم حذفها سيتم حذف جميع النطاقات المُعنونة بالاسم نفسه. |
تعديل ParagraphStyleRequest
تعديل تصميم جميع الفقرات التي تتداخل مع النطاق المحدد.
تمثيل JSON |
---|
{ "paragraphStyle": { object ( |
الحقول | |
---|---|
paragraphStyle
|
الأنماط المطلوب ضبطها على الفقرات.
قد تتسبب تغييرات معينة في نمط الفقرة في إجراء تغييرات أخرى من أجل انعكاس سلوك أداة تحرير المستندات. يمكنك الاطّلاع على مستندات |
fields
|
الحقول التي يجب تعديلها.
يجب تحديد حقل واحد على الأقل. إنّ الجذر
على سبيل المثال، لتعديل سمة محاذاة نمط الفقرة، اضبط
لإعادة ضبط السمة على قيمتها التلقائية، يجب تضمين اسم الحقل في قناع الحقل مع ترك الحقل نفسه بدون ضبط. |
حقل الاتحاد
insertion_location . نوع النطاق المستخدَم حيث سيتم تعديل نمط الفقرة.
يمكن أن تكون السمة insertion_location
واحدة فقط من العناصر التالية:
|
|
range
|
النطاق الذي يتداخل مع الفقرة. |
طلب حذف المحتوى
حذف المحتوى من المستند
تمثيل JSON |
---|
{
"range": {
object (
|
الحقول | |
---|---|
range
|
نطاق المحتوى المطلوب حذفه قد يؤدي حذف النص الذي يتجاوز حدود الفقرة إلى إجراء تغييرات على أنماط الفقرة والقوائم والكائنات الموضوعة والإشارات المرجعية أثناء دمج الفقرتين. يمكن أن تؤدي محاولة حذف نطاقات معيَّنة إلى بنية مستند غير صالحة، وفي هذه الحالة سيتم عرض الخطأ "400" غير صحيح في الطلب. إليك بعض الأمثلة عن طلبات الحذف غير الصالحة:
|
طلب إدراج صورة مضمّنة
يتم إدراج InlineObject
التي تحتوي على صورة في الموقع الجغرافي المحدّد.
تمثيل JSON |
---|
{ "uri": string, "objectSize": { object ( |
الحقول | |
---|---|
uri
|
معرّف الموارد المنتظم (URI) للصورة. يتم استرجاع الصورة مرة واحدة عند إدراجها ويتم تخزين نسخة لعرضها داخل المستند. يجب أن يكون حجم الصور أقل من 50 ميغابايت، وألا تتجاوز 25 ميغابكسل، ويجب أن تكون بأحد تنسيقات PNG أو JPEG أو GIF.
يجب أن يكون الوصول إلى معرّف الموارد المنتظم (URI) المتاح للجميع متاحًا للجميع وأن يبلغ طوله 2 كيلوبايت كحد أقصى. يتم حفظ معرّف الموارد المنتظم (URI) نفسه مع الصورة، ويتم عرضه عبر الحقل
|
objectSize
|
الحجم الذي يجب أن تظهر به الصورة في المستند. هذه السمة اختيارية، ويتم تحديد الحجم النهائي للصورة في المستند من خلال القواعد التالية: * إذا لم يتم تحديد العرض أو الارتفاع، سيتم حساب الحجم التلقائي للصورة استنادًا إلى درجة دقتها. * في حال تحديد سمة واحدة، يتم احتساب السمة الأخرى للحفاظ على نسبة العرض إلى الارتفاع للصورة. * في حال تحديد كل من العرض والارتفاع، سيتم تعديل حجم الصورة لتلائم الأبعاد المتوفرة مع الحفاظ على نسبة العرض إلى الارتفاع. |
حقل الاتحاد
insertion_location . الموقع الذي سيتم إدراج الصورة فيه
يمكن أن تكون السمة insertion_location
واحدة فقط من العناصر التالية:
|
|
location
|
يتم إدراج الصورة في فهرس محدّد في المستند.
يجب إدراج الصورة داخل حدود لا يمكن إدراج الصور المضمّنة داخل حاشية سفلية أو معادلة. |
endOfSegmentLocation
|
إدراج نص في نهاية الرأس أو التذييل أو نص المستند. لا يمكن إدراج الصور المضمّنة داخل الحاشية السفلية. |
طلب الجدول
إدراج جدول في الموقع المحدّد
سيتم إدراج حرف سطر جديد قبل الجدول الذي تم إدخاله.
تمثيل JSON |
---|
{ "rows": integer, "columns": integer, // Union field |
الحقول | |
---|---|
rows
|
عدد الصفوف في الجدول. |
columns
|
عدد الأعمدة في الجدول. |
حقل الاتحاد
insertion_location . الموقع الذي سيتم إدراج الجدول فيه.
يمكن أن تكون السمة insertion_location
واحدة فقط من العناصر التالية:
|
|
location
|
إدراج الجدول في فهرس نموذج معيّن. سيتم إدراج حرف سطر جديد قبل الجدول الذي تم إدراجه، وبالتالي سيكون فهرس بدء الجدول في فهرس الموقع المحدّد + 1.
يجب إدراج الجدول داخل حدود لا يمكن إدراج الجداول داخل حاشية سفلية أو معادلة. |
endOfSegmentLocation
|
إدراج الجدول في نهاية الرأس أو التذييل أو نص المستند المحدد. سيتم إدراج حرف سطر جديد قبل الجدول الذي تم إدخاله. لا يمكن إدراج الجداول داخل حاشية سفلية. |
طلب جدولة الجدول
إدراج صف فارغ في جدول
تمثيل JSON |
---|
{
"tableCellLocation": {
object (
|
الحقول | |
---|---|
tableCellLocation
|
موقع الخلايا في الجدول المرجعي الذي سيتم إدراج الصفوف منه سيتم إدراج صف جديد أعلى (أو أدناه) الصف الذي تحتوي عليه الخلية المرجعية. إذا كانت الخلية المرجعية هي خلية مدمجة، سيتم إدراج صف جديد أعلى (أو أدناه) الخلية التي تم دمجها. |
insertBelow
|
ما إذا كان سيتم إدراج صف جديد أسفل موقع الخلية المرجعية.
|
TableCellularLocation
موقع خلية واحدة داخل جدول.
تمثيل JSON |
---|
{
"tableStartLocation": {
object (
|
الحقول | |
---|---|
tableStartLocation
|
مكان بدء الجدول في المستند. |
rowIndex
|
فهرس الصف المستند إلى الصفر. على سبيل المثال، يحتوي الصف الثاني في الجدول على فهرس للصف 1. |
columnIndex
|
فهرس العمود المستند إلى الصفر. على سبيل المثال، يحتوي العمود الثاني في الجدول على فهرس للعمود 1. |
طلب عمود الجدول
إدراج عمود فارغ في الجدول
تمثيل JSON |
---|
{
"tableCellLocation": {
object (
|
الحقول | |
---|---|
tableCellLocation
|
موقع الخلايا في الجدول المرجعي الذي سيتم إدراج الأعمدة منه سيتم إدراج عمود جديد على يسار (أو يمين) العمود الذي تتوفّر فيه الخلية المرجعية. إذا كانت الخلية المرجعية هي خلية مدمَجة، سيتم إدراج عمود جديد على يسار الخلية (أو على يمينها). |
insertRight
|
ما إذا كان سيتم إدراج عمود جديد على يسار موقع الخلية المرجعية.
|
حذفطلب الجدول
لحذف صف من الجدول.
تمثيل JSON |
---|
{
"tableCellLocation": {
object (
|
الحقول | |
---|---|
tableCellLocation
|
موقع الخلية في الجدول المرجعي الذي سيتم حذف الصف منه سيتم حذف الصف الذي تمتد فيه هذه الخلية. إذا كانت هذه الخلية مدمجة وتمتد إلى عدة صفوف، سيتم حذف جميع الصفوف التي تمتد إليها الخلايا. إذا لم تتبقَ أي صفوف في الجدول بعد هذا الحذف، سيتم حذف الجدول بأكمله. |
طلب حذف جدول الجدول
حذف عمود من الجدول
تمثيل JSON |
---|
{
"tableCellLocation": {
object (
|
الحقول | |
---|---|
tableCellLocation
|
موقع الخلية في الجدول المرجعي الذي سيتم حذف العمود منه سيتم حذف العمود الذي تمتده هذه الخلية. إذا كانت هذه الخلية مدمجة وتمتد إلى أعمدة متعددة، سيتم حذف جميع الأعمدة التي تمتد إليها الخلايا. إذا لم تتبق أي أعمدة في الجدول بعد هذا الحذف، سيتم حذف الجدول بأكمله. |
طلب صفحة Break
إدراج فاصل صفحة متبوعًا بسطر جديد في الموقع المحدّد.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد
insertion_location . سيتم إدراج فاصل الصفحات.
يمكن أن تكون السمة insertion_location
واحدة فقط من العناصر التالية:
|
|
location
|
إدراج فاصل صفحة في فهرس معين في المستند.
يجب إدراج فاصل الصفحة داخل حدود
لا يمكن إدراج فواصل صفحات داخل جدول أو معادلة أو حاشية سفلية أو رأس أو تذييل. بما أنّه لا يمكن إدراج فواصل الصفحات إلا داخل النص، يجب أن يكون الحقل
|
endOfSegmentLocation
|
إدراج فاصل صفحة في نهاية نص المستند
لا يمكن إدراج فواصل صفحات داخل حاشية سفلية أو رأس أو تذييل. بما أنّه لا يمكن إدراج فواصل الصفحات إلا داخل النص، يجب أن يكون الحقل
|
DeletePositionedObjectRequest
يؤدي هذا الإجراء إلى حذف PositionedObject
من المستند.
تمثيل JSON |
---|
{ "objectId": string } |
الحقول | |
---|---|
objectId
|
رقم تعريف العنصر الذي سيتم حذفه |
طلب تعديل جدول الأعمدة
يتم تعديل
TableColumnProperties
من الأعمدة في الجدول.
تمثيل JSON |
---|
{ "tableStartLocation": { object ( |
الحقول | |
---|---|
tableStartLocation
|
مكان بدء الجدول في المستند. |
columnIndices[]
|
قائمة فهارس الأعمدة المستندة إلى الصفر والتي يجب تحديث موقعها. في حال عدم تحديد أي فهارس، سيتم تعديل جميع الأعمدة. |
tableColumnProperties
|
خصائص عمود الجدول المطلوب تعديلها.
إذا كانت قيمة
|
fields
|
الحقول التي يجب تعديلها.
يجب تحديد حقل واحد على الأقل. إنّ الجذر
على سبيل المثال، لتعديل عرض العمود، اضبط
|
تعديلجدول الجدول الخلوي
يعدِّل نمط نطاق من خلايا الجدول.
تمثيل JSON |
---|
{ "tableCellStyle": { object ( |
الحقول | |
---|---|
tableCellStyle
|
النمط المطلوب إعداده في خلايا الجدول. عند تعديل الحدود، إذا شاركت خلية حدودًا مع خلية مجاورة، سيتم تعديل خاصية الحدود المقابلة للخلية المجاورة أيضًا. لا يتم تعديل الحدود المدمجة وغير المرئية. بما أنّ تعديل الحدود المشترَكة بواسطة خلايا مجاورة في الطلب نفسه قد يؤدي إلى تعارضات بشأن حدود الحدود، يتم تطبيق تعديلات الحدود بالترتيب التالي:
|
fields
|
الحقول التي يجب تعديلها.
يجب تحديد حقل واحد على الأقل. إنّ الجذر
على سبيل المثال، لتعديل لون خلفية الخلية في الجدول، اضبط لإعادة ضبط السمة على قيمتها التلقائية، يجب تضمين اسم الحقل في قناع الحقل مع ترك الحقل نفسه بدون ضبط. |
حقل الاتحاد
cells . الخلايا التي سيتم تعديلها.
يمكن أن تكون السمة cells
واحدة فقط من العناصر التالية:
|
|
tableRange
|
نطاق الجدول الذي يمثّل المجموعة الفرعية من الجدول التي يتم تطبيق التعديلات عليها. |
tableStartLocation
|
مكان بدء الجدول في المستند. عند التحديد، يتم تطبيق التحديثات على جميع الخلايا في الجدول. |
نطاق الجدول
يمثّل نطاق الجدول مرجعًا إلى مجموعة فرعية من الجدول.
من المهم ملاحظة أن الخلايا المحددة بنطاق النطاق لا تمثل بالضرورة مستطيلاً. على سبيل المثال، لنفترض أن لدينا جدولاً بحجم 3 × 3 حيث يتم دمج كل خلايا الصف الأخير معًا. يبدو الجدول كما يلي:
[ ][ ][ ]
[ ][ ][ ]
[ ]
نطاق الجدول الذي يحتوي على موقع خلية في الجدول = (tableStartLocation، الصف = 0، العمود = 0)، نطاق الصف = 3 والنطاق البالغ العمود = 2 يحدِّد الخلايا التالية:
[ x ][ x ][ ]
[ x ][ x ][ ]
[ x x x ]
تمثيل JSON |
---|
{
"tableCellLocation": {
object (
|
الحقول | |
---|---|
tableCellLocation
|
موقع الخلية الذي يبدأ فيه نطاق الجدول. |
rowSpan
|
نطاق الصف لنطاق الجدول. |
columnSpan
|
نطاق العمود لنطاق الجدول. |
تحديث TableTableStyleStyle
يتم تعديل
TableRowStyle
من الصفوف في الجدول.
تمثيل JSON |
---|
{ "tableStartLocation": { object ( |
الحقول | |
---|---|
tableStartLocation
|
مكان بدء الجدول في المستند. |
rowIndices[]
|
قائمة فهارس الصفوف المستندة إلى الصفر والتي يجب تعديل نمطها. في حال عدم تحديد أي فهارس، سيتم تعديل جميع الصفوف. |
tableRowStyle
|
الأنماط التي سيتم ضبطها على الصفوف |
fields
|
الحقول التي يجب تعديلها.
يجب تحديد حقل واحد على الأقل. إنّ الجذر
على سبيل المثال، لتعديل الحد الأدنى لارتفاع الصف، اضبط
|
استبدال صورة
تستبدل صورة حالية بصورة جديدة.
يؤدي استبدال صورة إلى إزالة جزء
image effects
من الصورة الحالية لإظهار السلوك نفسه في "أدوات تحرير المستندات".
تمثيل JSON |
---|
{
"imageObjectId": string,
"uri": string,
"imageReplaceMethod": enum (
|
الحقول | |
---|---|
imageObjectId
|
رقم تعريف الصورة الحالية التي سيتم استبدالها يمكن استرداد المعرّف من ردّ على طلب الحصول على الإذن. |
uri
|
معرّف الموارد المنتظم (URI) للصورة الجديدة. يتم استرجاع الصورة مرة واحدة عند إدراجها ويتم تخزين نسخة لعرضها داخل المستند. يجب أن تكون الصور أقل من 50 ميغابايت، وألا تتجاوز 25 ميغابكسل، ويجب أن تكون بتنسيق PNG أو JPEG أو GIF.
لا يمكن أن يتجاوز طول معرّف الموارد المنتظم (URI) المقدّر 2 كيلوبايت. يتم حفظ معرّف الموارد المنتظم (URI) مع الصورة، ويتم عرضه من خلال الحقل
|
imageReplaceMethod
|
طريقة الاستبدال. |
طريقة استبدال الصورة
طريقة استبدال الصورة.
عمليات التعداد | |
---|---|
IMAGE_REPLACE_METHOD_UNSPECIFIED
|
طريقة استبدال الصور غير محدّدة يجب عدم استخدام هذه القيمة. |
CENTER_CROP
|
تحجيم الصورة وتوسيطها لملء حدود الصورة الأصلية. يمكن اقتصاص الصورة لملء حدود الصورة الأصلية. سيكون حجم الصورة المعروض هو نفسه حجم الصورة الأصلية. |
تعديل نمط المستند
يتم تعديل
DocumentStyle
.
تمثيل JSON |
---|
{
"documentStyle": {
object (
|
الحقول | |
---|---|
documentStyle
|
الأنماط المطلوب ضبطها على المستند.
قد تؤدي تغييرات معينة في نمط المستند إلى تغييرات أخرى من أجل انعكاس سلوك أداة تحرير المستندات. يمكنك الاطّلاع على مستندات |
fields
|
الحقول التي يجب تعديلها.
يجب تحديد حقل واحد على الأقل. إنّ الجذر
على سبيل المثال، لتعديل الخلفية، يجب ضبط |
طلب دمج خلايا الجدول
يدمج الخلايا في Table
.
تمثيل JSON |
---|
{
"tableRange": {
object (
|
الحقول | |
---|---|
tableRange
|
نطاق الجدول الذي يحدد الخلايا التي سيتم دمجها في الجدول. سيتم ربط أي نص في الخلايا التي يتم دمجها وتخزينها في خلية "الرأس" للنطاق. هذه هي الخلية العلوية اليسرى من النطاق عندما يكون اتجاه المحتوى من اليسار إلى اليمين والخلية العلوية اليمنى من النطاق. إذا كان النطاق غير مستطيل (وقد يحدث في بعض الحالات إذا كان النطاق يغطي الخلايا التي تم دمجها من قبل أو إذا كان الجدول غير مستطيل)، سيتم عرض الخطأ "400" غير صحيح في الطلب. |
إلغاء دمج خلايا الجدول
يتم إلغاء دمج الخلايا في
Table
.
تمثيل JSON |
---|
{
"tableRange": {
object (
|
الحقول | |
---|---|
tableRange
|
نطاق الجدول الذي يحدد خلايا الجدول التي سيتم إلغاء دمجها. سيتم إلغاء دمج كل الخلايا التي تم دمجها في هذا النطاق، ولن تتأثر الخلايا التي لم يتم إلغاء دمجها من قبل. إذا لم يحتوي النطاق على خلايا مدمَجة، لن تنفيذ أي إجراء. إذا كان هناك نص في أي من الخلايا المدمجة، سيظل النص في خلية "الرأس" للكتلة الناتجة من الخلايا غير المدمجة. تكون خلية "head" هي الخلية العليا اليسرى عندما يكون اتجاه المحتوى من اليسار إلى اليمين والعكس أعلى. |
طلب العنوان
تنشئ السمة Header
. يتم تطبيق الرأس الجديد على
SectionStyle
في موقع
SectionBreak
إذا تم تحديده، أو يتم تطبيقه على
DocumentStyle
.
إذا كان هناك عنوان من النوع المحدّد، سيظهر خطأ طلب غير صحيح 400.
تمثيل JSON |
---|
{ "type": enum ( |
الحقول | |
---|---|
type
|
نوع العنوان المطلوب إنشاؤه. |
sectionBreakLocation
|
تمثّل هذه السمة موقع
|
طلب إنشاء طلب
يتم إنشاء
شريحة Footnote
وإدراج
FootnoteReference
جديدة فيها في الموقع الجغرافي المحدّد.
ستتضمّن الشريحة الجديدة Footnote
مسافة متبوعة بحرف سطر جديد.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد
footnote_reference_location . الموقع المراد إدراج إشارة الحاشية السفلية عليه
يمكن أن تكون السمة footnote_reference_location
واحدة فقط من العناصر التالية:
|
|
location
|
إدراج مرجع الحاشية السفلية في فهرس معيّن في المستند.
يجب إدراج مرجع الحاشية السفلية داخل حدود
لا يمكن إدراج مراجع الحواشي السفلية داخل معادلة أو عنوان أو تذييل أو حاشية سفلية. بما أنّه يمكن إدراج مراجع الحاشية السفلية في النص فقط، يجب أن يكون الحقل |
endOfSegmentLocation
|
إدراج مرجع الحاشية السفلية في نهاية نص المستند
لا يمكن إدراج مراجع الحاشية السفلية في رأس أو تذييل أو حاشية سفلية. بما أنّه يمكن إدراج مراجع الحاشية السفلية في النص فقط، يجب أن يكون الحقل |
الاستبدالNameDRangeContentRequest
تستبدل محتوى NamedRange
المحدّد أو NamedRanges
بالمحتوى البديل المحدد.
يُرجى العِلم بأنّ الفرد
NamedRange
قد يتألّف من عدة
ranges
منفصلة. وفي هذه الحالة، سيتم استبدال المحتوى في النطاق الأول فقط. سيتم حذف النطاقات الأخرى ومحتواها.
في الحالات التي يؤدي فيها استبدال أي نطاقات أو حذفها إلى بنية مستند غير صالحة، يتم عرض خطأ 400 غير صحيح في الطلب.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد
replacement_content . المحتوى المراد استبدال المحتوى الحالي بالنطاق المُسمّى به
يمكن أن تكون السمة replacement_content
واحدة فقط من العناصر التالية:
|
|
text
|
استبدال محتوى النطاقات المُسمّاة المحددة بالنص المحدد. |
حقل الاتحاد
named_range_reference . مرجع للنطاقات التي سيتم استبدال المحتوى الخاص بها
يمكن أن تكون السمة named_range_reference
واحدة فقط من العناصر التالية:
|
|
namedRangeId
|
رقم تعريف النطاق المُعنوَن الذي سيتم استبدال المحتوى الخاص به إذا لم يكن هناك نطاق مُعنوَن يحمل المعرّف المحدّد، سيظهر خطأ طلب غير صحيح 400. |
namedRangeName
|
اسم
إذا كان هناك عدّة |
طلب تعديل القسم
يتم تعديل
SectionStyle
.
تمثيل JSON |
---|
{ "range": { object ( |
الحقول | |
---|---|
range
|
النطاق المتداخل مع النمط.
بما أنّه لا يمكن إدراج فواصل الأقسام إلا داخل النص، يجب أن يكون الحقل
|
sectionStyle
|
الأنماط التي يتم ضبطها في القسم.
قد تتسبب تغييرات معينة في نمط القسم في إجراء تغييرات أخرى من أجل انعكاس سلوك أداة تحرير المستندات. يمكنك الاطّلاع على مستندات |
fields
|
الحقول التي يجب تعديلها.
يجب تحديد حقل واحد على الأقل. إنّ الجذر
على سبيل المثال، لتعديل الهامش الأيسر، اضبط
|
طلب إضافة القسم Break
إدراج فاصل أقسام في الموقع المحدّد
سيتم إدراج حرف جديد قبل فاصل الأقسام.
تمثيل JSON |
---|
{ "sectionType": enum ( |
الحقول | |
---|---|
sectionType
|
نوع القسم المطلوب إدراجه. |
حقل الاتحاد
insertion_location . الموقع الذي سيتم إدراج الفاصل به.
يمكن أن تكون السمة insertion_location
واحدة فقط من العناصر التالية:
|
|
location
|
إدراج سطر جديد وفاصل أقسام في فهرس محدد في المستند.
يجب إدراج فاصل أقسام داخل حدود
لا يمكن إدراج فواصل أقسام داخل جدول أو معادلة أو حاشية سفلية أو رأس أو تذييل. بما أنّه يمكن إدراج فواصل الأقسام داخل النص فقط، يجب أن يكون الحقل
|
endOfSegmentLocation
|
إدراج سطر جديد وفاصل أقسام في نهاية نص المستند
لا يمكن إدراج فواصل أقسام داخل حاشية سفلية أو رأس أو تذييل. بما أنّه لا يمكن إدراج فواصل الأقسام إلا داخل النص، يجب أن يكون الحقل
|
طلب حذف العنوان
يؤدي هذا الإجراء إلى حذف Header
من المستند.
تمثيل JSON |
---|
{ "headerId": string } |
الحقول | |
---|---|
headerId
|
رقم تعريف العنوان المطلوب حذفه إذا تم تحديد هذا العنوان في |
طلب.
يعدِّل عدد صفوف العناوين في الجدول المثبَّت في جدول.
تمثيل JSON |
---|
{
"tableStartLocation": {
object (
|
الحقول | |
---|---|
tableStartLocation
|
مكان بدء الجدول في المستند. |
pinnedHeaderRowsCount
|
عدد صفوف الجدول التي سيتم تثبيتها، حيث يشير 0 إلى إلغاء تثبيت جميع الصفوف. |