Requests

طلب

نوع واحد من التعديلات التي يمكن تطبيقها على عرض تقديمي

تمثيل JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "createSlide": {
    object (CreateSlideRequest)
  },
  "createShape": {
    object (CreateShapeRequest)
  },
  "createTable": {
    object (CreateTableRequest)
  },
  "insertText": {
    object (InsertTextRequest)
  },
  "insertTableRows": {
    object (InsertTableRowsRequest)
  },
  "insertTableColumns": {
    object (InsertTableColumnsRequest)
  },
  "deleteTableRow": {
    object (DeleteTableRowRequest)
  },
  "deleteTableColumn": {
    object (DeleteTableColumnRequest)
  },
  "replaceAllText": {
    object (ReplaceAllTextRequest)
  },
  "deleteObject": {
    object (DeleteObjectRequest)
  },
  "updatePageElementTransform": {
    object (UpdatePageElementTransformRequest)
  },
  "updateSlidesPosition": {
    object (UpdateSlidesPositionRequest)
  },
  "deleteText": {
    object (DeleteTextRequest)
  },
  "createImage": {
    object (CreateImageRequest)
  },
  "createVideo": {
    object (CreateVideoRequest)
  },
  "createSheetsChart": {
    object (CreateSheetsChartRequest)
  },
  "createLine": {
    object (CreateLineRequest)
  },
  "refreshSheetsChart": {
    object (RefreshSheetsChartRequest)
  },
  "updateShapeProperties": {
    object (UpdateShapePropertiesRequest)
  },
  "updateImageProperties": {
    object (UpdateImagePropertiesRequest)
  },
  "updateVideoProperties": {
    object (UpdateVideoPropertiesRequest)
  },
  "updatePageProperties": {
    object (UpdatePagePropertiesRequest)
  },
  "updateTableCellProperties": {
    object (UpdateTableCellPropertiesRequest)
  },
  "updateLineProperties": {
    object (UpdateLinePropertiesRequest)
  },
  "createParagraphBullets": {
    object (CreateParagraphBulletsRequest)
  },
  "replaceAllShapesWithImage": {
    object (ReplaceAllShapesWithImageRequest)
  },
  "duplicateObject": {
    object (DuplicateObjectRequest)
  },
  "updateTextStyle": {
    object (UpdateTextStyleRequest)
  },
  "replaceAllShapesWithSheetsChart": {
    object (ReplaceAllShapesWithSheetsChartRequest)
  },
  "deleteParagraphBullets": {
    object (DeleteParagraphBulletsRequest)
  },
  "updateParagraphStyle": {
    object (UpdateParagraphStyleRequest)
  },
  "updateTableBorderProperties": {
    object (UpdateTableBorderPropertiesRequest)
  },
  "updateTableColumnProperties": {
    object (UpdateTableColumnPropertiesRequest)
  },
  "updateTableRowProperties": {
    object (UpdateTableRowPropertiesRequest)
  },
  "mergeTableCells": {
    object (MergeTableCellsRequest)
  },
  "unmergeTableCells": {
    object (UnmergeTableCellsRequest)
  },
  "groupObjects": {
    object (GroupObjectsRequest)
  },
  "ungroupObjects": {
    object (UngroupObjectsRequest)
  },
  "updatePageElementAltText": {
    object (UpdatePageElementAltTextRequest)
  },
  "replaceImage": {
    object (ReplaceImageRequest)
  },
  "updateSlideProperties": {
    object (UpdateSlidePropertiesRequest)
  },
  "updatePageElementsZOrder": {
    object (UpdatePageElementsZOrderRequest)
  },
  "updateLineCategory": {
    object (UpdateLineCategoryRequest)
  },
  "rerouteLine": {
    object (RerouteLineRequest)
  },
  "insertComment": {
    object (InsertCommentRequest)
  },
  "addCommentReply": {
    object (AddCommentReplyRequest)
  },
  "updateCommentPost": {
    object (UpdateCommentPostRequest)
  },
  "deleteComment": {
    object (DeleteCommentRequest)
  },
  "deleteCommentReply": {
    object (DeleteCommentReplyRequest)
  }
  // End of mutually exclusive fields.
}
الحقول
نوع التعديل. يجب ملء حقل واحد بالضبط. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الردّ:
createSlide

object (CreateSlideRequest)

لإنشاء شريحة جديدة

createShape

object (CreateShapeRequest)

لإنشاء شكل جديد

createTable

object (CreateTableRequest)

تنشئ هذه الدالة جدولاً جديدًا.

insertText

object (InsertTextRequest)

تُدرِج هذه الدالة نصًا في شكل أو خلية جدول.

insertTableRows

object (InsertTableRowsRequest)

تُدرِج هذه الدالة صفوفًا في جدول.

insertTableColumns

object (InsertTableColumnsRequest)

تُدرِج هذه الدالة أعمدة في جدول.

deleteTableRow

object (DeleteTableRowRequest)

تحذف هذه الطريقة صفًا من جدول.

deleteTableColumn

object (DeleteTableColumnRequest)

تحذف هذه الطريقة عمودًا من جدول.

replaceAllText

object (ReplaceAllTextRequest)

يستبدل جميع مثيلات النص المحدّد.

deleteObject

object (DeleteObjectRequest)

يحذف صفحة أو عنصر صفحة من العرض التقديمي.

updatePageElementTransform

object (UpdatePageElementTransformRequest)

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

updateSlidesPosition

object (UpdateSlidesPositionRequest)

تعدّل هذه الطريقة موضع مجموعة من الشرائح في العرض التقديمي.

deleteText

object (DeleteTextRequest)

يحذف هذا الإجراء النص من شكل أو خلية جدول.

createImage

object (CreateImageRequest)

تنشئ هذه الدالة صورة.

createVideo

object (CreateVideoRequest)

تنشئ هذه الطريقة فيديو.

createSheetsChart

object (CreateSheetsChartRequest)

تُنشئ هذه الدالة رسمًا بيانيًا مضمّنًا في "جداول بيانات Google".

createLine

object (CreateLineRequest)

تُنشئ هذه السمة خطًا.

refreshSheetsChart

object (RefreshSheetsChartRequest)

تعمل هذه الدالة على إعادة تحميل رسم بياني في "جداول بيانات Google".

updateShapeProperties

object (UpdateShapePropertiesRequest)

تعدّل هذه الطريقة خصائص Shape.

updateImageProperties

object (UpdateImagePropertiesRequest)

تعدّل هذه الطريقة خصائص Image.

updateVideoProperties

object (UpdateVideoPropertiesRequest)

تعدّل هذه الطريقة خصائص Video.

updatePageProperties

object (UpdatePagePropertiesRequest)

تعدّل هذه الطريقة خصائص Page.

updateTableCellProperties

object (UpdateTableCellPropertiesRequest)

تعدّل هذه الطريقة خصائص TableCell.

updateLineProperties

object (UpdateLinePropertiesRequest)

تعدّل هذه الطريقة خصائص Line.

createParagraphBullets

object (CreateParagraphBulletsRequest)

تنشئ هذه الدالة نقاطًا تعدادية للفقرات.

replaceAllShapesWithImage

object (ReplaceAllShapesWithImageRequest)

يستبدل جميع الأشكال التي تستوفي بعض المعايير بصورة.

duplicateObject

object (DuplicateObjectRequest)

تكرار شريحة أو عنصر صفحة

updateTextStyle

object (UpdateTextStyleRequest)

تعدّل هذه السمة نمط النص ضمن Shape أو Table.

replaceAllShapesWithSheetsChart

object (ReplaceAllShapesWithSheetsChartRequest)

يستبدل جميع الأشكال التي تطابق بعض المعايير برسم بياني في "جداول بيانات Google".

deleteParagraphBullets

object (DeleteParagraphBulletsRequest)

يحذف الرموز النقطية من الفقرات.

updateParagraphStyle

object (UpdateParagraphStyleRequest)

تعدّل هذه السمة تنسيق الفقرات ضمن Shape أو Table.

updateTableBorderProperties

object (UpdateTableBorderPropertiesRequest)

تعدّل هذه السمة خصائص حدود الجدول في Table.

updateTableColumnProperties

object (UpdateTableColumnPropertiesRequest)

تعدّل هذه الطريقة خصائص عمود Table.

updateTableRowProperties

object (UpdateTableRowPropertiesRequest)

تعدّل هذه الطريقة خصائص صف Table.

mergeTableCells

object (MergeTableCellsRequest)

يدمج الخلايا في Table.

unmergeTableCells

object (UnmergeTableCellsRequest)

يلغي دمج الخلايا في Table.

groupObjects

object (GroupObjectsRequest)

تجميع العناصر، مثل عناصر الصفحة

ungroupObjects

object (UngroupObjectsRequest)

لإلغاء تجميع العناصر، مثل groups.

updatePageElementAltText

object (UpdatePageElementAltTextRequest)

تعدّل هذه الطريقة عنوان و/أو وصف النص البديل الخاص بـ page element.

replaceImage

object (ReplaceImageRequest)

تستبدل هذه الطريقة صورة حالية بصورة جديدة.

updateSlideProperties

object (UpdateSlidePropertiesRequest)

تعديل خصائص شريحة

updatePageElementsZOrder

object (UpdatePageElementsZOrderRequest)

تعدّل هذه السمة ترتيب Z الخاص بـ page elements.

updateLineCategory

object (UpdateLineCategoryRequest)

تعدّل هذه الطريقة فئة line.

rerouteLine

object (RerouteLineRequest)

تعيد توجيه line بحيث تكون مرتبطة بموقعَي الربط الأقرب على عناصر الصفحة المرتبطة.

insertComment

object (InsertCommentRequest)

تُدرج هذه الدالة CommentThread في العرض التقديمي.

addCommentReply

object (AddCommentReplyRequest)

