Requests

{

  // Union field kind can be only one of the following:
  "updateSpreadsheetProperties": {
    object (UpdateSpreadsheetPropertiesRequest)
  },
  "updateSheetProperties": {
    object (UpdateSheetPropertiesRequest)
  },
  "updateDimensionProperties": {
    object (UpdateDimensionPropertiesRequest)
  },
  "updateNamedRange": {
    object (UpdateNamedRangeRequest)
  },
  "repeatCell": {
    object (RepeatCellRequest)
  },
  "addNamedRange": {
    object (AddNamedRangeRequest)
  },
  "deleteNamedRange": {
    object (DeleteNamedRangeRequest)
  },
  "addSheet": {
    object (AddSheetRequest)
  },
  "deleteSheet": {
    object (DeleteSheetRequest)
  },
  "autoFill": {
    object (AutoFillRequest)
  },
  "cutPaste": {
    object (CutPasteRequest)
  },
  "copyPaste": {
    object (CopyPasteRequest)
  },
  "mergeCells": {
    object (MergeCellsRequest)
  },
  "unmergeCells": {
    object (UnmergeCellsRequest)
  },
  "updateBorders": {
    object (UpdateBordersRequest)
  },
  "updateCells": {
    object (UpdateCellsRequest)
  },
  "addFilterView": {
    object (AddFilterViewRequest)
  },
  "appendCells": {
    object (AppendCellsRequest)
  },
  "clearBasicFilter": {
    object (ClearBasicFilterRequest)
  },
  "deleteDimension": {
    object (DeleteDimensionRequest)
  },
  "deleteEmbeddedObject": {
    object (DeleteEmbeddedObjectRequest)
  },
  "deleteFilterView": {
    object (DeleteFilterViewRequest)
  },
  "duplicateFilterView": {
    object (DuplicateFilterViewRequest)
  },
  "duplicateSheet": {
    object (DuplicateSheetRequest)
  },
  "findReplace": {
    object (FindReplaceRequest)
  },
  "insertDimension": {
    object (InsertDimensionRequest)
  },
  "insertRange": {
    object (InsertRangeRequest)
  },
  "moveDimension": {
    object (MoveDimensionRequest)
  },
  "updateEmbeddedObjectPosition": {
    object (UpdateEmbeddedObjectPositionRequest)
  },
  "pasteData": {
    object (PasteDataRequest)
  },
  "textToColumns": {
    object (TextToColumnsRequest)
  },
  "updateFilterView": {
    object (UpdateFilterViewRequest)
  },
  "deleteRange": {
    object (DeleteRangeRequest)
  },
  "appendDimension": {
    object (AppendDimensionRequest)
  },
  "addConditionalFormatRule": {
    object (AddConditionalFormatRuleRequest)
  },
  "updateConditionalFormatRule": {
    object (UpdateConditionalFormatRuleRequest)
  },
  "deleteConditionalFormatRule": {
    object (DeleteConditionalFormatRuleRequest)
  },
  "sortRange": {
    object (SortRangeRequest)
  },
  "setDataValidation": {
    object (SetDataValidationRequest)
  },
  "setBasicFilter": {
    object (SetBasicFilterRequest)
  },
  "addProtectedRange": {
    object (AddProtectedRangeRequest)
  },
  "updateProtectedRange": {
    object (UpdateProtectedRangeRequest)
  },
  "deleteProtectedRange": {
    object (DeleteProtectedRangeRequest)
  },
  "autoResizeDimensions": {
    object (AutoResizeDimensionsRequest)
  },
  "addChart": {
    object (AddChartRequest)
  },
  "updateChartSpec": {
    object (UpdateChartSpecRequest)
  },
  "updateBanding": {
    object (UpdateBandingRequest)
  },
  "addBanding": {
    object (AddBandingRequest)
  },
  "deleteBanding": {
    object (DeleteBandingRequest)
  },
  "createDeveloperMetadata": {
    object (CreateDeveloperMetadataRequest)
  },
  "updateDeveloperMetadata": {
    object (UpdateDeveloperMetadataRequest)
  },
  "deleteDeveloperMetadata": {
    object (DeleteDeveloperMetadataRequest)
  },
  "randomizeRange": {
    object (RandomizeRangeRequest)
  },
  "addDimensionGroup": {
    object (AddDimensionGroupRequest)
  },
  "deleteDimensionGroup": {
    object (DeleteDimensionGroupRequest)
  },
  "updateDimensionGroup": {
    object (UpdateDimensionGroupRequest)
  },
  "trimWhitespace": {
    object (TrimWhitespaceRequest)
  },
  "deleteDuplicates": {
    object (DeleteDuplicatesRequest)
  },
  "updateEmbeddedObjectBorder": {
    object (UpdateEmbeddedObjectBorderRequest)
  },
  "addSlicer": {
    object (AddSlicerRequest)
  },
  "updateSlicerSpec": {
    object (UpdateSlicerSpecRequest)
  },
  "addDataSource": {
    object (AddDataSourceRequest)
  },
  "updateDataSource": {
    object (UpdateDataSourceRequest)
  },
  "deleteDataSource": {
    object (DeleteDataSourceRequest)
  },
  "refreshDataSource": {
    object (RefreshDataSourceRequest)
  },
  "cancelDataSourceRefresh": {
    object (CancelDataSourceRefreshRequest)
  }
  // End of list of possible types for union field kind.
}

