Requests

الطلب

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

تمثيل JSON 
{

  // 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.
}
الحقول
حقل الربط kind. نوع التعديل يجب ملء حقل واحد بالضبط. kind واحد فقط مما يلي:
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 بحيث يتم ربطه في أقرب موقعَين للربط على عناصر الصفحة المرتبطة

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

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

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

slideLayoutReference

object (LayoutReference)

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

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

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

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

placeholderIdMappings[]

object (LayoutPlaceholderIdMapping)

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

LayoutReference

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

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

  // 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.
}
الحقول
حقل الاتحاد kind نوع LayoutReference. kind يمكن أن تكون إحدى القيم التالية فقط:
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,

  // 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.
}
الحقول
objectId

string

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

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

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

حقل الاتحاد kind نوع تحديد العنصر النائب في التخطيط. kind يمكن أن تكون إحدى القيم التالية فقط:
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
  ],

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

string

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

pageObjectIds[]

string

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

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

حقل الاتحاد criteria المعايير المستخدمة لمطابقة النص المراد استبداله. criteria يمكن أن تكون إحدى القيم التالية فقط:
containsText

object (SubstringMatchCriteria)

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

SubstringMatchCriteria

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

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

string

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

matchCase

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)
  },

  // Union field image_source can be only one of the following:
  "url": string
  // End of list of possible types for union field image_source.
}
الحقول
objectId

string

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

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

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

elementProperties

object (PageElementProperties)

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

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

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

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

حقل الربط image_source. نوع مصدر الصورة. image_source واحد فقط مما يلي:
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 مضمّنًا.

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

تمثيل 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
  • ARROW3D : سهم بتظليل ثلاثي الأبعاد، يقابل نقطة رمز Unicode U+27a2
  • CHECKBOX : مربّع مجوف، يتوافق مع موضع الرمز يونيكود U+274f
  • CIRCLE : دائرة مجوفة تتجاوب مع نقطة رمز Unicode U+25cb
  • DIAMOND : معيّن صلب، يتوافق مع نقطة رمز Unicode U+25c6
  • DIAMONDX : ماسة بها علامة "x"، تتجاوب مع نقطة رمز Unicode U+2756
  • HOLLOWDIAMOND : معيّن مجوف، يتوافق مع نقطة رمز Unicode U+25c7
  • DISC : دائرة صلبة، تتوافق مع موضع الرمز يونيكود U+25cf
  • SQUARE : مربّع صلب، يتوافق مع موضع الرمز يونيكود U+25a0
  • STAR : نجمة، تتوافق مع موضع الرمز يونيكود U+2605
  • 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
  ],

  // 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.
}
الحقول
replaceMethod
(deprecated)

enum (ReplaceMethod)

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

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

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

imageReplaceMethod

enum (ImageReplaceMethod)

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

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

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

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

pageObjectIds[]

string

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

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

حقل الاتحاد criteria المعايير التي يجب أن تتطابق مع الأشكال من أجل استبدالها criteria يمكن أن تكون إحدى القيم التالية فقط:
containsText

object (SubstringMatchCriteria)

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

حقل الاتحاد image_source نوع مصدر الصورة. image_source واحد فقط مما يلي:
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". سيتم تغيير حجم الرسم البياني وتوسيطه ليلائم حدود الشكل الأصلي.

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

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

fields

string (FieldMask format)

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

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

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

إذا كان ""columnwidth"' يتم تضمينه في قناع الحقل ولكن تُرك الخاصية بدون تعيين، فسيكون عرض العمود افتراضيًا على 406400 وحدة EMU (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 "الخطأ 400: طلب غير صالح".

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),

  // Union field image_source can be only one of the following:
  "url": string
  // End of list of possible types for union field image_source.
}
الحقول
imageObjectId

string

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

imageReplaceMethod

enum (ImageReplaceMethod)

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

حقل الاتحاد image_source نوع مصدر الصورة. image_source يمكن أن تكون إحدى القيم التالية فقط:
url

string

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

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

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

UpdateSlidePropertiesRequest

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

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

string

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

slideProperties

object (SlideProperties)

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

fields

string (FieldMask format)

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

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

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

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

UpdatePageElementsZOrderRequest

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

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

string

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

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

operation

enum (ZOrderOperation)

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

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

ZOrderOperation

عملية تحديث ترتيب Z لعنصر الصفحة.

عمليات التعداد
Z_ORDER_OPERATION_UNSPECIFIED عملية غير محدّدة.
BRING_TO_FRONT لجلب عناصر الصفحة إلى مقدمة الصفحة
BRING_FORWARD تنقل عناصر الصفحة إلى الأمام في الصفحة بعنصر واحد بالنسبة إلى العنصر الأقرب إلى الأمام في عناصر الصفحة المحدّدة.
SEND_BACKWARD تنقل عناصر الصفحة للخلف في الصفحة بعنصر واحد بالنسبة إلى العنصر الأبعد في عناصر الصفحة المحدّدة.
SEND_TO_BACK تُرسِل عناصر الصفحة إلى الجزء الخلفي من الصفحة.

UpdateLineCategoryRequest

لتعديل فئة line

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

string

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

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

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

lineCategory

enum (LineCategory)

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

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

RerouteLineRequest

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

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

string

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

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