تضيف هذه الطريقة ردًا على CommentThread.

updateCommentPost

object (UpdateCommentPostRequest)

تعديل مشاركة حالية (مشاركة رئيسية أو ردّ) ضمن CommentThread

deleteComment

object (DeleteCommentRequest)

يحذف CommentThread.

deleteCommentReply

object (DeleteCommentReplyRequest)

يحذف هذا الإجراء ردًا Post من CommentThread.

نهاية الحقول التي يستبعد كلّ منها الآخر

CreateSlideRequest

تُنشئ هذه الدالة شريحة.

تمثيل JSON 
{
  "objectId": string,
  "insertionIndex": integer,
  "slideLayoutReference": {
    object (LayoutReference)
  },
  "placeholderIdMappings": [
    {
      object (LayoutPlaceholderIdMapping)
    }
  ]
}
الحقول
objectId

string

معرّف عنصر يقدّمه المستخدم

إذا حدّدت معرّفًا، يجب أن يكون فريدًا بين جميع الصفحات وعناصر الصفحات في العرض التقديمي. يجب أن يبدأ المعرّف بحرف أبجدي رقمي أو شرطة سفلية (يتطابق مع التعبير العادي [a-zA-Z0-9_])، ويمكن أن تتضمّن الأحرف المتبقية تلك الأحرف بالإضافة إلى شرطة أو نقطتين (تتطابق مع التعبير العادي [a-zA-Z0-9_-:]). يجب أن يتراوح طول المعرّف بين 5 و50 حرفًا، بما في ذلك الحدّين.

إذا لم تحدّد معرّفًا، سيتم إنشاء معرّف فريد.

insertionIndex

integer

الفهرس الاختياري الذي يبدأ من 0 والذي يشير إلى مكان إدراج الشرائح.

إذا لم تحدّد فهرسًا، سيتم إنشاء الشريحة في النهاية.

slideLayoutReference

object (LayoutReference)

مرجع التنسيق الخاص بالشريحة التي سيتم إدراجها، استنادًا إلى الشريحة الرئيسية الحالية، وهو أحد الخيارات التالية:

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

إذا لم يتم العثور على LayoutReference في التصميم الرئيسي الحالي، سيتم عرض رسالة الخطأ 400 Bad Request.

إذا لم تحدّد مرجع تنسيق، ستستخدم الشريحة التنسيق BLANK المحدّد مسبقًا.

placeholderIdMappings[]

object (LayoutPlaceholderIdMapping)

قائمة اختيارية لعمليات ربط معرّفات الكائنات من placeholder (s) في التصميم بالعناصر النائبة التي يتم إنشاؤها في الشريحة من التصميم المحدّد يمكن استخدامها فقط عند تحديد slideLayoutReference.

LayoutReference

مرجع تنسيق الشرائح قد يشير ذلك إلى أحد الخيارين التاليين:

  • تنسيق محدّد مسبقًا
  • أحد التنسيقات في العرض التقديمي
تمثيل JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "predefinedLayout": enum (PredefinedLayout),
  "layoutId": string
  // End of mutually exclusive fields.
}
الحقول
تمثّل هذه السمة نوع LayoutReference. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الردّ:
predefinedLayout

enum (PredefinedLayout)

تنسيق مُحدَّد مسبقًا

layoutId

string

معرّف التصميم: معرّف العنصر لأحد التصاميم في العرض التقديمي

نهاية الحقول التي يستبعد كلّ منها الآخر

PredefinedLayout

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

عمليات التعداد
PREDEFINED_LAYOUT_UNSPECIFIED تخطيط غير محدّد
BLANK تنسيق فارغ بدون عناصر نائبة
CAPTION_ONLY تنسيق مع شرح في أسفل الصفحة
TITLE تنسيق يتضمّن عنوانًا وعنوانًا فرعيًا
TITLE_AND_BODY تنسيق يتضمّن عنوانًا ونصًا
TITLE_AND_TWO_COLUMNS تخطيط يتضمّن عنوانًا وعمودَين
TITLE_ONLY تنسيق يتضمّن عنوانًا فقط
SECTION_HEADER تنسيق يتضمّن عنوان قسم
SECTION_TITLE_AND_DESCRIPTION تنسيق يتضمّن عنوانًا وعنوانًا فرعيًا على أحد الجانبين ووصفًا على الجانب الآخر
ONE_COLUMN_TEXT تنسيق يتضمّن عنوانًا واحدًا ونصًا واحدًا، ويتم ترتيبهما في عمود واحد.
MAIN_POINT تنسيق يتضمّن نقطة رئيسية
BIG_NUMBER تنسيق يتضمّن عنوانًا كبيرًا

LayoutPlaceholderIdMapping

عملية ربط المعرّف التي يحدّدها المستخدم لعنصر نائب سيتم إنشاؤه على شريحة من تخطيط محدّد

تمثيل JSON 
{
  "objectId": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "layoutPlaceholder": {
    object (Placeholder)
  },
  "layoutPlaceholderObjectId": string
  // End of mutually exclusive fields.
}
الحقول
objectId

string

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

إذا حدّدت معرّفًا، يجب أن يكون فريدًا بين جميع الصفحات وعناصر الصفحات في العرض التقديمي. يجب أن يبدأ المعرّف بحرف أبجدي رقمي أو شرطة سفلية (يتطابق مع التعبير العادي [a-zA-Z0-9_])، ويمكن أن تتضمّن الأحرف المتبقية هذه الأحرف بالإضافة إلى شرطة واصلة أو نقطتين رأسيتين (يتطابق مع التعبير العادي [a-zA-Z0-9_-:])، ويجب ألا يقل طول المعرّف عن 5 أحرف أو يزيد عن 50 حرفًا.

إذا لم تحدّد معرّفًا، سيتم إنشاء معرّف فريد.

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

object (Placeholder)

العنصر النائب في تخطيط سيتم تطبيقه على شريحة يجب توفير type وindex فقط. على سبيل المثال، قد يحتوي تنسيق TITLE_AND_BODY محدّد مسبقًا عادةً على عنصر نائب TITLE يحمل الفهرس 0 وعنصر نائب BODY يحمل الفهرس 0.

layoutPlaceholderObjectId

string

رقم تعريف العنصر النائب في تخطيط سيتم تطبيقه على شريحة

نهاية الحقول التي يستبعد كلّ منها الآخر

CreateShapeRequest

لإنشاء شكل جديد

تمثيل JSON 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "shapeType": enum (Type)
}
الحقول
objectId

string

معرّف عنصر يقدّمه المستخدم

إذا حدّدت معرّفًا، يجب أن يكون فريدًا بين جميع الصفحات وعناصر الصفحات في العرض التقديمي. يجب أن يبدأ المعرّف بحرف أبجدي رقمي أو شرطة سفلية (يتطابق مع التعبير العادي [a-zA-Z0-9_])، ويمكن أن تتضمّن الأحرف المتبقية هذه الأحرف بالإضافة إلى شرطة واصلة أو نقطتين رأسيتين (يتطابق مع التعبير العادي [a-zA-Z0-9_-:])، ويجب ألا يقل طول المعرّف عن 5 أحرف أو يزيد عن 50 حرفًا. إذا كان الحقل فارغًا، سيتم إنشاء معرّف فريد.

elementProperties

object (PageElementProperties)

خصائص العنصر للشكل

shapeType

enum (Type)

نوع الشكل.

PageElementProperties

السمات الشائعة لعنصر صفحة

ملاحظة: عند إنشاء PageElement في البداية، قد تعدّل واجهة برمجة التطبيقات قيمتَي size و transform، ولكن سيظل الحجم المرئي بدون تغيير.

تمثيل JSON 
{
  "pageObjectId": string,
  "size": {
    object (Size)
  },
  "transform": {
    object (AffineTransform)
  }
}
الحقول
pageObjectId

string

تمثّل هذه السمة معرّف العنصر للصفحة التي يظهر فيها العنصر.

size

object (Size)

حجم العنصر

transform

object (AffineTransform)

تمثّل هذه السمة عملية التحويل للعنصر.

CreateTableRequest

تنشئ هذه الدالة جدولاً جديدًا.

تمثيل JSON 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "rows": integer,
  "columns": integer
}
الحقول
objectId

string

معرّف عنصر يقدّمه المستخدم

إذا حدّدت معرّفًا، يجب أن يكون فريدًا بين جميع الصفحات وعناصر الصفحات في العرض التقديمي. يجب أن يبدأ المعرّف بحرف أبجدي رقمي أو شرطة سفلية (يتطابق مع التعبير العادي [a-zA-Z0-9_])، ويمكن أن تتضمّن الأحرف المتبقية هذه الأحرف بالإضافة إلى شرطة واصلة أو نقطتين رأسيتين (يتطابق مع التعبير العادي [a-zA-Z0-9_-:])، ويجب ألا يقل طول المعرّف عن 5 أحرف أو يزيد عن 50 حرفًا.

إذا لم تحدّد معرّفًا، سيتم إنشاء معرّف فريد.

elementProperties

object (PageElementProperties)

خصائص العنصر للجدول

سيتم إنشاء الجدول بالحجم المقدَّم، مع مراعاة الحد الأدنى للحجم. في حال عدم توفير حجم، سيتم تحديد حجم الجدول تلقائيًا.

يجب أن تكون عمليات تحويل الجدول بمقياس 1 وألا تتضمّن أي عناصر قص. في حال عدم توفير أي عملية تحويل، سيتم توسيط الجدول في الصفحة.

rows

integer

عدد الصفوف في الجدول

columns

integer

عدد الأعمدة في الجدول

InsertTextRequest

تُدرِج هذه الدالة نصًا في شكل أو خلية جدول.

تمثيل JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "text": string,
  "insertionIndex": integer
}
الحقول
objectId

string