object (UpdateSpreadsheetPropertiesRequest)

يعدِّل خصائص جدول البيانات.

object (UpdateSheetPropertiesRequest)

لتعديل خصائص ورقة البيانات

object (UpdateDimensionPropertiesRequest)

تعديلات السمات' المواقع.

object (UpdateNamedRangeRequest)

يعدِّل نطاق مُعنوَن.

object (RepeatCellRequest)

لتكرار خلية واحدة في نطاق.

object (AddNamedRangeRequest)

تضيف نطاقًا مُعنوَنًا.

object (DeleteNamedRangeRequest)

حذف نطاق مُعنوَن

object (AddSheetRequest)

لإضافة ورقة.

object (DeleteSheetRequest)

لحذف ورقة.

object (AutoFillRequest)

يملأ هذا الوضع تلقائيًا المزيد من البيانات استنادًا إلى البيانات الحالية.

object (CutPasteRequest)

يقصّ البيانات من منطقة ويلصقها في منطقة أخرى.

object (CopyPasteRequest)

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

object (MergeCellsRequest)

يدمج الخلايا معًا.

object (UnmergeCellsRequest)

يؤدي إلى إلغاء دمج الخلايا المدمجة.

object (UpdateBordersRequest)

لتعديل الحدود في نطاق من الخلايا.

object (UpdateCellsRequest)

لتحديث العديد من الخلايا في وقت واحد.

object (AddFilterViewRequest)

لإضافة عرض فلتر

object (AppendCellsRequest)

لإلحاق الخلايا بعد الصف الأخير باستخدام البيانات في ورقة بيانات

object (ClearBasicFilterRequest)

لمحو الفلتر الأساسي في ورقة البيانات

object (DeleteDimensionRequest)

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

object (DeleteEmbeddedObjectRequest)

لحذف كائن مضمّن (مثل مخطط أو صورة) في ورقة بيانات.

object (DeleteFilterViewRequest)

لحذف عرض فلتر من جدول بيانات.

object (DuplicateFilterViewRequest)

يؤدي هذا الإجراء إلى تكرار عرض فلتر.

object (DuplicateSheetRequest)

يؤدي هذا الإجراء إلى إنشاء نسخة طبق الأصل من ورقة بيانات.

object (FindReplaceRequest)

للبحث عن مواضع ورود نص ما واستبدالها بنص آخر

object (InsertDimensionRequest)

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

object (InsertRangeRequest)

إدراج خلايا جديدة في ورقة، مع تحويل الخلايا الحالية

object (MoveDimensionRequest)

لنقل الصفوف أو الأعمدة إلى موقع آخر في ورقة البيانات.

object (UpdateEmbeddedObjectPositionRequest)

لتعديل موضع عنصر مضمّن (مثل الرسم البياني أو الصورة).

object (PasteDataRequest)

يلصق البيانات (HTML أو محددة) في ورقة.

