Requests

{

  // Union field kind can be only one of the following:
  "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)
  }
  // End of list of possible types for union field kind.
}

object (CreateSlideRequest)

ينشئ شريحة جديدة.

object (CreateShapeRequest)

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

object (CreateTableRequest)

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

object (InsertTextRequest)

لإدراج نص في شكل أو خلية في جدول.

object (InsertTableRowsRequest)

لإدراج صفوف في الجدول.

object (InsertTableColumnsRequest)

لإدراج أعمدة في جدول.

object (DeleteTableRowRequest)

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

object (DeleteTableColumnRequest)

لحذف عمود من جدول

object (ReplaceAllTextRequest)

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

object (DeleteObjectRequest)

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

object (UpdatePageElementTransformRequest)

لتعديل تحويل عنصر من الصفحة

object (UpdateSlidesPositionRequest)

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

object (DeleteTextRequest)

لحذف نص من شكل أو خلية جدول.

object (CreateImageRequest)

يتم إنشاء صورة.

object (CreateVideoRequest)

يتم إنشاء فيديو.

object (CreateSheetsChartRequest)

ينشئ رسمًا بيانيًا لجداول بيانات Google مضمّنًا.

object (CreateLineRequest)

ينشئ خطًا.

object (RefreshSheetsChartRequest)

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

object (UpdateShapePropertiesRequest)

لتعديل خصائص Shape

object (UpdateImagePropertiesRequest)

لتعديل خصائص Image

object (UpdateVideoPropertiesRequest)

لتعديل خصائص Video

object (UpdatePagePropertiesRequest)

لتعديل خصائص Page

object (UpdateTableCellPropertiesRequest)

لتعديل خصائص TableCell

object (UpdateLinePropertiesRequest)

لتعديل خصائص Line

object (CreateParagraphBulletsRequest)

لإنشاء رموز نقطية للفقرات

object (ReplaceAllShapesWithImageRequest)

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

object (DuplicateObjectRequest)

يؤدي هذا الإجراء إلى تكرار شريحة أو عنصر صفحة.

object (UpdateTextStyleRequest)

لتحديث نمط النص داخل Shape أو Table

object (ReplaceAllShapesWithSheetsChartRequest)

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

object (DeleteParagraphBulletsRequest)

حذف التعداد النقطي من الفقرات

object (UpdateParagraphStyleRequest)

لتحديث تصميم الفقرات داخل Shape أو Table

object (UpdateTableBorderPropertiesRequest)

لتعديل خصائص حدود الجدول في Table

object (UpdateTableColumnPropertiesRequest)

لتعديل خصائص Table العمود.

object (UpdateTableRowPropertiesRequest)

لتعديل خصائص Table الصف.

object (MergeTableCellsRequest)

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

object (UnmergeTableCellsRequest)

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

object (GroupObjectsRequest)

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

object (UngroupObjectsRequest)

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

object (UpdatePageElementAltTextRequest)

لتعديل عنوان النص البديل و/أو وصفه page element

object (ReplaceImageRequest)

لاستبدال صورة حالية بصورة جديدة.

object (UpdateSlidePropertiesRequest)

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

object (UpdatePageElementsZOrderRequest)

لتحديث ترتيب Z page elements

object (UpdateLineCategoryRequest)

لتعديل فئة line

object (RerouteLineRequest)

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

{
  "objectId": string,
  "insertionIndex": integer,
  "slideLayoutReference": {
    object (LayoutReference)
  },
  "placeholderIdMappings": [
    {
      object (LayoutPlaceholderIdMapping)
    }
  ]
}

string

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

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

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

integer

الفهرس الاختياري القائم على الصفر الذي يشير إلى مكان إدراج الشرائح.

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

object (LayoutReference)

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

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

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

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

object (LayoutPlaceholderIdMapping)

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

{

  // Union field kind can be only one of the following:
  "predefinedLayout": enum (PredefinedLayout),
  "layoutId": string
  // End of list of possible types for union field kind.
}

enum (PredefinedLayout)

تخطيط محدَّد مسبقًا.

string

