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

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

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

slideLayoutReference

object (LayoutReference)

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

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

إذا لم يتم العثور على LayoutReference في المستند الرئيسي الحالي، سيتم عرض رسالة الخطأ 400 Bad Request.

إذا لم تحدّد مرجع تنسيق، ستستخدم الشريحة التنسيق 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".

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

تمثيل JSON 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "spreadsheetId": string,
  "chartId": integer,
  "linkingMode": enum (LinkingMode)
}
الحقول
objectId

string

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

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

elementProperties

object (PageElementProperties)

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

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

spreadsheetId

string

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

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

chartId

integer

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

linkingMode

enum (LinkingMode)

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

LinkingMode

الوضع الذي يرتبط به الرسم البياني بجدول البيانات المصدر.

عمليات التعداد
NOT_LINKED_IMAGE الرسم البياني غير مرتبط بجدول البيانات المصدر ولا يمكن تعديله. سيتم إدراج الرسم البياني غير المرتبط كصورة.
LINKED يسمح ربط الرسم البياني بتعديله، وسيظهر للمتعاونين الآخرين رابط يؤدي إلى جدول البيانات.

CreateLineRequest

تُنشئ هذه السمة خطًا.

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

string

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

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

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

elementProperties

object (PageElementProperties)

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

lineCategory
(deprecated)

enum (Category)

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

تم إيقافها نهائيًا : استخدِم category بدلاً منها.

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

في حال تحديد كل من category و lineCategory، تكون الأولوية category.

category

enum (LineCategory)

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

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

في حال تحديد كل من category و lineCategory، تكون الأولوية category.

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

في حال عدم تحديد أي منهما، سيتم استخدام STRAIGHT.

الفئة

فئات الخطوط

عمليات التعداد
STRAIGHT أدوات الربط المستقيمة، بما في ذلك أداة الربط المستقيمة 1 هذه هي الفئة التلقائية في حال عدم تحديد فئة.
BENT الموصّلات المنحنية، بما في ذلك الموصّلات المنحنية من 2 إلى 5
CURVED الموصّلات المنحنية، بما في ذلك الموصّلات المنحنية من 2 إلى 5

RefreshSheetsChartRequest

تعيد هذه الدالة تحميل رسم بياني مضمّن من "جداول بيانات Google" من خلال استبداله بأحدث إصدار من الرسم البياني من "جداول بيانات Google".

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

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

string

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

UpdateShapePropertiesRequest

تعديل خصائص Shape

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

string

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

shapeProperties

object (ShapeProperties)

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

fields

string (FieldMask format)

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

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

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

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

UpdateImagePropertiesRequest

عدِّل خصائص Image.

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

string

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

imageProperties

object (ImageProperties)

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

fields

string (FieldMask format)

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

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

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

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

UpdateVideoPropertiesRequest

تعديل خصائص Video

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

string

معرّف الفيديو الذي يتم تطبيق التعديلات عليه

videoProperties

object (VideoProperties)

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

fields

string (FieldMask format)

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

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

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

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

UpdatePagePropertiesRequest

تعدّل هذه الطريقة خصائص Page.

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

string

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

pageProperties

object (PageProperties)

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

fields

string (FieldMask format)

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

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

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

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

UpdateTableCellPropertiesRequest

تعديل خصائص TableCell

تمثيل JSON 
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  },
  "tableCellProperties": {
    object (TableCellProperties)
  },
  "fields": string
}
الحقول
objectId

string

معرّف العنصر للجدول.

tableRange

object (TableRange)

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

tableCellProperties

object (TableCellProperties)

خصائص خلية الجدول التي سيتم تعديلها.

fields

string (FieldMask format)

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

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

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

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

TableRange

يمثّل نطاق الجدول مرجعًا إلى مجموعة فرعية من جدول.

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

 [   ][   ][   ]
 [   ][   ][   ]
 [             ]

يحدّد نطاق الجدول الذي يتضمّن الموقع الجغرافي = (0, 0) وعدد الصفوف = 3 وعدد الأعمدة = 2 الخلايا التالية: 

 [ x ][ x ][   ]
 [ x ][ x ][   ]
 [ x    x    x ]
تمثيل JSON 
{
  "location": {
    object (TableCellLocation)
  },
  "rowSpan": integer,
  "columnSpan": integer
}
الحقول
location

object (TableCellLocation)

الموقع الجغرافي لبداية نطاق الجدول

rowSpan

integer

عدد الصفوف في نطاق الجدول

columnSpan

integer

تمثّل هذه السمة عدد الأعمدة في نطاق الجدول.

UpdateLinePropertiesRequest

تعدّل هذه الطريقة خصائص Line.

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

string

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

lineProperties

object (LineProperties)

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

fields

string (FieldMask format)

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

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

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

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

CreateParagraphBulletsRequest

تنشئ هذه الطريقة نقاطًا لكل الفقرات التي تتداخل مع نطاق فهرس النص المحدّد.

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

إذا كانت الفقرة التي تسبق مباشرةً الفقرات التي يتم تعديلها في قائمة تتضمّن إعدادًا مسبقًا مطابقًا، تتم إضافة الفقرات التي يتم تعديلها إلى تلك القائمة السابقة.

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