object (TextToColumnsRequest)

لتحويل عمود من النص إلى العديد من الأعمدة النصية.

object (UpdateFilterViewRequest)

لتعديل خصائص عرض الفلتر.

object (DeleteRangeRequest)

لحذف نطاق من الخلايا من ورقة، مع تحريك الخلايا المتبقية.

object (AppendDimensionRequest)

لإلحاق الأبعاد بنهاية ورقة.

object (AddConditionalFormatRuleRequest)

تضيف قاعدة تنسيق شرطي جديدة.

object (UpdateConditionalFormatRuleRequest)

تُستخدَم لتعديل قاعدة تنسيق شرطي حالية.

object (DeleteConditionalFormatRuleRequest)

يؤدي هذا الإجراء إلى حذف قاعدة تنسيق شرطي حالية.

object (SortRangeRequest)

يرتب البيانات في نطاق.

object (SetDataValidationRequest)

لضبط التحقق من صحة البيانات لخلية واحدة أو أكثر.

object (SetBasicFilterRequest)

لضبط الفلتر الأساسي على ورقة بيانات

object (AddProtectedRangeRequest)

لإضافة نطاق محميّ.

object (UpdateProtectedRangeRequest)

يعدِّل هذا الإجراء نطاقًا محميًا.

object (DeleteProtectedRangeRequest)

يؤدي هذا الإجراء إلى حذف نطاق محميّ.

object (AutoResizeDimensionsRequest)

تغيير حجم بُعد واحد أو أكثر تلقائيًا استنادًا إلى محتوى الخلايا في هذا البُعد

object (AddChartRequest)

لإضافة رسم بياني

object (UpdateChartSpecRequest)

تُعدِّل مواصفات الرسم البياني.

object (UpdateBandingRequest)

لتعديل نطاق موسّع

object (AddBandingRequest)

إضافة نطاق متباين جديد

object (DeleteBandingRequest)

يزيل نطاقًا مقسّمًا

object (CreateDeveloperMetadataRequest)

ينشئ بيانات وصفية جديدة للمطوِّر

object (UpdateDeveloperMetadataRequest)

تعديل إدخال بيانات وصفية حالية للمطوّرين

object (DeleteDeveloperMetadataRequest)

يتم حذف البيانات الوصفية للمطوِّر

object (RandomizeRangeRequest)

لترتيب الصفوف في نطاق عشوائيًا.

object (AddDimensionGroupRequest)

تنشئ مجموعة خلال النطاق المحدد.

object (DeleteDimensionGroupRequest)

لحذف مجموعة عبر النطاق المحدد.

object (UpdateDimensionGroupRequest)

لتعديل حالة المجموعة المحدّدة.

object (TrimWhitespaceRequest)

لإزالة خلايا المسافات البيضاء (مثل المسافات أو علامات التبويب أو الأسطر الجديدة).

object (DeleteDuplicatesRequest)

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

object (UpdateEmbeddedObjectBorderRequest)

لتعديل حدود عنصر مضمَّن.

object (AddSlicerRequest)

تتم إضافة فلتر نطاق بيانات.

object (UpdateSlicerSpecRequest)

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

object (AddDataSourceRequest)

تضيف مصدر بيانات.

object (UpdateDataSourceRequest)

تعمل هذه السياسة على تعديل مصدر بيانات.

object (DeleteDataSourceRequest)

حذف مصدر بيانات

object (RefreshDataSourceRequest)

تتم إعادة تحميل مصدر بيانات واحد أو عدة مصادر بيانات وعناصر dbobject المرتبطة.

object (CancelDataSourceRefreshRequest)

تؤدي هذه السياسة إلى إلغاء عمليات إعادة تحميل مصدر بيانات واحد أو أكثر وعناصر dbobject المرتبطة.

{
  "properties": {
    object (SpreadsheetProperties)
  },
  "fields": string
}

object (SpreadsheetProperties)

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

string (FieldMask format)

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

{
  "properties": {
    object (SheetProperties)
  },
  "fields": string
}

object (SheetProperties)

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

string (FieldMask format)

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

