Requests

طلب

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

تمثيل JSON 
{

  "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)
  }
}
الحقول
نوع التحديث يجب ملء حقل واحد بالضبط. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الرد:
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 
{

  "predefinedLayout": enum (PredefinedLayout),
  "layoutId": string
}
الحقول
تحدّد هذه السمة نوع 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,

  "layoutPlaceholder": {
    object (Placeholder)
  },
  "layoutPlaceholderObjectId": string
}
الحقول
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
  ],

  "containsText": {
    object (SubstringMatchCriteria)
  }
}
الحقول
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)
  },

  "url": string
}
الحقول
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 في يونيكود
  • CIRCLE : دائرة مفرّغة، تتوافق مع نقطة الرمز U+25cb في يونيكود
  • DIAMOND : ماسة صلبة، تتوافق مع قيمة موضع الرمز U+25c6 في يونيكود
  • DIAMONDX : ماسة تتضمّن الحرف "x"، وهي تتوافق مع قيمة موضع الرمز U+2756 في يونيكود
  • HOLLOWDIAMOND : معيّن مجوّف، يتوافق مع نقطة الرمز U+25c7 في Unicode
  • DISC : دائرة مصمتة، تتوافق مع نقطة الرمز U+25cf في يونيكود
  • SQUARE : مربّع مصمت، يتوافق مع نقطة الرمز U+25a0 في يونيكود
  • STAR : نجمة، تتوافق مع نقطة الرمز U+2605 في Unicode
  • ‫ALPHA : حرف صغير، مثل "أ" أو "ب" أو "ت".
  • ‫UPPERALPHA : حرف كبير، مثل "أ" أو "ب" أو "ت".
  • DIGIT : رقم، مثل "1" أو "2" أو "3".
  • ZERODIGIT : رقم يبدأ بصفر إذا كان يتألف من خانة واحدة، مثل "01" أو "02" أو "03". لا يتم وضع صفر قبل الأرقام التي تتضمّن أكثر من رقم واحد.
  • ‫ROMAN : رقم روماني صغير، مثل "i" أو "ii" أو "iii".
  • ‫UPPERROMAN : رقم روماني كبير، مثل I أو II أو III
  • LEFTTRIANGLE : مثلث يشير إلى اليسار، ويتوافق مع نقطة الرمز U+25c4 في يونيكود
عمليات التعداد
BULLET_DISC_CIRCLE_SQUARE قائمة نقطية تتضمّن رموزًا نقطية DISC وCIRCLE وSQUARE لمستويات الدمج الثلاثة الأولى في القائمة.
BULLET_DIAMONDX_ARROW3D_SQUARE قائمة نقطية تتضمّن رموزًا نقطية DIAMONDX وARROW3D وSQUARE لمستويات الدمج الثلاثة الأولى في القائمة.
BULLET_CHECKBOX قائمة نقطية تتضمّن CHECKBOX رموز نقطية لجميع مستويات الدمج في القائمة
BULLET_ARROW_DIAMOND_DISC قائمة نقطية تتضمّن رموزًا نقطية ARROW وDIAMOND وDISC لمستويات الدمج الثلاثة الأولى في القائمة.
BULLET_STAR_CIRCLE_SQUARE قائمة نقطية تتضمّن رموزًا نقطية STAR وCIRCLE وSQUARE لمستويات الدمج الثلاثة الأولى في القائمة.
BULLET_ARROW3D_CIRCLE_SQUARE قائمة نقطية تتضمّن رموزًا نقطية ARROW3D وCIRCLE وSQUARE لمستويات الدمج الثلاثة الأولى في القائمة.
BULLET_LEFTTRIANGLE_DIAMOND_DISC قائمة نقطية تتضمّن رموزًا نقطية LEFTTRIANGLE وDIAMOND وDISC لمستويات الدمج الثلاثة الأولى في القائمة.
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE قائمة نقطية تتضمّن رموزًا نقطية DIAMONDX وHOLLOWDIAMOND وSQUARE لمستويات الدمج الثلاثة الأولى في القائمة.
BULLET_DIAMOND_CIRCLE_SQUARE قائمة نقطية تتضمّن رموزًا نقطية DIAMOND وCIRCLE وSQUARE لمستويات الدمج الثلاثة الأولى في القائمة.
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
  ],

  "containsText": {
    object (SubstringMatchCriteria)
  }

  "imageUrl": string
}
الحقول
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),

  "url": string
}
الحقول
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 هو ترتيب العناصر على الصفحة من الخلف إلى الأمام. قد يغطي عنصر الصفحة في المقدمة العناصر التي تقع خلفه.

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

string

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

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

operation

enum (ZOrderOperation)

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

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

ZOrderOperation

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

عمليات التعداد
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,

  "objectId": string,
  "shapeTextAnchor": {
    object (ShapeTextAnchor)
  },
  "tableCellTextAnchor": {
    object (TableCellTextAnchor)
  },
  "tableAnchor": {
    object (TableAnchor)
  }
}
الحقول
content

string

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

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

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

assigneeEmailAddress

string

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

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

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

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

string

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

shapeTextAnchor

object (ShapeTextAnchor)

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

tableCellTextAnchor

object (TableCellTextAnchor)

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

tableAnchor

object (TableAnchor)

تثبّت هذه السمة تعليقًا بنطاق محدّد من الخلايا ضمن Table. تعرض هذه الدالة الخطأ 400 Bad Request إذا لم تتضمّن أي خلايا في النطاق نصًا.

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

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: طلب غير صالح" في الحالات التالية:

  • المستخدم الذي يطلب التعديل ليس مؤلف المشاركة.
تمثيل 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: طلب غير صالح" في الحالات التالية:

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

  • يتضمّن منشور الردّ comment action.

  • تتضمّن المشاركة الردّ assignee.

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

string

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

postId

string

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