رقم تعريف العنصر للشكل أو الجدول الذي سيتم إدراج النص فيه

cellLocation

object (TableCellLocation)

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

text

string

النص المطلوب إدراجه

سيؤدي إدراج حرف سطر جديد ضمنيًا إلى إنشاء ParagraphMarker جديد في هذا الفهرس. سيتم نسخ نمط الفقرة الجديدة من الفقرة في فهرس الإدراج الحالي، بما في ذلك القوائم والنقاط.

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

سيتم إزالة بعض أحرف التحكّم (U+0000-U+0008 وU+000C-U+001F) والأحرف من "منطقة الاستخدام الخاص" في "الخطة الأساسية المتعددة اللغات" من Unicode (U+E000-U+F8FF) من النص المُدرَج.

insertionIndex

integer

الفهرس الذي سيتم إدراج النص فيه، بوحدات رمز Unicode، استنادًا إلى فهارس TextElement.

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

InsertTableRowsRequest

تُدرِج هذه الدالة صفوفًا في جدول.

تمثيل JSON 
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "insertBelow": boolean,
  "number": integer
}
الحقول
tableObjectId

string

الجدول الذي سيتم إدراج الصفوف فيه

cellLocation

object (TableCellLocation)

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

سيتم إدراج صف جديد أعلى (أو أسفل) الصف الذي توجد فيه الخلية المرجعية. وإذا كانت الخلية المرجعية خلية مدمَجة، سيتم إدراج صف جديد أعلى (أو أسفل) الخلية المدمَجة.

insertBelow

boolean

تحديد ما إذا كان سيتم إدراج صفوف جديدة أسفل الموقع الجغرافي للخلية المرجعية

  • True : للإدراج أسفل الخلية
  • False : للإدراج فوق الخلية.
number

integer

عدد الصفوف المطلوب إدراجها. يمكنك إرسال 20 طلبًا كحد أقصى.

InsertTableColumnsRequest

تُدرِج هذه الدالة أعمدة في جدول.

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

تمثيل JSON 
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "insertRight": boolean,
  "number": integer
}
الحقول
tableObjectId

string

الجدول الذي سيتم إدراج الأعمدة فيه

cellLocation

object (TableCellLocation)

موقع الخلية المرجعية في الجدول الذي سيتم إدراج الأعمدة منه

سيتم إدراج عمود جديد على يمين (أو يسار) العمود الذي توجد فيه الخلية المرجعية. إذا كانت الخلية المرجعية خلية مدمجة، سيتم إدراج عمود جديد على يمين (أو يسار) الخلية المدمجة.

insertRight

boolean

تحديد ما إذا كان سيتم إدراج أعمدة جديدة على يمين موقع الخلية المرجعية

  • ‫True : للإدراج على اليمين
  • False : للإدراج على اليمين
number

integer

عدد الأعمدة المطلوب إدراجها. يمكنك إرسال 20 طلبًا كحد أقصى.

DeleteTableRowRequest

تحذف هذه الطريقة صفًا من جدول.

تمثيل JSON 
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  }
}
الحقول
tableObjectId

string

الجدول المطلوب حذف الصفوف منه.

cellLocation

object (TableCellLocation)

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

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

DeleteTableColumnRequest

تحذف هذه الطريقة عمودًا من جدول.

تمثيل JSON 
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  }
}
الحقول
tableObjectId

string

الجدول المطلوب حذف الأعمدة منه.

cellLocation

object (TableCellLocation)

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

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

ReplaceAllTextRequest

يستبدل جميع مثيلات النص المطابق لمعيار معيّن بالقيمة replace text.

تمثيل JSON 
{
  "replaceText": string,
  "pageObjectIds": [
    string
  ],

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "containsText": {
    object (SubstringMatchCriteria)
  }
  // End of mutually exclusive fields.
}
الحقول
replaceText

string

النص الذي سيحلّ محل النص المطابق.

pageObjectIds[]

string

إذا لم يكن فارغًا، يحصر التطابقات بعناصر الصفحة فقط على الصفحات المحدّدة.

تعرض هذه الطريقة رسالة الخطأ "400: طلب غير صالح" إذا تم تقديم معرّف عنصر الصفحة الخاص بـ notes master، أو إذا لم تكن هناك صفحة تتضمّن معرّف عنصر الصفحة هذا في العرض التقديمي.

المعايير المستخدَمة لمطابقة النص المطلوب استبداله في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الردّ:
containsText

object (SubstringMatchCriteria)

للعثور على نص في شكل يطابق هذه السلسلة الفرعية.

نهاية الحقول التي يستبعد كلّ منها الآخر

SubstringMatchCriteria

معيار يطابق سلسلة نصية معيّنة في شكل أو جدول

تمثيل JSON 
{
  "text": string,
  "matchCase": boolean,
  "searchByRegex": boolean
}
الحقول
text

string

النص المطلوب البحث عنه في الشكل أو الجدول

matchCase

boolean

يشير إلى ما إذا كان البحث يجب أن يراعي حالة الأحرف:

  • True : عملية البحث حساسة لحالة الأحرف.
  • False : البحث غير حسّاس لحالة الأحرف.
searchByRegex

boolean

اختياريّ. يتم ضبط القيمة على "صحيح" إذا كان يجب التعامل مع قيمة البحث كتعبير عادي. يجب تخطّي أي شرطات مائلة عكسية في النمط.

  • True : يتم التعامل مع نص البحث كتعبير عادي.
  • False : يتم التعامل مع نص البحث على أنّه سلسلة فرعية للمطابقة.

DeleteObjectRequest

يحذف هذا الإجراء عنصرًا، سواء كان pages أو page elements، من العرض التقديمي.

تمثيل JSON 
{
  "objectId": string
}
الحقول
objectId

string

رقم تعريف العنصر الخاص بالصفحة أو عنصر الصفحة المطلوب حذفه.

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

إذا تم حذف عنصر نائب في تخطيط، سيتم أيضًا حذف أي عناصر نائبة فارغة موروثة.

UpdatePageElementTransformRequest

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

سيؤدي تعديل عملية التحويل لمجموعة إلى تغيير عملية التحويل المطلقة لعناصر الصفحة في تلك المجموعة، ما قد يؤدي إلى تغيير مظهرها المرئي. لمزيد من التفاصيل، يُرجى الاطّلاع على مستندات PageElement.transform.

تمثيل JSON 
{
  "objectId": string,
  "transform": {
    object (AffineTransform)
  },
  "applyMode": enum (ApplyMode)
}
الحقول
objectId

string

معرّف عنصر الصفحة المطلوب تعديله.

transform

object (AffineTransform)

مصفوفة تحويل الإدخال المستخدَمة لتعديل عنصر الصفحة

applyMode

enum (ApplyMode)

وضع تطبيق تعديل التحويل.

ApplyMode

أوضاع تطبيق تحديث التحويل.

عمليات التعداد
APPLY_MODE_UNSPECIFIED الوضع غير محدّد
RELATIVE تطبيق مصفوفة AffineTransform الجديدة على المصفوفة الحالية، واستبدال المصفوفة الحالية بالتسلسل الناتج
ABSOLUTE يستبدل مصفوفة AffineTransform الحالية بالمصفوفة الجديدة.

UpdateSlidesPositionRequest

تعدّل هذه الطريقة موضع الشرائح في العرض التقديمي.

تمثيل JSON 
{
  "slideObjectIds": [
    string
  ],
  "insertionIndex": integer
}
الحقول
slideObjectIds[]

string

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

insertionIndex

integer

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

DeleteTextRequest

يحذف هذا الإجراء النص من شكل أو خلية جدول.

تمثيل JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  }
}
الحقول
objectId

string

معرّف الكائن للشكل أو الجدول الذي سيتم حذف النص منه.

cellLocation

object (TableCellLocation)

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

textRange

object (Range)

نطاق النص المطلوب حذفه، استنادًا إلى فهارس TextElement.

هناك دائمًا حرف سطر جديد ضمني في نهاية نص شكل أو خلية جدول لا يمكن حذفه. Range.Type.ALLسيتم استخدام الحدود الصحيحة، ولكن يجب توخّي الحذر عند تحديد حدود صريحة لأنواع النطاقات FROM_START_INDEX وFIXED_RANGE. على سبيل المثال، إذا كان النص هو "ABC"، متبوعًا بسطر جديد ضمني، تكون القيمة القصوى 2 للسمة textRange.start_index و3 للسمة textRange.end_index.

قد يؤدي حذف نص يتجاوز حدود الفقرة إلى تغييرات في أنماط الفقرات والقوائم، وذلك لأنّه يتم دمج الفقرتين.

يتم توسيع النطاقات التي تتضمّن وحدة رمز واحدة فقط من زوج بديل لتشمل وحدتَي الرمز.

النطاق

تحدّد هذه السمة نطاقًا متجاورًا من مجموعة مفهرسة، مثل الأحرف في النص.

تمثيل JSON 
{
  "startIndex": integer,
  "endIndex": integer,
  "type": enum (Type)
}
الحقول
startIndex

integer

الفهرس الاختياري المستند إلى الصفر لبداية المجموعة مطلوب لنطاقات FIXED_RANGE وFROM_START_INDEX.

endIndex

integer

الفهرس الاختياري المستند إلى الصفر لنهاية المجموعة مطلوب لنطاقات FIXED_RANGE.

type

enum (Type)

نوع النطاق.

النوع

أنواع النطاقات

عمليات التعداد
RANGE_TYPE_UNSPECIFIED نوع النطاق غير محدَّد. يجب عدم استخدام هذه القيمة.
FIXED_RANGE نطاق ثابت يجب تحديد كل من startIndex و endIndex.
FROM_START_INDEX يبدأ النطاق عند startIndex ويستمر حتى نهاية المجموعة. يجب عدم تحديد endIndex.
ALL يضبط النطاق ليكون طول المجموعة بالكامل. يجب عدم تحديد كلّ من السمتَين startIndex وendIndex.