{
  "properties": {
    object (DimensionProperties)
  },
  "fields": string,

  // Union field dimension_range can be only one of the following:
  "range": {
    object (DimensionRange)
  },
  "dataSourceSheetRange": {
    object (DataSourceSheetDimensionRange)
  }
  // End of list of possible types for union field dimension_range.
}

object (DimensionProperties)

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

string (FieldMask format)

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

object (DimensionRange)

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

object (DataSourceSheetDimensionRange)

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

{
  "sheetId": integer,
  "columnReferences": [
    {
      object (DataSourceColumnReference)
    }
  ]
}

integer

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

object (DataSourceColumnReference)

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

{
  "namedRange": {
    object (NamedRange)
  },
  "fields": string
}

object (NamedRange)

النطاق المُعنون المطلوب تعديله بالخصائص الجديدة.

string (FieldMask format)

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

{
  "range": {
    object (GridRange)
  },
  "cell": {
    object (CellData)
  },
  "fields": string
}

object (GridRange)

النطاق المراد تكرار الخلية فيه.

object (CellData)

البيانات المراد كتابتها.

string (FieldMask format)

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

{
  "namedRange": {
    object (NamedRange)
  }
}

object (NamedRange)

النطاق المُعنون المطلوب إضافته. تشير رسالة الأشكال البيانية namedRangeId حقل اختياري؛ وإذا لم يتم ضبط معرّف، فسيتم إنشاء معرّف عشوائيًا. (خطأ في تحديد المعرف لنطاق موجود من قبل.)

{
  "namedRangeId": string
}

string

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

{
  "properties": {
    object (SheetProperties)
  }
}

object (SheetProperties)

السمات التي يجب أن تحتوي عليها ورقة البيانات الجديدة وجميع المواقع اختيارية. تشير رسالة الأشكال البيانية sheetId حقل اختياري؛ وإذا لم يتم ضبط معرّف، فسيتم إنشاء معرّف عشوائيًا. (خطأ في تحديد رقم تعريف ورقة موجودة من قبل.)

{
  "sheetId": integer
}

integer

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

إذا كانت الورقة من DATA_SOURCE والنوع المرتبط DataSource سيتم حذفه أيضًا.

{
  "useAlternateSeries": boolean,

  // Union field area can be only one of the following:
  "range": {
    object (GridRange)
  },
  "sourceAndDestination": {
    object (SourceAndDestination)
  }
  // End of list of possible types for union field area.
}

boolean

صحيح إذا كان ينبغي علينا إنشاء بيانات باستخدام الدالة "alternate" السلسلة. يختلف هذا استنادًا إلى نوع ومقدار بيانات المصدر.

object (GridRange)

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

object (SourceAndDestination)

منطقتا المصدر والوجهة المطلوب ملؤها تلقائيًا يسرد هذا بشكل صريح مصدر الملء التلقائي ومكان توسيع هذه البيانات.

{
  "source": {
    object (GridRange)
  },
  "dimension": enum (Dimension),
  "fillLength": integer
}

object (GridRange)

موقع البيانات المطلوب استخدامها كمصدر للملء التلقائي.

enum (Dimension)

البُعد الذي يجب ملء البيانات فيه.

integer

عدد الصفوف أو الأعمدة التي يجب ملء البيانات فيها. يتم توسيع الأرقام الموجبة لتتجاوز الصف الأخير أو العمود الأخير في المصدر. يتم توسيع الأرقام السالبة قبل الصف الأول أو العمود الأول من المصدر.

{
  "source": {
    object (GridRange)
  },
  "destination": {
    object (GridCoordinate)
  },
  "pasteType": enum (PasteType)
}

object (GridRange)

بيانات المصدر المطلوب قصها.

object (GridCoordinate)

الإحداثي العلوي الأيسر حيث يجب لصق البيانات.

enum (PasteType)

نوع البيانات المراد لصقها. سيتم قص جميع بيانات المصدر، بغض النظر عما تم لصقه.

{
  "source": {
    object (GridRange)
  },
  "destination": {
    object (GridRange)
  },
  "pasteType": enum (PasteType),
  "pasteOrientation": enum (PasteOrientation)
}

object (GridRange)

