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)

تحدِّد هذه السياسة ترتيب السمة page elements.

object (UpdateLineCategoryRequest)

تغيّر فئة line.

object (RerouteLineRequest)

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

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

string

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

وإذا حدّدت رقم تعريف، يجب أن يكون فريدًا بين جميع الصفحات وعناصر الصفحات في العرض التقديمي. يجب أن يبدأ المعرّف بحرف أبجدي رقمي أو شرطة سفلية (تتطابق مع regex [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

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

وإذا حدّدت رقم تعريف، يجب أن يكون فريدًا بين جميع الصفحات وعناصر الصفحات في العرض التقديمي. يجب أن يبدأ المعرّف بحرف أبجدي رقمي أو شرطة سفلية (يتطابق مع regex [a-zA-Z0-9_])، ويمكن أن تتضمّن الأحرف المتبقية تلك الواصلة بالإضافة إلى واصلة أو نقطتين (تتطابق مع regex [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

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

وإذا حدّدت رقم تعريف، يجب أن يكون فريدًا بين جميع الصفحات وعناصر الصفحات في العرض التقديمي. يجب أن يبدأ المعرّف بحرف أبجدي رقمي أو شرطة سفلية (يتطابق مع regex [a-zA-Z0-9_])، ويمكن أن تتضمّن الأحرف المتبقية تلك الواصلة بالإضافة إلى واصلة أو نقطتين (تتطابق مع regex [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

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

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

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

object (PageElementProperties)

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

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

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

integer

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

integer

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

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

string

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

object (TableCellLocation)

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

string

النص الذي سيتم إدراجه.

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

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

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

integer

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

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

{
  "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)

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

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

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

وإذا حدّدت رقم تعريف، يجب أن يكون فريدًا بين جميع الصفحات وعناصر الصفحات في العرض التقديمي. يجب أن يبدأ المعرّف بحرف أبجدي رقمي أو شرطة سفلية (يتطابق مع regex [a-zA-Z0-9_])، ويمكن أن تتضمّن الأحرف المتبقية تلك الواصلة بالإضافة إلى واصلة أو نقطتين (تتطابق مع regex [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

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

وإذا حدّدت رقم تعريف، يجب أن يكون فريدًا بين جميع الصفحات وعناصر الصفحات في العرض التقديمي. يجب أن يبدأ المعرّف بحرف أبجدي رقمي أو شرطة سفلية (يتطابق مع regex [a-zA-Z0-9_])، ويمكن أن تتضمّن الأحرف المتبقية تلك الواصلة بالإضافة إلى واصلة أو نقطتين (تتطابق مع regex [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".

enum (LinkingMode)

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

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

string

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

وإذا حدّدت رقم تعريف، يجب أن يكون فريدًا بين جميع الصفحات وعناصر الصفحات في العرض التقديمي. يجب أن يبدأ المعرّف بحرف أبجدي رقمي أو شرطة سفلية (يتطابق مع regex [a-zA-Z0-9_])، ويمكن أن تتضمّن الأحرف المتبقية تلك الواصلة بالإضافة إلى واصلة أو نقطتين (تتطابق مع regex [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)

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

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 أو 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 كمفتاح ورقم التعريف المطلوب حديثًا كقيمة.

يجب أن تتوافق جميع المفاتيح مع أرقام التعريف الحالية في العرض التقديمي. يجب أن تكون جميع القيم فريدة في العرض التقديمي ويجب أن تبدأ بحرف أبجدي رقمي أو شرطة سفلية (تتطابق مع regex [a-zA-Z0-9_])، ويمكن أن تتضمن الأحرف المتبقية تلك الأحرف أيضًا بالإضافة إلى واصلة أو نقطتَين رأسيتَين (تتطابق مع التعبير العادي [a-zA-Z0-9_-:]). ويجب ألا يقل طول المعرّف الجديد عن 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".

enum (LinkingMode)

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

string

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

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

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

string

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

object (TableCellLocation)

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

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 في الطلب أقل من 406,400 EMU (32 نقطة)، سيتم عرض خطأ طلب غير صحيح 400.

string (FieldMask format)

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

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

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

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

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

string

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

integer

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

object (TableRowProperties)

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

string (FieldMask format)

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

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

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

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

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

string

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

object (TableRange)

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

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

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

string

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

object (TableRange)

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

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

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

string

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

وإذا حدّدت رقم تعريف، يجب أن يكون فريدًا بين جميع الصفحات وعناصر الصفحات في العرض التقديمي. يجب أن يبدأ المعرّف بحرف أبجدي رقمي أو شرطة سفلية (يتطابق مع regex [a-zA-Z0-9_])، ويمكن أن تتضمّن الأحرف المتبقية تلك الواصلة بالإضافة إلى واصلة أو نقطتين (تتطابق مع regex [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)

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

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

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

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

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

string

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

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

enum (ZOrderOperation)

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

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

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

string

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

لا يمكن تعديل سوى السطر الذي يحتوي على category للإشارة إلى أنّه "موصِّل".

قد تتم إعادة توجيه الخط بعد تحديث الفئة.

enum (LineCategory)

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

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

{
  "objectId": string
}

string

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

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