معرِّف التنسيق: رقم تعريف الكائن لأحد التنسيقات في العرض التقديمي.

{
  "objectId": string,

  // Union field kind can be only one of the following:
  "layoutPlaceholder": {
    object (Placeholder)
  },
  "layoutPlaceholderObjectId": string
  // End of list of possible types for union field kind.
}

string

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

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

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

object (Placeholder)

العنصر النائب في التنسيق الذي سيتم تطبيقه على الشريحة. فقط type أو index مطلوبة. على سبيل المثال، قد يكون الوصول TITLE_AND_BODY على شكل عنصر نائب لـ TITLE مع الفهرس 0 وعنصر نائب لـ BODY مع الفهرس 0.

string

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

{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "shapeType": enum (Type)
}

string

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

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

object (PageElementProperties)

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

enum (Type)

نوع الشكل.

{
  "pageObjectId": string,
  "size": {
    object (Size)
  },
  "transform": {
    object (AffineTransform)
  }
}

string

رقم تعريف الكائن للصفحة التي يوجد فيها العنصر.

object (Size)

حجم العنصر.

object (AffineTransform)

تحويل العنصر.

{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "rows": integer,
  "columns": integer
}

string

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

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

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

object (PageElementProperties)

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

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

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

integer

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

integer

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

{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "text": string,
  "insertionIndex": integer
}

string

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

object (TableCellLocation)

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

string

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

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

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

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

integer

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

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

{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "insertBelow": boolean,
  "number": integer
}

string

الجدول المطلوب إدراج صفوف فيه.

object (TableCellLocation)

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

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

boolean

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

• True : إدراج أسفل الخلية.
• False : إدراج أعلى الخلية

integer

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

{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "insertRight": boolean,
  "number": integer
}

string

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

object (TableCellLocation)

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

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

boolean

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

• True : إدراج إلى اليسار.
• False : إدراج إلى اليسار

integer

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

{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  }
}

string

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

object (TableCellLocation)

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

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

{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  }
}

string

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

object (TableCellLocation)

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

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

{
  "replaceText": string,
  "pageObjectIds": [
    string
  ],

  // Union field criteria can be only one of the following:
  "containsText": {
    object (SubstringMatchCriteria)
  }
  // End of list of possible types for union field criteria.
}

string

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

string

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

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

object (SubstringMatchCriteria)

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

{
  "text": string,
  "matchCase": boolean
}

string

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

boolean

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

• True : إنّ البحث حسّاس لحالة الأحرف.
• False : إنّ البحث غير حساس لحالة الأحرف.

{
  "objectId": string
}

string

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

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

إذا تم حذف عنصر نائب من تنسيق، يتم أيضًا حذف أي عناصر نائبة فارغة مكتسبة.

{
  "objectId": string,
  "transform": {
    object (AffineTransform)
  },
  "applyMode": enum (ApplyMode)
}

string

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

object (AffineTransform)

يشير ذلك المصطلح إلى مصفوفة تحويل الإدخال المستخدمة لتعديل عنصر الصفحة.

enum (ApplyMode)

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

{
  "slideObjectIds": [
    string
  ],
  "insertionIndex": integer
}

string

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

integer

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

{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  }
}

string

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

object (TableCellLocation)

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

object (Range)

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

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

قد يؤدي حذف النص الذي يتخطى حدود الفقرة إلى حدوث تغييرات في أنماط الفقرات وقوائمها عند دمج الفقرتين.

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

{
  "startIndex": integer,
  "endIndex": integer,
  "type": enum (Type)
}

integer

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

integer

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

enum (Type)

نوع النطاق.

{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },

  // Union field image_source can be only one of the following:
  "url": string
  // End of list of possible types for union field image_source.
}

string

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

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

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

object (PageElementProperties)

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

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

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

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

string

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

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

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

{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "source": enum (Source),
  "id": string
}

string

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

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

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

object (PageElementProperties)

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

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

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

enum (Source)

مصدر الفيديو.

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 لمجموعة فرعية من الملفات القديمة. لمزيد من المعلومات، يُرجى مراجعة الوصول إلى الملفات المشتركة باستخدام رابط باستخدام مفاتيح الموارد.