النطاق المصدر المطلوب نسخه.

object (GridRange)

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

enum (PasteType)

نوع البيانات المراد لصقها.

enum (PasteOrientation)

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

{
  "range": {
    object (GridRange)
  },
  "mergeType": enum (MergeType)
}

object (GridRange)

نطاق الخلايا المراد دمجها.

enum (MergeType)

كيفية دمج الخلايا.

{
  "range": {
    object (GridRange)
  }
}

object (GridRange)

النطاق الذي يجب إلغاء دمج جميع الخلايا بداخله. إذا كان النطاق يمتد إلى عمليات دمج متعددة، فسيتم إلغاء دمج كل هذه العمليات. يجب ألا يمتد النطاق جزئيًا إلى أي دمج.

{
  "range": {
    object (GridRange)
  },
  "top": {
    object (Border)
  },
  "bottom": {
    object (Border)
  },
  "left": {
    object (Border)
  },
  "right": {
    object (Border)
  },
  "innerHorizontal": {
    object (Border)
  },
  "innerVertical": {
    object (Border)
  }
}

object (GridRange)

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

object (Border)

الحد المراد وضعه في أعلى النطاق.

object (Border)

الحد المراد وضعه في الجزء السفلي من النطاق.

object (Border)

الحد المراد وضعه على يسار النطاق.

object (Border)

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

object (Border)

الحد الأفقي المراد وضعه ضمن النطاق.

object (Border)

الحد العمودي المراد وضعه ضمن النطاق.

{
  "rows": [
    {
      object (RowData)
    }
  ],
  "fields": string,

  // Union field area can be only one of the following:
  "start": {
    object (GridCoordinate)
  },
  "range": {
    object (GridRange)
  }
  // End of list of possible types for union field area.
}

object (RowData)

البيانات المراد كتابتها.

string (FieldMask format)

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

object (GridCoordinate)

الإحداثي الذي تبدأ فيه كتابة البيانات. ويمكن كتابة أي عدد من الصفوف والأعمدة (بما في ذلك عدد مختلف من الأعمدة في كل صف).

object (GridRange)

النطاق المراد كتابة البيانات إليه.

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

{
  "filter": {
    object (FilterView)
  }
}

object (FilterView)

الفلتر المطلوب إضافته. تشير رسالة الأشكال البيانية filterViewId حقل اختياري؛ وإذا لم يتم ضبط معرّف، فسيتم إنشاء معرّف عشوائيًا. (خطأ في تحديد الرقم التعريفي لفلتر موجود سلفًا).

{
  "sheetId": integer,
  "rows": [
    {
      object (RowData)
    }
  ],
  "fields": string
}

integer

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

object (RowData)

البيانات المطلوب إلحاقها.

string (FieldMask format)

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

{
  "sheetId": integer
}

integer

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

{
  "range": {
    object (DimensionRange)
  }
}

object (DimensionRange)

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

{
  "objectId": integer
}

integer

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

{
  "filterId": integer
}

integer

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

{
  "filterId": integer
}

integer

رقم تعريف الفلتر الذي يتم تكراره.

{
  "sourceSheetId": integer,
  "insertSheetIndex": integer,
  "newSheetId": integer,
  "newSheetName": string
}

integer

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

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

integer

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

integer

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

string

اسم الورقة الجديدة. إذا كانت فارغة، يتم اختيار اسم جديد لك.

{
  "find": string,
  "replacement": string,
  "matchCase": boolean,
  "matchEntireCell": boolean,
  "searchByRegex": boolean,
  "includeFormulas": boolean,

  // Union field scope can be only one of the following:
  "range": {
    object (GridRange)
  },
  "sheetId": integer,
  "allSheets": boolean
  // End of list of possible types for union field scope.
}

string

القيمة للبحث.

string

القيمة المطلوب استخدامها كبديل.

boolean

True إذا كان البحث حساسًا لحالة الأحرف.

boolean

True إذا كانت قيمة البحث يجب أن تتطابق مع الخلية بأكملها.

boolean