CreateImageRequest

تنشئ هذه الدالة صورة.

تمثيل JSON 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "url": string
  // End of mutually exclusive fields.
}
الحقول
objectId

string

معرّف عنصر يقدّمه المستخدم

إذا حدّدت معرّفًا، يجب أن يكون فريدًا بين جميع الصفحات وعناصر الصفحات في العرض التقديمي. يجب أن يبدأ المعرّف بحرف أبجدي رقمي أو شرطة سفلية (يتطابق مع التعبير العادي [a-zA-Z0-9_])، ويمكن أن تتضمّن الأحرف المتبقية هذه الأحرف بالإضافة إلى شرطة واصلة أو نقطتين رأسيتين (يتطابق مع التعبير العادي [a-zA-Z0-9_-:])، ويجب ألا يقل طول المعرّف عن 5 أحرف أو يزيد عن 50 حرفًا.

إذا لم تحدّد معرّفًا، سيتم إنشاء معرّف فريد.

elementProperties

object (PageElementProperties)

خصائص العنصر الخاص بالصورة

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

السمة PageElementProperties.size اختيارية. إذا لم تحدّد الحجم، سيتم استخدام الحجم التلقائي للصورة.

السمة PageElementProperties.transform اختيارية. إذا لم تحدّد عملية تحويل، سيتم وضع الصورة في الزاوية العلوية اليمنى من الصفحة.

نوع مصدر الصورة. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الردّ:
url

string

عنوان URL الخاص بالصورة

يتم جلب الصورة مرة واحدة عند إدراجها ويتم تخزين نسخة منها لعرضها داخل العرض التقديمي. يجب أن يكون حجم الصور أقل من 50 ميغابايت، وألا تتجاوز 25 ميغابكسل، وأن تكون بأحد تنسيقات PNG أو JPEG أو GIF.

يجب أن يكون عنوان URL المقدَّم متاحًا للجميع وألا يزيد طوله عن 2 كيلوبايت. يتم حفظ عنوان URL مع الصورة، ويتم عرضه من خلال الحقل Image.source_url.

نهاية الحقول التي يستبعد كلّ منها الآخر

CreateVideoRequest

تنشئ هذه الطريقة فيديو.

ملاحظة: يتطلّب إنشاء فيديو من Google Drive أن يتضمّن التطبيق الذي يقدّم الطلب نطاق OAuth واحدًا على الأقل من النطاقات drive أو drive.readonly أو drive.file.

تمثيل JSON 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "source": enum (Source),
  "id": string
}
الحقول
objectId

string

معرّف عنصر يقدّمه المستخدم

إذا حدّدت معرّفًا، يجب أن يكون فريدًا بين جميع الصفحات وعناصر الصفحات في العرض التقديمي. يجب أن يبدأ المعرّف بحرف أبجدي رقمي أو شرطة سفلية (يتطابق مع التعبير العادي [a-zA-Z0-9_])، ويمكن أن تتضمّن الأحرف المتبقية هذه الأحرف بالإضافة إلى شرطة واصلة أو نقطتين رأسيتين (يتطابق مع التعبير العادي [a-zA-Z0-9_-:])، ويجب ألا يقل طول المعرّف عن 5 أحرف أو يزيد عن 50 حرفًا.

إذا لم تحدّد معرّفًا، سيتم إنشاء معرّف فريد.

elementProperties

object (PageElementProperties)

خصائص العنصر للفيديو

السمة PageElementProperties.size اختيارية. إذا لم تحدّد حجمًا، سيختار الخادم حجمًا تلقائيًا.

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

source

enum (Source)

تمثّل هذه السمة مصدر الفيديو.

id

string

المعرّف الفريد لهذا الفيديو الذي يحدّده مصدر الفيديو

على سبيل المثال، بالنسبة إلى فيديو على YouTube https://www.youtube.com/watch?v=7U3axjORYZ0، يكون المعرّف هو 7U3axjORYZ0. بالنسبة إلى فيديو على Google Drive https://drive.google.com/file/d/1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q يكون المعرّف هو 1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q.

للوصول إلى ملف فيديو في Google Drive، قد تحتاج إلى إضافة مفتاح مصدر إلى عنوان HTTP لبعض الملفات القديمة. لمزيد من المعلومات، يُرجى الاطّلاع على الوصول إلى الملفات التي تتم مشاركتها باستخدام رابط من خلال مفاتيح الموارد.

CreateSheetsChartRequest

تُنشئ هذه الدالة رسمًا بيانيًا مضمّنًا في "جداول بيانات Google".

ملاحظة: يتطلّب إنشاء رسم بياني توفّر نطاق واحد على الأقل من نطاقات OAuth التالية: spreadsheets.readonly أو spreadsheets أو drive.readonly أو drive.file أو drive.

تمثيل JSON 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "spreadsheetId": string,
  "chartId": integer,
  "linkingMode": enum (LinkingMode)
}
الحقول
objectId

string

معرّف عنصر يقدّمه المستخدم

في حال تحديدها، يجب أن يكون المعرّف فريدًا بين جميع الصفحات وعناصر الصفحات في العرض التقديمي. يجب أن يبدأ المعرّف بحرف كلمة [a-zA-Z0-9_] ثم يتبعه أي عدد من الأحرف التالية [a-zA-Z0-9_-:]، ويجب ألّا يقل طول المعرّف عن 5 أحرف أو يزيد عن 50 حرفًا. إذا كان الحقل فارغًا، سيتم إنشاء معرّف فريد.

elementProperties

object (PageElementProperties)

خصائص العنصر للرسم البياني

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

spreadsheetId

string

معرّف جدول بيانات Google الذي يحتوي على الرسم البياني

قد تحتاج إلى إضافة مفتاح مصدر إلى عنوان HTTP لبعض الملفات القديمة. لمزيد من المعلومات، يُرجى الاطّلاع على الوصول إلى الملفات التي تتم مشاركتها باستخدام رابط من خلال مفاتيح الموارد.

chartId

integer

معرّف الرسم البياني المحدّد في جدول بيانات Google.

linkingMode

enum (LinkingMode)

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

LinkingMode

الوضع الذي يرتبط به الرسم البياني بجدول البيانات المصدر.

عمليات التعداد
NOT_LINKED_IMAGE الرسم البياني غير مرتبط بجدول البيانات المصدر ولا يمكن تعديله. سيتم إدراج الرسم البياني غير المرتبط كصورة.
LINKED يسمح ربط الرسم البياني بتعديله، وسيظهر للمتعاونين الآخرين رابط يؤدي إلى جدول البيانات.

CreateLineRequest

تُنشئ هذه السمة خطًا.

تمثيل JSON 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "lineCategory": enum (Category),
  "category": enum (LineCategory)
}
الحقول
objectId

string

معرّف عنصر يقدّمه المستخدم

إذا حدّدت معرّفًا، يجب أن يكون فريدًا بين جميع الصفحات وعناصر الصفحات في العرض التقديمي. يجب أن يبدأ المعرّف بحرف أبجدي رقمي أو شرطة سفلية (يتطابق مع التعبير العادي [a-zA-Z0-9_])، ويمكن أن تتضمّن الأحرف المتبقية هذه الأحرف بالإضافة إلى شرطة واصلة أو نقطتين رأسيتين (يتطابق مع التعبير العادي [a-zA-Z0-9_-:])، ويجب ألا يقل طول المعرّف عن 5 أحرف أو يزيد عن 50 حرفًا.

إذا لم تحدّد معرّفًا، سيتم إنشاء معرّف فريد.

elementProperties

object (PageElementProperties)

خصائص العنصر للخط

lineCategory
(deprecated)

enum (Category)

فئة السطر المطلوب إنشاؤه.

تم إيقافها نهائيًا : استخدِم category بدلاً منها.

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

إذا حدّدت كلاً من category و lineCategory، ستكون الأولوية category.

category

enum (LineCategory)

فئة السطر المطلوب إنشاؤه.

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

إذا حدّدت كلاً من category و lineCategory، ستكون الأولوية category.

إذا لم تحدّد قيمة للسمة category، ولكن حدّدت قيمة للسمة lineCategory، سيتم استخدام قيمة lineCategory المحدّدة.

في حال عدم تحديد أي منهما، سيتم استخدام STRAIGHT.

الفئة

فئات الأسطر

عمليات التعداد
STRAIGHT الموصلات المستقيمة، بما في ذلك الموصل المستقيم 1 هذه هي الفئة التلقائية في حال عدم تحديد فئة.
BENT الموصلات المنحنية، بما في ذلك الموصلات المنحنية من 2 إلى 5
CURVED الموصّلات المنحنية، بما في ذلك الموصّلات المنحنية من 2 إلى 5

RefreshSheetsChartRequest

تعيد هذه الدالة تحميل رسم بياني مضمّن من "جداول بيانات Google" من خلال استبداله بأحدث إصدار من الرسم البياني من "جداول بيانات Google".

ملاحظة: يتطلّب تحديث الرسوم البيانية توفُّر نطاق OAuth واحد على الأقل من النطاقات التالية: spreadsheets.readonly أو spreadsheets أو drive.readonly أو drive.

تمثيل JSON 
{
  "objectId": string
}
الحقول
objectId

string

رقم تعريف العنصر الخاص بالرسم البياني المطلوب إعادة تحميله.

UpdateShapePropertiesRequest

عدِّل خصائص Shape.

تمثيل JSON 
{
  "objectId": string,
  "shapeProperties": {
    object (ShapeProperties)
  },
  "fields": string
}
الحقول
objectId

string

رقم تعريف العنصر للشكل الذي يتم تطبيق التعديلات عليه.

shapeProperties

object (ShapeProperties)

