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)

تعديل الترتيب حسب العمق لمحاولة 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

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

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

slideLayoutReference

object (LayoutReference)

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

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

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

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

placeholderIdMappings[]

object (LayoutPlaceholderIdMapping)

قائمة اختيارية لعمليات ربط معرّفات الكائنات من placeholder (s) في التنسيق إلى العناصر النائبة التي تم إنشاؤها على الشريحة من التنسيق المحدّد لا يمكن استخدامها إلا عند تحديد 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) والأحرف من منطقة الاستخدام الخاص في المستوى الأساسي المتعدّد اللغات ليونيكود (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,
  "searchByRegex": boolean
}
الحقول
text

string

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

matchCase

boolean

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

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

boolean

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

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

DeleteObjectRequest

لحذف عنصر، إما pages أو page elements، من العرض التقديمي

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

string

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

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

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

UpdatePageElementTransformRequest

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

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

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

string

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

transform

object (AffineTransform)

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

applyMode

enum (ApplyMode)

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

ApplyMode

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

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

UpdateSlidesPositionRequest

تعديل موضع الشرائح في العرض التقديمي

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

string

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

insertionIndex

integer

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

DeleteTextRequest

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

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

string

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

cellLocation

object (TableCellLocation)

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

textRange

object (Range)

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

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

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

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

النطاق

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

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

integer

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

endIndex

integer

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

type

enum (Type)

نوع النطاق

النوع

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

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

CreateImageRequest

لإنشاء صورة

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

  // 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".

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

تمثيل 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 x ‏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 : سهم مع تظليل ثلاثي الأبعاد، يتوافق مع موضع رمز يونيكود U+27a2
  • CHECKBOX : مربّع مجوف، يتوافق مع موضع الرمز يونيكود U+274f
  • CIRCLE : دائرة مجوفة، تتوافق مع موضع الرمز يونيكود U+25cb
  • DIAMOND : مربّع مُربّع صلب، يتوافق مع موضع الرمز يونيكود U+25c6
  • DIAMONDX : مربّع ماسية يتضمّن حرف "x"، ويتوافق مع موضع الرمز يونيكود U+2756
  • HOLLOWDIAMOND : رمز معيّن مجوف يتوافق مع موضع الرمز يونيكود U+25c7
  • DISC : دائرة صلبة، تتوافق مع موضع رمز يونيكود U+25cf
  • SQUARE : مربّع صلب، يتوافق مع موضع الرمز يونيكود U+25a0
  • STAR : نجمة، تتوافق مع موضع رمز Unicode U+2605
  • ALPHA : حرف صغير، مثل "أ" أو "ب" أو "ج".
  • UPPERALPHA : حرف كبير، مثل "أ" أو "ب" أو "ج".
  • DIGIT : رقم، مثل ‎1 أو ‎2 أو ‎3
  • ‫ZERODIGIT : رقم يتمّ وضع الصفر قبل الأرقام الأحادية، مثل ‎01 أو ‎02 أو ‎03. لا يتمّ وضع صفر قبل الأرقام التي تتألّف من أكثر من رقم واحد.
  • ROMAN : رقم روماني صغير، مثل "i" أو "ii" أو "iii".
  • UPPERROMAN : رقم روماني كبير، مثل "I" أو "II" أو "III"
  • LEFTTRIANGLE : مثلث يشير إلى اليسار، يتوافق مع موضع الرمز يونيكود 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 أو 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 في الطلب أقل من 406,400 وحدة EMU (32 نقطة)، يتم عرض الخطأ 400 "الطلب غير صالح".

fields

string (FieldMask format)

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

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

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

في حال تضمين "columnWidth" في قناع الحقل ولكن ترك السمة بدون ضبط، سيتم ضبط عرض العمود تلقائيًا على 406,400 وحدة 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 هو ترتيب العناصر على الصفحة من الخلف إلى الأمام. قد يغطي عنصر الصفحة في المقدّمة العناصر التي تقع خلفه.

تمثيل 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 يشير إلى أنّه "موصّل". يجب أن تكون اتصالات البدء والانتهاء للخط على عناصر صفحة مختلفة.