True إذا كانت قيمة البحث هي تعبير عادي. يجب أن يتبع التعبير العادي والاستبدال قواعد Java regex على https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html. يُسمح لسلسلة الاستبدال بالرجوع إلى مجموعات الالتقاط. فعلى سبيل المثال، إذا كانت إحدى الخلايا تحتوي على المحتويات "Google Sheets" ويمتلك شخص آخر "Google Docs"، ثم البحث عن "o.* (.*)" مع استبدال "$1 Rocks" ستغير محتويات الخلايا إلى "GSheets Rocks" أو "GDocs Rocks" على التوالي.

boolean

True إذا كان البحث يجب أن يتضمن خلايا تحتوي على صيغ. ويتم اختيار "خطأ" لتخطّي الخلايا التي تحتوي على صِيغ.

object (GridRange)

النطاق المراد البحث عنه أو استبداله.

integer

الورقة التي تريد البحث عنها أو استبدالها.

boolean

صحيح للبحث أو الاستبدال على كل الأوراق.

{
  "range": {
    object (DimensionRange)
  },
  "inheritFromBefore": boolean
}

object (DimensionRange)

الأبعاد المطلوب إدراجها. يجب ربط كل من فهارس البداية والنهاية.

boolean

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

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

{
  "range": {
    object (GridRange)
  },
  "shiftDimension": enum (Dimension)
}

object (GridRange)

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

enum (Dimension)

البُعد الذي سيتم تغييره عند إدراج الخلايا. في حال حذف ROWS، سيتم نقل الخلايا الحالية للأسفل. في حال حذف COLUMNS، سيتم نقل الخلايا الحالية إلى اليمين.

{
  "source": {
    object (DimensionRange)
  },
  "destinationIndex": integer
}

object (DimensionRange)

سمات المصدر المطلوب نقلها.

integer

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

على سبيل المثال، يتم تعيين A1..A5 من 0, 1, 2, 3, 4 ويرغب في المضي "1" أو "2" إلى بين "3" أو "4"، سيكون المصدر ROWS [1..3) وسيكون فهرس الوجهة "4" (الفهرس القائم على صفر للصف 5). ستكون النتيجة النهائية A1..A5 من 0, 3, 1, 2, 4

{
  "objectId": integer,
  "newPosition": {
    object (EmbeddedObjectPosition)
  },
  "fields": string
}

integer

رقم تعريف العنصر الذي تم نقله

object (EmbeddedObjectPosition)

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

string (FieldMask format)

تتيح حقول OverlayPosition التي يجب تحديثها عند تعيين موضع جديد. تُستخدم فقط في حالة newPosition.overlayPosition على الأقل، وفي هذه الحالة يجب تحديد حقل واحد على الأقل. الجذر newPosition.overlayPosition يكون ضمنيًا ولا ينبغي تحديده. أغنية واحدة "*" يمكن استخدامها كاختصار لسرد كل حقل.

{
  "coordinate": {
    object (GridCoordinate)
  },
  "data": string,
  "type": enum (PasteType),

  // Union field kind can be only one of the following:
  "delimiter": string,
  "html": boolean
  // End of list of possible types for union field kind.
}

object (GridCoordinate)

الإحداثي الذي يجب أن يبدأ عنده إدراج البيانات.

string

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

enum (PasteType)

كيف يجب لصق البيانات.

string

المحدد في البيانات.

boolean

True إذا كانت البيانات بتنسيق HTML.

{
  "source": {
    object (GridRange)
  },
  "delimiter": string,
  "delimiterType": enum (DelimiterType)
}

object (GridRange)

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

string

المحدِّد المراد استخدامه. تُستخدم فقط في حال كانت قيمة delimiterType هي CUSTOM

enum (DelimiterType)

نوع المُحدِّد المراد استخدامه.

{
  "filter": {
    object (FilterView)
  },
  "fields": string
}

object (FilterView)

السمات الجديدة لعرض الفلتر

string (FieldMask format)

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

{
  "range": {
    object (GridRange)
  },
  "shiftDimension": enum (Dimension)
}

object (GridRange)

نطاق الخلايا المراد حذفها.

enum (Dimension)