خصائص الشكل المطلوب تعديلها

fields

string (FieldMask format)

الحقول التي يجب تعديلها

يجب تحديد حقل واحد على الأقل. يتم تضمين الجذر shapeProperties ضمنيًا ويجب عدم تحديده. يمكن استخدام "*" واحدة كاختصار لإدراج كل حقل.

على سبيل المثال، لتعديل لون التعبئة الصلبة لخلفية الشكل، اضبط fields على "shapeBackgroundFill.solidFill.color".

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

UpdateImagePropertiesRequest

تعديل خصائص Image

تمثيل JSON 
{
  "objectId": string,
  "imageProperties": {
    object (ImageProperties)
  },
  "fields": string
}
الحقول
objectId

string

رقم تعريف العنصر الخاص بالصورة التي يتم تطبيق التعديلات عليها

imageProperties

object (ImageProperties)

خصائص الصورة التي سيتم تعديلها

fields

string (FieldMask format)

الحقول التي يجب تعديلها

يجب تحديد حقل واحد على الأقل. يتم تضمين الجذر imageProperties ضمنيًا ويجب عدم تحديده. يمكن استخدام "*" واحدة كاختصار لإدراج كل حقل.

على سبيل المثال، لتعديل لون مخطط الصورة، اضبط fields على "outline.outlineFill.solidFill.color".

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

UpdateVideoPropertiesRequest

عدِّل خصائص Video.

تمثيل JSON 
{
  "objectId": string,
  "videoProperties": {
    object (VideoProperties)
  },
  "fields": string
}
الحقول
objectId

string

معرّف الفيديو الذي يتم تطبيق التعديلات عليه

videoProperties

object (VideoProperties)

خصائص الفيديو التي سيتم تعديلها

fields

string (FieldMask format)

الحقول التي يجب تعديلها

يجب تحديد حقل واحد على الأقل. يتم تضمين الجذر videoProperties ضمنيًا ويجب عدم تحديده. يمكن استخدام "*" واحدة كاختصار لإدراج كل حقل.

على سبيل المثال، لتعديل لون مخطط الفيديو، اضبط fields على "outline.outlineFill.solidFill.color".

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

UpdatePagePropertiesRequest

تعدّل هذه الطريقة خصائص Page.

تمثيل JSON 
{
  "objectId": string,
  "pageProperties": {
    object (PageProperties)
  },
  "fields": string
}
الحقول
objectId

string

معرّف العنصر للصفحة التي يتم تطبيق التعديل عليها.

pageProperties

object (PageProperties)

سمات الصفحة التي سيتم تعديلها

fields

string (FieldMask format)

الحقول التي يجب تعديلها

يجب تحديد حقل واحد على الأقل. يتم تضمين الجذر pageProperties ضمنيًا ويجب عدم تحديده. يمكن استخدام "*" واحدة كاختصار لإدراج كل حقل.

على سبيل المثال، لتعديل لون التعبئة الصلبة لخلفية الصفحة، اضبط fields على "pageBackgroundFill.solidFill.color".

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

UpdateTableCellPropertiesRequest

عدِّل خصائص TableCell.

تمثيل JSON 
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  },
  "tableCellProperties": {
    object (TableCellProperties)
  },
  "fields": string
}
الحقول
objectId

string

معرّف العنصر للجدول.

tableRange

object (TableRange)

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

tableCellProperties

object (TableCellProperties)

خصائص خلية الجدول التي سيتم تعديلها.

fields

string (FieldMask format)

الحقول التي يجب تعديلها

يجب تحديد حقل واحد على الأقل. يتم تضمين الجذر tableCellProperties ضمنيًا ويجب عدم تحديده. يمكن استخدام "*" واحدة كاختصار لإدراج كل حقل.

على سبيل المثال، لتعديل لون التعبئة الصلبة لخلفية خلية الجدول، اضبط fields على "tableCellBackgroundFill.solidFill.color".

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

TableRange

يمثّل نطاق الجدول مرجعًا إلى مجموعة فرعية من جدول.

من المهم ملاحظة أنّ الخلايا المحدّدة بنطاق جدول لا تشكّل بالضرورة مستطيلاً. على سبيل المثال، لنفترض أنّ لدينا جدولاً من 3 صفوف و3 أعمدة تم دمج جميع خلايا الصف الأخير فيه. يبدو الجدول على النحو التالي: 

 [   ][   ][   ]
 [   ][   ][   ]
 [             ]

يحدّد نطاق الجدول الذي يتضمّن الموقع الجغرافي = (0, 0) وامتداد الصف = 3 وامتداد العمود = 2 الخلايا التالية: 

 [ x ][ x ][   ]
 [ x ][ x ][   ]
 [ x    x    x ]
تمثيل JSON 
{
  "location": {
    object (TableCellLocation)
  },
  "rowSpan": integer,
  "columnSpan": integer
}
الحقول
location

object (TableCellLocation)

الموقع الجغرافي لبداية نطاق الجدول

rowSpan

integer

عدد الصفوف التي يمتد إليها نطاق الجدول

columnSpan

integer

تمثّل هذه السمة عدد الأعمدة في نطاق الجدول.

UpdateLinePropertiesRequest

تعدّل هذه الطريقة خصائص Line.

تمثيل JSON 
{
  "objectId": string,
  "lineProperties": {
    object (LineProperties)
  },
  "fields": string
}
الحقول
objectId

string

رقم تعريف العنصر الذي يتم تطبيق التعديل عليه.

lineProperties

object (LineProperties)

خصائص الخط المطلوب تعديلها.

fields

string (FieldMask format)

الحقول التي يجب تعديلها

يجب تحديد حقل واحد على الأقل. يتم تضمين الجذر lineProperties ضمنيًا ويجب عدم تحديده. يمكن استخدام "*" واحدة كاختصار لإدراج كل حقل.

على سبيل المثال، لتعديل لون التعبئة الصلبة للخط، اضبط fields على "lineFill.solidFill.color".

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

CreateParagraphBulletsRequest

تنشئ هذه الدالة تعدادًا نقطيًا لجميع الفقرات التي تتداخل مع نطاق فهرس النص المحدّد.

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

إذا كانت الفقرة التي تسبق مباشرةً الفقرات التي يتم تعديلها في قائمة تتضمّن إعدادًا مسبقًا مطابقًا، تتم إضافة الفقرات التي يتم تعديلها إلى تلك القائمة السابقة.

تمثيل JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  },
  "bulletPreset": enum (BulletGlyphPreset)
}
الحقول
objectId

string

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

cellLocation

object (TableCellLocation)

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

textRange

object (Range)

نطاق النص الذي سيتم تطبيق الإعدادات المسبقة للرموز النقطية عليه، استنادًا إلى فهارس TextElement.

bulletPreset

enum (BulletGlyphPreset)

أنواع رموز التعداد النقطي المطلوب استخدامها. القيمة التلقائية هي الإعداد المسبق BULLET_DISC_CIRCLE_SQUARE.

BulletGlyphPreset

أنماط مُعدّة مسبقًا لرموز التعداد النقطي في القوائم ضمن النص

تستخدم هذه الأنماط أنواع النقاط التالية:

  • ARROW : سهم، يتوافق مع نقطة الرمز U+2794 في Unicode
  • ARROW3D : سهم بتظليل ثلاثي الأبعاد، يتوافق مع نقطة الرمز U+27a2 في Unicode
  • CHECKBOX : مربّع فارغ، يتوافق مع نقطة الرمز U+274f في Unicode
  • ‫CIRCLE : دائرة مفرّغة، تتوافق مع نقطة الرمز U+25cb في يونيكود
  • DIAMOND : ماسة صلبة، تتوافق مع قيمة موضع الرمز U+25c6 في يونيكود
  • DIAMONDX : ماسة تتضمّن الحرف "x"، وتتوافق مع قيمة موضع الرمز U+2756 في Unicode
  • HOLLOWDIAMOND : معيّن مجوّف، يتوافق مع نقطة الرمز U+25c7 في يونيكود
  • ‫DISC : دائرة مصمتة، تتوافق مع نقطة الرمز U+25cf في يونيكود
  • SQUARE : مربّع مصمت، يتوافق مع نقطة الرمز U+25a0 في يونيكود
  • STAR : نجمة، تتوافق مع نقطة الرمز Unicode U+2605
  • ALPHA : حرف صغير، مثل "أ" أو "ب" أو "ت".
  • UPPERALPHA : حرف كبير، مثل "أ" أو "ب" أو "ت".
  • ‫DIGIT : رقم، مثل "1" أو "2" أو "3".
  • ZERODIGIT : رقم مسبوق بصفر، مثل "01" أو "02" أو "03". لا تتم إضافة صفر إلى الأرقام التي تتضمّن أكثر من رقم واحد.
  • ‫ROMAN : رقم روماني صغير، مثل "i" أو "ii" أو "iii".
  • ‫UPPERROMAN : رقم روماني كبير، مثل I أو II أو III
  • LEFTTRIANGLE : مثلث يشير إلى اليسار، ويتوافق مع نقطة الرمز Unicode U+25c4