{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "spreadsheetId": string,
  "chartId": integer,
  "linkingMode": enum (LinkingMode)
}

string

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

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

object (PageElementProperties)

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

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

string

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

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

integer

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

enum (LinkingMode)

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

{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "lineCategory": enum (Category),
  "category": enum (LineCategory)
}

string

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

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

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

object (PageElementProperties)

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

enum (Category)

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

منهي العمل به : استخدام category بدلاً من ذلك.

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

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

enum (LineCategory)

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

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

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

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

إذا لم تحدد أيًا منهما، STRAIGHT المشروع.

{
  "objectId": string
}

string

رقم تعريف الكائن للرسم البياني المطلوب إعادة تحميله

{
  "objectId": string,
  "shapeProperties": {
    object (ShapeProperties)
  },
  "fields": string
}

string

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

object (ShapeProperties)

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

string (FieldMask format)

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

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

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

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

{
  "objectId": string,
  "imageProperties": {
    object (ImageProperties)
  },
  "fields": string
}

string

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

object (ImageProperties)

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

string (FieldMask format)

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

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

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

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

{
  "objectId": string,
  "videoProperties": {
    object (VideoProperties)
  },
  "fields": string
}

string

رقم تعريف الكائن للفيديو الذي تم تطبيق التعديلات عليه

object (VideoProperties)

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

string (FieldMask format)

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

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

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

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

{
  "objectId": string,
  "pageProperties": {
    object (PageProperties)
  },
  "fields": string
}

string

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

object (PageProperties)

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

string (FieldMask format)

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

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

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

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

{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  },
  "tableCellProperties": {
    object (TableCellProperties)
  },
  "fields": string
}

string

رقم تعريف الكائن للجدول.

object (TableRange)

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

object (TableCellProperties)

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

string (FieldMask format)

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

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

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

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

{
  "location": {
    object (TableCellLocation)
  },
  "rowSpan": integer,
  "columnSpan": integer
}

object (TableCellLocation)

موقع بداية نطاق الجدول.

integer

امتداد الصف لنطاق الجدول.

integer

امتداد العمود لنطاق الجدول.

{
  "objectId": string,
  "lineProperties": {
    object (LineProperties)
  },
  "fields": string
}

string

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

object (LineProperties)

السمات الخطية المطلوب تعديلها

string (FieldMask format)

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

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

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

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

{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  },
  "bulletPreset": enum (BulletGlyphPreset)
}

string

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

object (TableCellLocation)

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

object (Range)

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

enum (BulletGlyphPreset)

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

{
  "replaceMethod": enum (ReplaceMethod),
  "imageReplaceMethod": enum (ImageReplaceMethod),
  "pageObjectIds": [
    string
  ],

  // Union field criteria can be only one of the following:
  "containsText": {
    object (SubstringMatchCriteria)
  }
  // End of list of possible types for union field criteria.

  // Union field image_source can be only one of the following:
  "imageUrl": string
  // End of list of possible types for union field image_source.
}

enum (ReplaceMethod)

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

منهي العمل به : استخدام imageReplaceMethod بدلاً من ذلك.

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

enum (ImageReplaceMethod)

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

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

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

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

string

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

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

object (SubstringMatchCriteria)

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

string

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

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

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

{
  "objectId": string,
  "objectIds": {
    string: string,
    ...
  }
}

string

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

map (key: string, value: string)

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

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

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

{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "style": {
    object (TextStyle)
  },
  "textRange": {
    object (Range)
  },
  "fields": string
}

string

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

object (TableCellLocation)

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

object (TextStyle)

الأنماط المطلوب ضبطها على النص

إذا تطابقت قيمة نمط معين مع قيمة النمط الرئيسي، فسيتم تعيين هذا النمط ليتم اكتسابه.

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

object (Range)

نطاق النص المراد نمطه.

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

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

string (FieldMask format)

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

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

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

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