البُعد الذي سيتم استبدال الخلايا المحذوفة منه. في حال حذف ROWS، سيتم نقل الخلايا الحالية للأعلى لتحل محل الخلايا المحذوفة. في حال حذف COLUMNS، سيتم نقل الخلايا الحالية إلى اليسار لتحل محل الخلايا المحذوفة.

{
  "sheetId": integer,
  "dimension": enum (Dimension),
  "length": integer
}

integer

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

enum (Dimension)

ما إذا كان يجب إلحاق الصفوف أو الأعمدة

integer

عدد الصفوف أو الأعمدة المطلوب إلحاقها.

{
  "rule": {
    object (ConditionalFormatRule)
  },
  "index": integer
}

object (ConditionalFormatRule)

القاعدة المطلوب إضافتها.

integer

الفهرس القائم على صفر حيث يجب إدراج القاعدة.

{
  "index": integer,
  "sheetId": integer,

  // Union field instruction can be only one of the following:
  "rule": {
    object (ConditionalFormatRule)
  },
  "newIndex": integer
  // End of list of possible types for union field instruction.
}

integer

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

integer

ورقة القاعدة المطلوب نقلها. مطلوبة إذا newIndex يتم تعيينها، ولا يتم استخدامها في الحالات الأخرى.

object (ConditionalFormatRule)

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

integer

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

{
  "index": integer,
  "sheetId": integer
}

integer

الفهرس القائم على صفر للقاعدة المطلوب حذفها.

integer

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

{
  "range": {
    object (GridRange)
  },
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ]
}

object (GridRange)

النطاق المطلوب ترتيبه.

object (SortSpec)

نظام الترتيب حسب كل عمود يتم استخدام المواصفات اللاحقة عندما تكون القيم متساوية في المواصفات السابقة.

{
  "range": {
    object (GridRange)
  },
  "rule": {
    object (DataValidationRule)
  }
}

object (GridRange)

النطاق الذي يجب أن تنطبق عليه قاعدة التحقّق من صحة البيانات.

object (DataValidationRule)

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

{
  "filter": {
    object (BasicFilter)
  }
}

object (BasicFilter)

الفلتر المطلوب ضبطه

{
  "protectedRange": {
    object (ProtectedRange)
  }
}

object (ProtectedRange)

النطاق المحمي المطلوب إضافته. تشير رسالة الأشكال البيانية protectedRangeId حقل اختياري؛ وإذا لم يتم ضبط معرّف، فسيتم إنشاء معرّف عشوائيًا. (خطأ في تحديد المعرف لنطاق موجود من قبل.)

{
  "protectedRange": {
    object (ProtectedRange)
  },
  "fields": string
}

object (ProtectedRange)

النطاق المحمي المطلوب تعديله باستخدام السمات الجديدة.

string (FieldMask format)

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

{
  "protectedRangeId": integer
}

integer

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

{

  // Union field dimension_range can be only one of the following:
  "dimensions": {
    object (DimensionRange)
  },
  "dataSourceSheetDimensions": {
    object (DataSourceSheetDimensionRange)
  }
  // End of list of possible types for union field dimension_range.
}

object (DimensionRange)

الأبعاد التي سيتم تغيير حجمها تلقائيًا.

object (DataSourceSheetDimensionRange)

السمات في ورقة بيانات مصدر البيانات المطلوب تغيير حجمها تلقائيًا.

{
  "chart": {
    object (EmbeddedChart)
  }
}

object (EmbeddedChart)

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

{
  "chartId": integer,
  "spec": {
    object (ChartSpec)
  }
}

integer

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

object (ChartSpec)

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

{
  "bandedRange": {
    object (BandedRange)
  },
  "fields": string
}

object (BandedRange)

النطاق الموسَّع المطلوب تحديثه بالخصائص الجديدة.

string (FieldMask format)

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

{
  "bandedRange": {
    object (BandedRange)
  }
}

object (BandedRange)

نطاق النطاق المطلوب إضافته. تشير رسالة الأشكال البيانية bandedRangeId حقل اختياري؛ وإذا لم يتم ضبط معرّف، فسيتم إنشاء معرّف عشوائيًا. (خطأ في تحديد المعرف لنطاق موجود من قبل.)

{
  "bandedRangeId": integer
}