string

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

cellLocation

object (TableCellLocation)

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

textRange

object (Range)

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

bulletPreset

enum (BulletGlyphPreset)

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

BulletGlyphPreset

أنماط مسبقة الضبط لرموز التعداد النقطي في القوائم ضمن النص

تستخدِم هذه الأنماط أنواع النقاط التالية:

  • ARROW : سهم، يتوافق مع نقطة الرمز U+2794 في Unicode
  • ARROW3D : سهم بتظليل ثلاثي الأبعاد، يتوافق مع نقطة الرمز U+27a2 في Unicode
  • CHECKBOX : مربّع فارغ، يتوافق مع نقطة الرمز U+274f في يونيكود
  • CIRCLE : دائرة مفرغة، تتوافق مع نقطة الرمز U+25cb في يونيكود
  • DIAMOND : ماسة مصمتة، تتوافق مع موضع الرمز U+25c6 في يونيكود
  • DIAMONDX : ماسة تتضمّن الحرف "x"، وتتوافق مع قيمة موضع الرمز U+2756 في Unicode
  • 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". سيتم تغيير حجم الرسم البياني وتوسيطه ليتناسب مع حدود الشكل الأصلي.

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

تمثيل JSON 
{
  "containsText": {
    object (SubstringMatchCriteria)
  },
  "spreadsheetId": string,
  "chartId": integer,
  "linkingMode": enum (LinkingMode),
  "pageObjectIds": [
    string
  ]
}
الحقول
containsText

object (SubstringMatchCriteria)

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

spreadsheetId

string

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

chartId

integer

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

linkingMode

enum (LinkingMode)

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

pageObjectIds[]

string

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

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

LinkingMode

الوضع الذي يرتبط به الرسم البياني بجدول البيانات المصدر.

عمليات التعداد
NOT_LINKED_IMAGE الرسم البياني غير مرتبط بجدول البيانات المصدر ولا يمكن تعديله. سيتم إدراج الرسم البياني غير المرتبط كصورة.
LINKED يسمح ربط الرسم البياني بتعديله، وسيظهر للمتعاونين الآخرين رابط يؤدي إلى جدول البيانات.

DeleteParagraphBulletsRequest

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

سيتم الحفاظ على مستوى التداخل لكل فقرة بشكل مرئي من خلال إضافة مسافة بادئة إلى بداية الفقرة المقابلة.

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

string

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

cellLocation

object (TableCellLocation)

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

textRange

object (Range)

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

UpdateParagraphStyleRequest

تعدّل هذه السمة نمط جميع الفقرات ضمن Shape أو Table التي تتداخل مع النطاق المحدّد لمؤشر النص.

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

string

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

cellLocation

object (TableCellLocation)

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

style

object (ParagraphStyle)

نمط الفقرة

textRange

object (Range)

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

fields

string (FieldMask format)

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

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

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

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

UpdateTableBorderPropertiesRequest

تعدّل هذه السمة خصائص حدود الجدول في Table.

تمثيل JSON 
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  },
  "borderPosition": enum (BorderPosition),
  "tableBorderProperties": {
    object (TableBorderProperties)
  },
  "fields": string
}
الحقول
objectId

string

معرّف العنصر للجدول.

tableRange

object (TableRange)

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

borderPosition

enum (BorderPosition)

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

tableBorderProperties

object (TableBorderProperties)

خصائص حدود الجدول التي سيتم تعديلها.

fields

string (FieldMask format)

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

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

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

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

BorderPosition

موضع حد الجدول

عمليات التعداد
ALL جميع الحدود في النطاق
BOTTOM الحدود في أسفل النطاق
INNER حدود داخل النطاق
INNER_HORIZONTAL الحدود الأفقية داخل النطاق
INNER_VERTICAL الحدود العمودية داخل النطاق
LEFT الحدود على يسار النطاق
OUTER الحدود على طول الجزء الخارجي من النطاق
RIGHT حدود على يسار النطاق
TOP الحدود في أعلى النطاق

UpdateTableColumnPropertiesRequest

تعدّل هذه الطريقة خصائص عمود Table.

تمثيل JSON 
{
  "objectId": string,
  "columnIndices": [
    integer
  ],
  "tableColumnProperties": {
    object (TableColumnProperties)
  },
  "fields": string
}
الحقول
objectId

string

معرّف العنصر للجدول.

columnIndices[]

integer

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

tableColumnProperties

object (TableColumnProperties)

خصائص أعمدة الجدول التي سيتم تعديلها

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

fields

string (FieldMask format)

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

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

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

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

UpdateTableRowPropertiesRequest

تعدّل هذه الطريقة خصائص صف Table.

تمثيل JSON 
{
  "objectId": string,
  "rowIndices": [
    integer
  ],
  "tableRowProperties": {
    object (TableRowProperties)
  },
  "fields": string
}
الحقول
objectId

string

معرّف العنصر للجدول.

rowIndices[]

integer

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

tableRowProperties

object (TableRowProperties)

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

fields

string (FieldMask format)

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

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

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

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

MergeTableCellsRequest

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

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

string

معرّف العنصر للجدول.

tableRange

object (TableRange)

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

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

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

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

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