{
  "containsText": {
    object (SubstringMatchCriteria)
  },
  "spreadsheetId": string,
  "chartId": integer,
  "linkingMode": enum (LinkingMode),
  "pageObjectIds": [
    string
  ]
}

object (SubstringMatchCriteria)

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

string

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

integer

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

enum (LinkingMode)

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

string

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

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

{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  }
}

string

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

object (TableCellLocation)

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

object (Range)

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

{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "style": {
    object (ParagraphStyle)
  },
  "textRange": {
    object (Range)
  },
  "fields": string
}

string

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

object (TableCellLocation)

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

object (ParagraphStyle)

نمط الفقرة.

object (Range)

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

string (FieldMask format)

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

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

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

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

{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  },
  "borderPosition": enum (BorderPosition),
  "tableBorderProperties": {
    object (TableBorderProperties)
  },
  "fields": string
}

string

رقم تعريف الكائن للجدول.

object (TableRange)

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

enum (BorderPosition)

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

object (TableBorderProperties)

سمات حدود الجدول المطلوب تعديلها

string (FieldMask format)

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

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

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

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

{
  "objectId": string,
  "columnIndices": [
    integer
  ],
  "tableColumnProperties": {
    object (TableColumnProperties)
  },
  "fields": string
}

string

رقم تعريف الكائن للجدول.

integer

قائمة الفهارس الصفرية التي تحدد الأعمدة المراد تحديثها. وإذا لم يتم تقديم فهارس، سيتم تحديث كل الأعمدة في الجدول.

object (TableColumnProperties)

سمات العمود في الجدول المطلوب تعديلها.

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

string (FieldMask format)

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

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

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

إذا كان ""columnwidth"' يتم تضمينه في قناع الحقل ولكن تُرك الخاصية بدون تعيين، فسيكون عرض العمود افتراضيًا على 406400 وحدة EMU (32 نقطة).

{
  "objectId": string,
  "rowIndices": [
    integer
  ],
  "tableRowProperties": {
    object (TableRowProperties)
  },
  "fields": string
}

string

رقم تعريف الكائن للجدول.

integer

قائمة الفهارس الصفرية التي تحدد الصفوف المطلوب تحديثها. وإذا لم تتوفر أي فهارس، سيتم تحديث جميع الصفوف في الجدول.

object (TableRowProperties)

سمات الصفوف في الجدول المطلوب تعديلها

string (FieldMask format)

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

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

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

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

{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  }
}

string

رقم تعريف الكائن للجدول.

object (TableRange)

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

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

{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  }
}

string

رقم تعريف الكائن للجدول.

object (TableRange)

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

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

{
  "groupObjectId": string,
  "childrenObjectIds": [
    string
  ]
}

string

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

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

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

string

أرقام تعريف الكائنات المطلوب تجميعها.

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

{
  "objectIds": [
    string
  ]
}

string

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

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

{
  "objectId": string,
  "title": string,
  "description": string
}

string

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

string

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

string

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

{
  "imageObjectId": string,
  "imageReplaceMethod": enum (ImageReplaceMethod),

  // Union field image_source can be only one of the following:
  "url": string
  // End of list of possible types for union field image_source.
}

string

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

enum (ImageReplaceMethod)

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

string

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

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

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

{
  "objectId": string,
  "slideProperties": {
    object (SlideProperties)
  },
  "fields": string
}

string

رقم تعريف الكائن للشريحة التي يتم تطبيق التحديث عليها.

object (SlideProperties)

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

string (FieldMask format)

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

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

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

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

{
  "pageElementObjectIds": [
    string
  ],
  "operation": enum (ZOrderOperation)
}

string

أرقام تعريف الكائنات لعناصر الصفحة المطلوب تعديلها.

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

enum (ZOrderOperation)

يشير ذلك المصطلح إلى عملية الترتيب Z التي يتم تطبيقها على عناصر الصفحة.

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

{
  "objectId": string,
  "lineCategory": enum (LineCategory)
}

string

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

فقط الخط ذو category مما يشير إلى أنه "موصل" يمكن تحديثه.

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

enum (LineCategory)

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

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

{
  "objectId": string
}

string

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

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