عمليات التعداد
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 لمستويات التداخل الثلاثة الأولى في القائمة.
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_DIGIT_ALPHA_ROMAN قائمة مرقّمة تتضمّن رموزًا رقمية DIGIT وALPHA وROMAN لمستويات التداخل الثلاثة الأولى في القائمة، متبوعة بنقاط.
NUMBERED_DIGIT_ALPHA_ROMAN_PARENS قائمة مرقّمة تتضمّن رموزًا رقمية DIGIT وALPHA وROMAN لمستويات التداخل الثلاثة الأولى في القائمة، متبوعة بأقواس
NUMBERED_DIGIT_NESTED قائمة مرقّمة تتضمّن DIGIT رموزًا رقمية مفصولة بنقاط، حيث يستخدم كل مستوى تداخل رمز مستوى التداخل السابق كبادئة. على سبيل المثال: '1.'، '1.1.', '2.', ‫'2.2.'.
NUMBERED_UPPERALPHA_ALPHA_ROMAN قائمة مرقّمة تتضمّن رموزًا رقمية UPPERALPHA وALPHA وROMAN لمستويات التداخل الثلاثة الأولى في القائمة، متبوعة بنقاط.
NUMBERED_UPPERROMAN_UPPERALPHA_DIGIT قائمة مرقّمة تتضمّن رموزًا رقمية UPPERROMAN وUPPERALPHA وDIGIT لمستويات التداخل الثلاثة الأولى في القائمة، متبوعة بنقاط.
NUMBERED_ZERODIGIT_ALPHA_ROMAN قائمة مرقّمة تتضمّن رموزًا رقمية ZERODIGIT وALPHA وROMAN لمستويات التداخل الثلاثة الأولى في القائمة، متبوعة بنقاط.

ReplaceAllShapesWithImageRequest

يستبدل هذا الإجراء جميع الأشكال التي تتطابق مع المعايير المحدّدة بالصورة المقدَّمة.

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

تمثيل JSON 
{
  "replaceMethod": enum (ReplaceMethod),
  "imageReplaceMethod": enum (ImageReplaceMethod),
  "pageObjectIds": [
    string
  ],

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "containsText": {
    object (SubstringMatchCriteria)
  }
  // End of mutually exclusive fields.

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "imageUrl": string
  // End of mutually exclusive fields.
}
الحقول
replaceMethod
(deprecated)

enum (ReplaceMethod)

طريقة الاستبدال

تم إيقافها نهائيًا : استخدِم imageReplaceMethod بدلاً منها.

إذا حدّدت كلاً من replaceMethod وimageReplaceMethod، ستكون الأولوية لـ imageReplaceMethod.

imageReplaceMethod

enum (ImageReplaceMethod)

طريقة استبدال الصورة

إذا حدّدت كلاً من replaceMethod وimageReplaceMethod، ستكون الأولوية لـ imageReplaceMethod.

إذا لم تحدّد قيمة للسمة imageReplaceMethod، ولكن حدّدت قيمة للسمة replaceMethod، سيتم استخدام قيمة replaceMethod المحدّدة.

إذا لم تحدّد أيًا منهما، سيتم استخدام CENTER_INSIDE.

pageObjectIds[]

string

إذا لم يكن فارغًا، يحصر التطابقات بعناصر الصفحة فقط على الصفحات المحدّدة.

تعرض هذه الطريقة رسالة الخطأ "400: طلب غير صالح" إذا تم تقديم معرّف عنصر الصفحة الخاص بـ notes page أو notes master، أو إذا لم تكن هناك صفحة تتضمّن معرّف العنصر هذا في العرض التقديمي.

المعايير التي يجب أن تتطابق معها الأشكال ليتم استبدالها في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الردّ:
containsText

object (SubstringMatchCriteria)

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

نهاية الحقول التي يستبعد كلّ منها الآخر
نوع مصدر الصورة. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الردّ:
imageUrl

string

عنوان URL الخاص بالصورة

يتم جلب الصورة مرة واحدة عند إدراجها ويتم تخزين نسخة منها لعرضها داخل العرض التقديمي. يجب أن يكون حجم الصور أقل من 50 ميغابايت، وألا تتجاوز 25 ميغابكسل، وأن تكون بتنسيق PNG أو JPEG أو GIF.

يجب ألا يزيد طول عنوان URL المقدَّم عن 2 كيلوبايت. يتم حفظ عنوان URL نفسه مع الصورة، ويتم عرضه من خلال الحقل Image.source_url.

نهاية الحقول التي يستبعد كلّ منها الآخر

ReplaceMethod

طريقة الاستبدال

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

ImageReplaceMethod

طريقة استبدال الصورة

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

DuplicateObjectRequest

تكرار شريحة أو عنصر صفحة

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

تمثيل JSON 
{
  "objectId": string,
  "objectIds": {
    string: string,
    ...
  }
}
الحقول
objectId

string

معرّف العنصر المطلوب تكراره

objectIds

map (key: string, value: string)

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

يجب أن تتوافق جميع المفاتيح مع أرقام التعريف الحالية في العرض التقديمي. يجب أن تكون جميع القيم فريدة في العرض التقديمي وأن تبدأ بحرف أبجدي رقمي أو شرطة سفلية (تتطابق مع التعبير العادي [a-zA-Z0-9_])، ويمكن أن تتضمّن الأحرف المتبقية تلك الأحرف بالإضافة إلى شرطة أو نقطتين (تتطابق مع التعبير العادي [a-zA-Z0-9_-:]). يجب ألا يقل طول المعرّف الجديد عن 5 أحرف أو يزيد عن 50 حرفًا.

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

UpdateTextStyleRequest

تعديل نمط النص في Shape أو Table

تمثيل JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "style": {
    object (TextStyle)
  },
  "textRange": {
    object (Range)
  },
  "fields": string
}
الحقول
objectId

string

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

cellLocation

object (TableCellLocation)

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

style

object (TextStyle)

الأنماط التي سيتم ضبطها على النص

إذا كانت قيمة نمط معيّن تتطابق مع قيمة العنصر الرئيسي، سيتم ضبط هذا النمط على "الوراثة".

قد تؤدي بعض تغييرات نمط النص إلى تغييرات أخرى تهدف إلى محاكاة سلوك محرر "العروض التقديمية من Google". لمزيد من المعلومات، يُرجى الاطّلاع على مستندات TextStyle.

textRange

object (Range)

نطاق النص المطلوب تنسيقه

يمكن توسيع النطاق ليشمل أسطرًا جديدة مجاورة.

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

fields

string (FieldMask format)

الحقول التي يجب تعديلها

يجب تحديد حقل واحد على الأقل. يتم تضمين الجذر style ضمنيًا ويجب عدم تحديده. يمكن استخدام "*" واحدة كاختصار لإدراج كل حقل.

على سبيل المثال، لتعديل نمط النص إلى غامق، اضبط fields على "bold".

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

ReplaceAllShapesWithSheetsChartRequest

يستبدل جميع الأشكال التي تتطابق مع المعايير المحدّدة بالرسم البياني المقدَّم من "جداول بيانات Google". سيتم تغيير حجم الرسم البياني وتوسيطه ليناسب حدود الشكل الأصلي.

ملاحظة: يتطلّب استبدال الأشكال بمخطط بياني نطاق OAuth واحدًا على الأقل من النطاقات التالية: spreadsheets.readonly أو spreadsheets أو drive.readonly أو drive.

تمثيل JSON 
{
  "containsText": {
    object (SubstringMatchCriteria)
  },
  "spreadsheetId": string,
  "chartId": integer,
  "linkingMode": enum (LinkingMode),
  "pageObjectIds": [
    string
  ]
}
الحقول
containsText

object (SubstringMatchCriteria)

المعايير التي يجب أن تتطابق معها الأشكال ليتم استبدالها سيستبدل الطلب جميع الأشكال التي تحتوي على النص المحدّد.

spreadsheetId

string

معرّف جدول بيانات Google الذي يحتوي على الرسم البياني

chartId

integer

معرّف الرسم البياني المحدّد في جدول بيانات Google.

linkingMode

enum (LinkingMode)

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

pageObjectIds[]

string

إذا لم يكن فارغًا، يحصر التطابقات بعناصر الصفحة فقط على الصفحات المحدّدة.

تعرض هذه الطريقة رسالة الخطأ "400: طلب غير صالح" إذا تم تقديم معرّف عنصر الصفحة الخاص بـ notes page أو notes master، أو إذا لم تكن هناك صفحة تتضمّن معرّف العنصر هذا في العرض التقديمي.

LinkingMode

الوضع الذي يرتبط به الرسم البياني بجدول البيانات المصدر.

عمليات التعداد
NOT_LINKED_IMAGE الرسم البياني غير مرتبط بجدول البيانات المصدر ولا يمكن تعديله. سيتم إدراج الرسم البياني غير المرتبط كصورة.
LINKED يسمح ربط الرسم البياني بتعديله، وسيظهر للمتعاونين الآخرين رابط يؤدي إلى جدول البيانات.

DeleteParagraphBulletsRequest

لحذف الرموز النقطية من جميع الفقرات التي تتداخل مع فهرس النص المحدّد range.

سيتم الحفاظ على مستوى التداخل لكل فقرة بشكل مرئي من خلال إضافة مسافة بادئة إلى بداية الفقرة المقابلة.

تمثيل JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  }
}
الحقول
objectId

string

معرّف الكائن للشكل أو الجدول الذي يحتوي على النص المطلوب حذف النقاط منه.

cellLocation

object (TableCellLocation)

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

textRange

object (Range)

نطاق النص الذي سيتم حذف النقاط منه، استنادًا إلى TextElementالفهارس.

UpdateParagraphStyleRequest

تعدّل هذه السمة نمط جميع الفقرات ضمن Shape أو Table التي تتداخل مع النطاق المحدّد لمؤشر النص.

تمثيل JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "style": {
    object (ParagraphStyle)
  },
  "textRange": {
    object (Range)
  },
  "fields": string
}
الحقول
objectId

string

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

cellLocation

object (TableCellLocation)

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

style

object (ParagraphStyle)

نمط الفقرة

textRange

object (Range)

نطاق النص الذي يحتوي على الفقرات المطلوب تنسيقها

fields

string (FieldMask format)

الحقول التي يجب تعديلها

يجب تحديد حقل واحد على الأقل. يتم تضمين الجذر style ضمنيًا ويجب عدم تحديده. يمكن استخدام "*" واحدة كاختصار لإدراج كل حقل.