integer

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

{
  "developerMetadata": {
    object (DeveloperMetadata)
  }
}

object (DeveloperMetadata)

البيانات الوصفية للمطوّر المطلوب إنشاؤها

{
  "dataFilters": [
    {
      object (DataFilter)
    }
  ],
  "developerMetadata": {
    object (DeveloperMetadata)
  },
  "fields": string
}

object (DataFilter)

الفلاتر التي تتطابق مع إدخالات البيانات الوصفية لمطوّر البرامج المطلوب تحديثها

object (DeveloperMetadata)

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

string (FieldMask format)

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

{
  "dataFilter": {
    object (DataFilter)
  }
}

object (DataFilter)

يصف فلتر البيانات المعايير المستخدَمة لاختيار إدخال البيانات الوصفية للمطوِّر المطلوب حذفه.

{
  "range": {
    object (GridRange)
  }
}

object (GridRange)

النطاق المراد توزيعه عشوائيًا.

{
  "range": {
    object (DimensionRange)
  }
}

object (DimensionRange)

النطاق المراد إنشاء مجموعة عليه.

{
  "range": {
    object (DimensionRange)
  }
}

object (DimensionRange)

نطاق المجموعة المراد حذفها.

{
  "dimensionGroup": {
    object (DimensionGroup)
  },
  "fields": string
}

object (DimensionGroup)

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

string (FieldMask format)

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

{
  "range": {
    object (GridRange)
  }
}

object (GridRange)

النطاق الذي سيتم قطع خلاياه.

{
  "range": {
    object (GridRange)
  },
  "comparisonColumns": [
    {
      object (DimensionRange)
    }
  ]
}

object (GridRange)

النطاق الذي تريد إزالة الصفوف المكررة منه.

object (DimensionRange)

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

{
  "objectId": integer,
  "border": {
    object (EmbeddedObjectBorder)
  },
  "fields": string
}

integer

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

object (EmbeddedObjectBorder)

الحد الذي ينطبق على العنصر المضمّن.

string (FieldMask format)

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

{
  "slicer": {
    object (Slicer)
  }
}

object (Slicer)

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

{
  "slicerId": integer,
  "spec": {
    object (SlicerSpec)
  },
  "fields": string
}

integer

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

object (SlicerSpec)

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

string (FieldMask format)

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

{
  "dataSource": {
    object (DataSource)
  }
}

object (DataSource)

مصدر البيانات المطلوب إضافته.

{
  "dataSource": {
    object (DataSource)
  },
  "fields": string
}

object (DataSource)

مصدر البيانات المطلوب تعديله.

string (FieldMask format)

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

{
  "dataSourceId": string
}

string

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

{
  "force": boolean,

  // Union field target can be only one of the following:
  "references": {
    object (DataSourceObjectReferences)
  },
  "dataSourceId": string,
  "isAll": boolean
  // End of list of possible types for union field target.
}

boolean

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

object (DataSourceObjectReferences)

الإشارات إلى عناصر مصدر البيانات المطلوب إعادة تحميلها

string

الإشارة إلى DataSource في حال تحديد هذه السمة، ستتم إعادة تحميل جميع عناصر مصدر البيانات المرتبطة بمصدر البيانات.

boolean

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

{
  "references": [
    {
      object (DataSourceObjectReference)
    }
  ]
}

object (DataSourceObjectReference)

المراجع.

{

  // Union field target can be only one of the following:
  "references": {
    object (DataSourceObjectReferences)
  },
  "dataSourceId": string,
  "isAll": boolean
  // End of list of possible types for union field target.
}

object (DataSourceObjectReferences)

الإشارات إلى عناصر مصدر البيانات التي سيتم إلغاء عمليات إعادة التحميل الخاصة بها

string

الإشارة إلى DataSource يؤدي تحديد هذا الخيار إلى إلغاء جميع عمليات إعادة تحميل عناصر مصدر البيانات المرتبطة بمصدر البيانات هذا.

boolean

يلغي هذا الإجراء جميع عمليات إعادة تحميل عناصر مصدر البيانات الحالية لجميع مصادر البيانات في جدول البيانات.