على سبيل المثال، لتعديل محاذاة الفقرة، اضبط fields على "alignment".

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

UpdateTableBorderPropertiesRequest

تعدّل هذه السمة خصائص حدود الجدول في Table.

تمثيل JSON 
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  },
  "borderPosition": enum (BorderPosition),
  "tableBorderProperties": {
    object (TableBorderProperties)
  },
  "fields": string
}
الحقول
objectId

string

معرّف العنصر للجدول.

tableRange

object (TableRange)

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

borderPosition

enum (BorderPosition)

موضع الحدّ في نطاق الجدول الذي يجب تطبيق التعديلات عليه في حال عدم تحديد موضع الحدّ، سيتم تطبيق التعديلات على جميع الحدود في نطاق الجدول.

tableBorderProperties

object (TableBorderProperties)

خصائص حدود الجدول التي سيتم تعديلها.

fields

string (FieldMask format)

الحقول التي يجب تعديلها

يجب تحديد حقل واحد على الأقل. يتم تضمين الجذر tableBorderProperties ضمنيًا ويجب عدم تحديده. يمكن استخدام "*" واحدة كاختصار لإدراج كل حقل.

على سبيل المثال، لتعديل لون التعبئة الثابتة لحدود الجدول، اضبط fields على "tableBorderFill.solidFill.color".

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

BorderPosition

موضع حد الجدول

عمليات التعداد
ALL جميع الحدود في النطاق
BOTTOM الحدود في أسفل النطاق
INNER حدود داخل النطاق
INNER_HORIZONTAL الحدود الأفقية داخل النطاق
INNER_VERTICAL الحدود العمودية على الجانب الداخلي من النطاق
LEFT الحدود على يسار النطاق
OUTER الحدود على طول الجانب الخارجي للنطاق
RIGHT حدود على يسار النطاق
TOP حدود في أعلى النطاق

UpdateTableColumnPropertiesRequest

تعدّل هذه الطريقة خصائص عمود Table.

تمثيل JSON 
{
  "objectId": string,
  "columnIndices": [
    integer
  ],
  "tableColumnProperties": {
    object (TableColumnProperties)
  },
  "fields": string
}
الحقول
objectId

string

معرّف العنصر للجدول.

columnIndices[]

integer

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

tableColumnProperties

object (TableColumnProperties)

خصائص أعمدة الجدول التي سيتم تعديلها

إذا كانت قيمة tableColumnProperties#columnWidth في الطلب أقل من 406,400 وحدة EMU (32 نقطة)، سيتم عرض الخطأ 400 Bad Request.

fields

string (FieldMask format)

الحقول التي يجب تعديلها

يجب تحديد حقل واحد على الأقل. يتم تضمين الجذر tableColumnProperties ضمنيًا ويجب عدم تحديده. يمكن استخدام "*" واحدة كاختصار لإدراج كل حقل.

على سبيل المثال، لتعديل عرض العمود، اضبط fields على "columnWidth".

إذا تم تضمين '"columnWidth"' في قناع الحقل ولكن تم ترك السمة بدون ضبط، سيتم ضبط عرض العمود تلقائيًا على 406,400 وحدة قياس إنجليزية (32 نقطة).

UpdateTableRowPropertiesRequest

تعدّل هذه الطريقة خصائص صف Table.

تمثيل JSON 
{
  "objectId": string,
  "rowIndices": [
    integer
  ],
  "tableRowProperties": {
    object (TableRowProperties)
  },
  "fields": string
}
الحقول
objectId

string

معرّف العنصر للجدول.

rowIndices[]

integer

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

tableRowProperties

object (TableRowProperties)

خصائص صف الجدول المطلوب تعديلها.

fields

string (FieldMask format)

الحقول التي يجب تعديلها

يجب تحديد حقل واحد على الأقل. يتم تضمين الجذر tableRowProperties ضمنيًا ويجب عدم تحديده. يمكن استخدام "*" واحدة كاختصار لإدراج كل حقل.

على سبيل المثال، لتعديل الحد الأدنى لارتفاع الصف، اضبط fields على "minRowHeight".

في حال تضمين "minRowHeight" في قناع الحقل ولكن تم ترك الخاصية بدون ضبط، سيتم ضبط الحد الأدنى لارتفاع الصف على 0 تلقائيًا.

MergeTableCellsRequest

يدمج الخلايا في Table.

تمثيل JSON 
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  }
}
الحقول
objectId

string

معرّف العنصر للجدول.

tableRange

object (TableRange)

نطاق الجدول الذي يحدّد خلايا الجدول المطلوب دمجها.

سيتم ربط أي نص في الخلايا التي يتم دمجها وتخزينه في الخلية العلوية اليمنى (الرئيسية) من النطاق. إذا كان النطاق غير مستطيل (وهو ما يمكن أن يحدث في بعض الحالات التي يغطي فيها النطاق خلايا تم دمجها من قبل)، سيظهر الخطأ 400 Bad Request.

UnmergeTableCellsRequest

لإلغاء دمج الخلايا في Table.

تمثيل JSON 
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  }
}
الحقول
objectId

string

معرّف العنصر للجدول.

tableRange

object (TableRange)

نطاق الجدول الذي يحدّد خلايا الجدول المطلوب إلغاء دمجها.

سيتم إلغاء دمج جميع الخلايا المدمجة في هذا النطاق، ولن تتأثر الخلايا التي تم إلغاء دمجها من قبل. إذا لم يكن النطاق يحتوي على خلايا مدمجة، لن يؤدي الطلب إلى أي إجراء. إذا كان هناك نص في أي من الخلايا المدمجة، سيظل النص في الخلية العلوية اليمنى (الرئيسية) من مجموعة الخلايا غير المدمجة الناتجة.

GroupObjectsRequest

تجميع الكائنات لإنشاء مجموعة كائنات على سبيل المثال، يمكنك استخدام المجموعات PageElements لإنشاء Group على الصفحة نفسها التي تتضمّن جميع العناصر الفرعية.

تمثيل JSON 
{
  "groupObjectId": string,
  "childrenObjectIds": [
    string
  ]
}
الحقول
groupObjectId

string

معرّف عنصر تقدّمه أنت للمجموعة التي سيتم إنشاؤها.

إذا حدّدت معرّفًا، يجب أن يكون فريدًا بين جميع الصفحات وعناصر الصفحات في العرض التقديمي. يجب أن يبدأ المعرّف بحرف أبجدي رقمي أو شرطة سفلية (يتطابق مع التعبير العادي [a-zA-Z0-9_])، ويمكن أن تتضمّن الأحرف المتبقية هذه الأحرف بالإضافة إلى شرطة واصلة أو نقطتين رأسيتين (يتطابق مع التعبير العادي [a-zA-Z0-9_-:])، ويجب ألا يقل طول المعرّف عن 5 أحرف أو يزيد عن 50 حرفًا.

إذا لم تحدّد معرّفًا، سيتم إنشاء معرّف فريد.

childrenObjectIds[]

string

معرّفات العناصر المطلوب تجميعها

يمكن تجميع عناصر الصفحة فقط. يجب أن يتوفّر عنصران على الأقل في الصفحة نفسها غير مضمّنين في مجموعة أخرى. لا يمكن تجميع بعض عناصر الصفحة، مثل videos وtables وplaceholders.

UngroupObjectsRequest

لإلغاء تجميع العناصر، مثل groups.

تمثيل JSON 
{
  "objectIds": [
    string
  ]
}
الحقول
objectIds[]

string

معرّفات العناصر المطلوب إلغاء تجميعها.

يمكن إلغاء تجميع groups غير المضمّنة في groups أخرى فقط. يجب أن تكون جميع المجموعات في الصفحة نفسها. يتم حذف المجموعة نفسها. يتم الحفاظ على الأحجام والمواضع المرئية لجميع العناصر الفرعية.

UpdatePageElementAltTextRequest

تعدّل هذه الطريقة عنوان النص البديل و/أو وصفه الخاص بـ page element.

تمثيل JSON 
{
  "objectId": string,
  "title": string,
  "description": string
}
الحقول
objectId

string

رقم تعريف عنصر الصفحة الذي يتم تطبيق التعديلات عليه

title

string

تمثّل هذه السمة عنوان النص البديل المعدَّل لعنصر الصفحة. في حال عدم ضبطها، سيتم الاحتفاظ بالقيمة الحالية. يتم عرض العنوان لبرامج قراءة الشاشة وواجهات تسهيل الاستخدام الأخرى. استخدِم فقط قيمًا يمكن قراءتها وذات صلة بمحتوى عنصر الصفحة.

description

string

وصف النص البديل المعدَّل لعنصر الصفحة في حال عدم ضبطها، سيتم الاحتفاظ بالقيمة الحالية. يتم عرض الوصف لبرامج قراءة الشاشة وواجهات تسهيل الاستخدام الأخرى. استخدِم فقط قيمًا يمكن قراءتها وذات صلة بمحتوى عنصر الصفحة.

ReplaceImageRequest

تستبدل هذه الطريقة صورة حالية بصورة جديدة.

يؤدي استبدال صورة إلى إزالة بعض image effects من الصورة الحالية.

تمثيل JSON 
{
  "imageObjectId": string,
  "imageReplaceMethod": enum (ImageReplaceMethod),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "url": string
  // End of mutually exclusive fields.
}
الحقول
imageObjectId

string

معرّف الصورة الحالية التي سيتم استبدالها يمكن استرداد رقم التعريف من ردّ على طلب GET.

imageReplaceMethod

enum (ImageReplaceMethod)

طريقة الاستبدال

نوع مصدر الصورة. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الردّ:
url

string

عنوان URL الخاص بالصورة

يتم جلب الصورة مرة واحدة عند إدراجها ويتم تخزين نسخة منها لعرضها داخل العرض التقديمي. يجب أن يكون حجم الصور أقل من 50 ميغابايت وألا تتجاوز 25 ميغابكسل، ويجب أن تكون بتنسيق PNG أو JPEG أو GIF.

يجب ألا يتجاوز طول عنوان URL المقدَّم 2 كيلوبايت. يتم حفظ عنوان URL مع الصورة، ويتم عرضه من خلال الحقل Image.source_url.

نهاية الحقول التي يستبعد كلّ منها الآخر

UpdateSlidePropertiesRequest

تعديل خصائص شريحة

تمثيل JSON 
{
  "objectId": string,
  "slideProperties": {
    object (SlideProperties)
  },
  "fields": string
}
الحقول
objectId

string

رقم تعريف العنصر الخاص بالشريحة التي يتم تطبيق التعديل عليها

slideProperties

object (SlideProperties)

خصائص الشريحة المطلوب تعديلها

fields

string (FieldMask format)

الحقول التي يجب تعديلها

يجب تحديد حقل واحد على الأقل. يتم تضمين الجذر "slideProperties" ضِمنًا، ولا يجب تحديده. يمكن استخدام "*" واحدة كاختصار لإدراج كل حقل.

على سبيل المثال، لتعديل ما إذا تم تخطّي شريحة، اضبط fields على "isSkipped".

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

UpdatePageElementsZOrderRequest

تعديل ترتيب Z لعناصر الصفحة ترتيب Z هو ترتيب العناصر على الصفحة من الخلف إلى الأمام. قد يغطي عنصر الصفحة في المقدمة العناصر التي تقع خلفه.

تمثيل JSON 
{
  "pageElementObjectIds": [
    string
  ],
  "operation": enum (ZOrderOperation)
}
الحقول
pageElementObjectIds[]

string

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

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

operation

enum (ZOrderOperation)

عملية ترتيب Z التي سيتم تطبيقها على عناصر الصفحة.

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

ZOrderOperation

العملية التي يتم إجراؤها لتعديل ترتيب Z لعنصر صفحة

عمليات التعداد
Z_ORDER_OPERATION_UNSPECIFIED عملية غير محدّدة
BRING_TO_FRONT يتم إحضار عناصر الصفحة إلى مقدّمة الصفحة.
BRING_FORWARD يؤدي هذا الإجراء إلى تقديم عناصر الصفحة إلى الأمام بمقدار عنصر واحد مقارنةً بالعنصر الأبعد في عناصر الصفحة المحدّدة.
SEND_BACKWARD ترسل عناصر الصفحة إلى الخلف بمقدار عنصر واحد بالنسبة إلى العنصر الأبعد في عناصر الصفحة المحدّدة.
SEND_TO_BACK يرسل عناصر الصفحة إلى خلفية الصفحة.

UpdateLineCategoryRequest

تعدّل هذه الطريقة فئة line.

تمثيل JSON 
{
  "objectId": string,
  "lineCategory": enum (LineCategory)
}
الحقول
objectId

string

رقم تعريف العنصر الذي يتم تطبيق التعديل عليه.

يمكن تعديل سطر يتضمّن category فقط، ما يشير إلى أنّه "رابط".

قد يتم تغيير مسار الخط بعد تعديل فئته.

lineCategory

enum (LineCategory)

فئة السطر المطلوب تعديلها.

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

RerouteLineRequest

تعيد توجيه line بحيث تكون مرتبطة بموقعَي الربط الأقرب على عناصر الصفحة المرتبطة.

تمثيل JSON 
{
  "objectId": string
}
الحقول
objectId

string

رقم تعريف العنصر الخاص بالخط المطلوب إعادة توجيهه.

يمكن إعادة توجيه سطر واحد فقط يتضمّن category يشير إلى أنّه "موصل". يجب أن تكون نقاط بداية ونهاية الخط على عناصر مختلفة من الصفحة.

InsertCommentRequest

تُدرج هذه الدالة CommentThread في العرض التقديمي.

تمثيل JSON 
{
  "content": string,
  "assigneeEmailAddress": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "objectId": string,
  "shapeTextAnchor": {
    object (ShapeTextAnchor)
  },
  "tableCellTextAnchor": {
    object (TableCellTextAnchor)
  },
  "tableAnchor": {
    object (TableAnchor)
  }
  // End of mutually exclusive fields.
}
الحقول
content

string

تمثّل هذه السمة نص التعليق كنص عادي.

سيتم التعامل مع هذا المحتوى النصي بشكل مشابه للتعليقات التي يتم إنشاؤها في "محرّر العروض التقديمية من Google". وسيكون لها سلوكيات مشابهة للتنسيق والإشعارات وما إلى ذلك.

لا يمكن أن يكون هذا الحقل فارغًا، ويجب ألا يتجاوز 2048 وحدة رموز UTF-8.

assigneeEmailAddress

string

اختياريّ. عنوان البريد الإلكتروني للمستخدم المُسنَد إليه التعليق.

اترك الحقل فارغًا لتعليق غير مُعيَّن.

يجب ألا يتجاوز 2048 وحدة رمز UTF-8.

تمثّل هذه السمة الموقع الجغرافي في العرض التقديمي الذي يرتبط به التعليق. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الردّ:
objectId

string

تمثّل هذه السمة معرّف الكائن الخاص بـ Page أو PageElement المرتبط بهذا التعليق. إذا كان objectId المحدّد هو Group، سيتم ربط التعليق بـ 100 عنصر على الأكثر من العناصر التابعة للمجموعة التي لا تنتمي إلى المجموعة.

shapeTextAnchor

object (ShapeTextAnchor)

تثبّت هذه السمة تعليقًا على نطاق محدّد من النص ضمن Shape.

tableCellTextAnchor

object (TableCellTextAnchor)

يربط هذا النوع تعليقًا بنطاق محدّد من النص ضمن خلية واحدة في Table.

tableAnchor

object (TableAnchor)

تثبِّت هذه الدالة تعليقًا بنطاق محدّد من الخلايا ضمن Table.

نهاية الحقول التي يستبعد كلّ منها الآخر

ShapeTextAnchor

تمثّل هذه السمة رابطًا يؤدي إلى نطاق محدّد من النص ضمن عنصر Shape's text.

لإدراج تعليقات في ملاحظات المحاضر، استخدِم ShapeTextAnchor مع معرّف الكائن speaker notes.

تمثيل JSON 
{
  "objectId": string,
  "textRange": {
    object (Range)
  }
}
الحقول
objectId

string

معرّف العنصر في الصفحة الذي يحتوي على النص

textRange

object (Range)

نطاق النص الخاص بعنصر الربط

TableCellTextAnchor

تمثّل هذه السمة رابطًا يؤدي إلى نطاق معيّن من النص ضمن العنصر TableCell الخاص بالعنصر TextElement.

تمثيل JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  }
}
الحقول
objectId

string

رقم تعريف العنصر للجدول الذي يحتوي على الخلية

cellLocation

object (TableCellLocation)

تمثّل هذه السمة موقع الخلية في الجدول.

textRange

object (Range)

نطاق النص الخاص بعنصر الربط

TableAnchor

تمثّل هذه السمة رابطًا يؤدي إلى نطاق معيّن من الخلايا ضمن Table. تُستخدَم لتثبيت تعليق على كل النص في كل خلية ضمن نطاق في جدول.

تمثيل JSON 
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  }
}
الحقول
objectId

string

معرّف العنصر للجدول.

tableRange

object (TableRange)

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

AddCommentReplyRequest

تُدرج هذه السمة ردًا Post في CommentThread.

تمثيل JSON 
{
  "commentId": string,
  "post": {
    object (Post)
  }
}
الحقول
commentId

string

رقم تعريف CommentThread الذي ستتم إضافة الردّ إليه.

post

object (Post)

تمثّل Post الردّ.

UpdateCommentPostRequest

تعدّل هذه الطريقة Post في CommentThread.

يتم عرض رسالة الخطأ "400: طلب غير صالح" في الحالات التالية:

  • المستخدم الذي يطلب التعديل ليس مؤلف المشاركة.

  • تتوفّر طلبات UpdateCommentPostRequest متعددة في BatchUpdatePresentationRequest نفسه لـ postId نفسه.

تمثيل JSON 
{
  "commentId": string,
  "postId": string,
  "content": string
}
الحقول
commentId

string

تمثّل هذه السمة رقم تعريف CommentThread الذي تنتمي إليه المشاركة.

postId

string

معرّف المنشور الذي يتم تعديله.

content

string

تمثّل هذه السمة النص الجديد للتعليق، كنص عادي.

سيتم التعامل مع هذا المحتوى النصي بشكل مشابه للتعليقات التي يتم إنشاؤها في "محرّر العروض التقديمية من Google". وسيكون لها سلوكيات مشابهة للتنسيق والإشعارات وما إلى ذلك.

لا يمكن أن يكون هذا الحقل فارغًا، ويجب ألا يتجاوز 2048 وحدة رموز UTF-8.

DeleteCommentRequest

يحذف هذا الإجراء CommentThread.

تعرض هذه الطريقة الخطأ 400 Bad Request إذا لم يكن المستخدم الذي يرسل الطلب هو مؤلف headPost.

تمثيل JSON 
{
  "commentId": string
}
الحقول
commentId

string

تمثّل هذه السمة المعرّف الخاص بـ CommentThread الذي سيتم حذفه.

DeleteCommentReplyRequest

يحذف هذا الإجراء ردًا Post من CommentThread.

يتم عرض رسالة الخطأ "400: طلب غير صالح" في الحالات التالية:

تمثيل JSON 
{
  "commentId": string,
  "postId": string
}
الحقول
commentId

string

تمثّل هذه السمة رقم تعريف CommentThread الذي تنتمي إليه المشاركة.

postId

string

معرّف الرد Post الذي سيتم حذفه.