Requests

الطلب

نوع واحد من التحديث لتطبيقه على جدول بيانات.

تمثيل JSON
{

  // 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.
}
الحقول
حقل الاتحاد kind نوع التحديث. يجب ملء حقل واحد بالضبط. kind واحد فقط مما يلي:
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)

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

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)

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

cancelDataSourceRefresh

object (CancelDataSourceRefreshRequest)

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

UpdateSpreadsheetPropertiesRequest

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

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

object (SpreadsheetProperties)

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

fields

string (FieldMask format)

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

UpdateSheetPropertiesRequest

لتعديل خصائص ورقة البيانات باستخدام السمة المحددة sheetId

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

object (SheetProperties)

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

fields

string (FieldMask format)

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

UpdateDimensionPropertiesRequest

تعدّل خصائص السمات ضمن النطاق المحدّد.

تمثيل JSON
{
  "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.
}
الحقول
properties

object (DimensionProperties)

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

fields

string (FieldMask format)

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

حقل الاتحاد dimension_range نطاق البُعد. dimension_range واحد فقط مما يلي:
range

object (DimensionRange)

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

dataSourceSheetRange

object (DataSourceSheetDimensionRange)

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

DataSourceSheetDimensionRange

نطاق بطول بُعد واحد على DATA_SOURCE ورقة البيانات.

تمثيل JSON
{
  "sheetId": integer,
  "columnReferences": [
    {
      object (DataSourceColumnReference)
    }
  ]
}
الحقول
sheetId

integer

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

columnReferences[]

object (DataSourceColumnReference)

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

UpdateNamedRangeRequest

لتعديل خصائص النطاق المُعنون باستخدام السمة المحددة namedRangeId

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

object (NamedRange)

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

fields

string (FieldMask format)

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

RepeatCellRequest

لتعديل كل الخلايا في النطاق إلى القيم في كائن "الخلية" المحدّد. فقط الحقول المدرجة في fields تحديث الحقل؛ والبعض الآخر لم يتغير.

في حال كتابة خلية تحتوي على صيغة، ستزيد نطاقات الصيغة تلقائيًا لكل حقل في النطاق. فعلى سبيل المثال، إذا كانت كتابة خلية تحتوي على صيغة =A1 في النطاق B2:C4، فإن B2 ستكون =A1، B3 سيكون =A2، B4 سيكون سيكون =A3، C2 =B1، C3 سيكون =B2، سيكون C4 =B3

لإبقاء نطاقات المعادلة ثابتة، استخدم $ مؤشر الأداء. على سبيل المثال، استخدم المعادلة =$A$1 لمنع زيادة كل من الصف والعمود.

تمثيل JSON
{
  "range": {
    object (GridRange)
  },
  "cell": {
    object (CellData)
  },
  "fields": string
}
الحقول
range

object (GridRange)

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

cell

object (CellData)

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

fields

string (FieldMask format)

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

AddNamedRangeRequest

تضيف نطاقًا مُعنوَنًا إلى جدول البيانات.

تمثيل JSON
{
  "namedRange": {
    object (NamedRange)
  }
}
الحقول
namedRange

object (NamedRange)

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

DeleteNamedRangeRequest

لإزالة النطاق المُعنون الذي يحمل المعرّف المحدّد من جدول البيانات.

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

string

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

AddSheetRequest

لإضافة ورقة جديدة. عند إضافة ورقة في فهرس معين، فإن جميع الأوراق التالية تتزايد المؤشرات. لإضافة ورقة كائن، استخدم AddChartRequest بدلاً من ذلك وحدد EmbeddedObjectPosition.sheetId أو EmbeddedObjectPosition.newSheet

تمثيل JSON
{
  "properties": {
    object (SheetProperties)
  }
}
الحقول
properties

object (SheetProperties)

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

DeleteSheetRequest

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

تمثيل JSON
{
  "sheetId": integer
}
الحقول
sheetId

integer

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

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

AutoFillRequest

يملأ المزيد من البيانات استنادًا إلى البيانات الحالية.

تمثيل JSON
{
  "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.
}
الحقول
useAlternateSeries

boolean

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

حقل الاتحاد area المنطقة المطلوب ملؤها تلقائيًا. area واحد فقط مما يلي:
range

object (GridRange)

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

sourceAndDestination

object (SourceAndDestination)

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

SourceAndDestination

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

تمثيل JSON
{
  "source": {
    object (GridRange)
  },
  "dimension": enum (Dimension),
  "fillLength": integer
}
الحقول
source

object (GridRange)

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

dimension

enum (Dimension)

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

fillLength

integer

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

CutPasteRequest

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

تمثيل JSON
{
  "source": {
    object (GridRange)
  },
  "destination": {
    object (GridCoordinate)
  },
  "pasteType": enum (PasteType)
}
الحقول
source

object (GridRange)

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

destination

object (GridCoordinate)

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

pasteType

enum (PasteType)

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

PasteType

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

عمليات التعداد
PASTE_NORMAL يمكنك لصق القيم والمعادلات والتنسيقات وعمليات الدمج.
PASTE_VALUES الصق القيم فقط بدون تنسيقات أو صيغ أو عمليات دمج.
PASTE_FORMAT الصق التنسيق والتحقق من صحة البيانات فقط.
PASTE_NO_BORDERS أعجبني PASTE_NORMAL ولكن بدون حدود.
PASTE_FORMULA الصق الصيغ فقط.
PASTE_DATA_VALIDATION الصق التحقق من صحة البيانات فقط.
PASTE_CONDITIONAL_FORMATTING الصق قواعد التنسيق الشرطي فقط.

CopyPasteRequest

يتم نسخ البيانات من المصدر إلى الوجهة.

تمثيل JSON
{
  "source": {
    object (GridRange)
  },
  "destination": {
    object (GridRange)
  },
  "pasteType": enum (PasteType),
  "pasteOrientation": enum (PasteOrientation)
}
الحقول
source

object (GridRange)

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

destination

object (GridRange)

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

pasteType

enum (PasteType)

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

pasteOrientation

enum (PasteOrientation)

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

PasteOrientation

كيفية إجراء عملية اللصق.

عمليات التعداد
NORMAL يُرجى لصقها بشكل عادي.
TRANSPOSE لصق مع تغيير موضعها، حيث تتحوّل جميع الصفوف إلى أعمدة والعكس صحيح

MergeCellsRequest

يدمج كل الخلايا في النطاق.

تمثيل JSON
{
  "range": {
    object (GridRange)
  },
  "mergeType": enum (MergeType)
}
الحقول
range

object (GridRange)

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

mergeType

enum (MergeType)

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

MergeType

نوع الدمج المراد إنشاؤه.

عمليات التعداد
MERGE_ALL إنشاء عملية دمج واحدة من النطاق
MERGE_COLUMNS إنشاء دمج لكل عمود في النطاق
MERGE_ROWS إنشاء عملية دمج لكل صف في النطاق

UnmergeCellsRequest

يلغي دمج الخلايا في النطاق المحدّد.

تمثيل JSON
{
  "range": {
    object (GridRange)
  }
}
الحقول
range

object (GridRange)

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

UpdateBordersRequest

لتعديل حدود نطاق. وإذا لم يتم ضبط حقل في الطلب، يعني هذا أنّ الحدود تظل كما هي. على سبيل المثال، مع طلبَي UpdateBordersRequest لاحقين:

  1. النطاق: A1:A5 { top: RED, bottom: WHITE }
  2. النطاق: A1:A5 { left: BLUE }

قد ينتج عن ذلك وجود حدود A1:A5 { top: RED, bottom: WHITE, left: BLUE } إذا كنت تريد مسح حد ما، فعيّن النمط بشكل صريح على NONE

تمثيل JSON
{
  "range": {
    object (GridRange)
  },
  "top": {
    object (Border)
  },
  "bottom": {
    object (Border)
  },
  "left": {
    object (Border)
  },
  "right": {
    object (Border)
  },
  "innerHorizontal": {
    object (Border)
  },
  "innerVertical": {
    object (Border)
  }
}
الحقول
range

object (GridRange)

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

top

object (Border)

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

bottom

object (Border)

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

left

object (Border)

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

right

object (Border)

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

innerHorizontal

object (Border)

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

innerVertical

object (Border)

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

UpdateCellsRequest

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

تمثيل JSON
{
  "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.
}
الحقول
rows[]

object (RowData)

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

fields

string (FieldMask format)

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

حقل الاتحاد area ينبغي كتابة بيانات الموقع. يجب ضبط قيمة واحدة بالضبط. area واحد فقط مما يلي:
start

object (GridCoordinate)

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

range

object (GridRange)

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

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

AddFilterViewRequest

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

تمثيل JSON
{
  "filter": {
    object (FilterView)
  }
}
الحقول
filter

object (FilterView)

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

AppendCellsRequest

لإضافة خلايا جديدة بعد الصف الأخير باستخدام البيانات في ورقة البيانات، وإدخال صفوف جديدة في الورقة إذا لزم الأمر.

تمثيل JSON
{
  "sheetId": integer,
  "rows": [
    {
      object (RowData)
    }
  ],
  "fields": string
}
الحقول
sheetId

integer

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

rows[]

object (RowData)

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

fields

string (FieldMask format)

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

ClearBasicFilterRequest

يؤدي هذا الإجراء إلى محو الفلتر الأساسي في حال توفُّره في ورقة البيانات.

تمثيل JSON
{
  "sheetId": integer
}
الحقول
sheetId

integer

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

DeleteDimensionRequest

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

تمثيل JSON
{
  "range": {
    object (DimensionRange)
  }
}
الحقول
range

object (DimensionRange)

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

DeleteEmbeddedObjectRequest

يؤدي هذا الإجراء إلى حذف العنصر المضمّن الذي يحمل المعرّف المحدّد.

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

integer

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

DeleteFilterViewRequest

يؤدي هذا الإجراء إلى حذف عرض فلتر معيّن.

تمثيل JSON
{
  "filterId": integer
}
الحقول
filterId

integer

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

DuplicateFilterViewRequest

يؤدي إلى تكرار عرض فلتر معيّن.

تمثيل JSON
{
  "filterId": integer
}
الحقول
filterId

integer

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

DuplicateSheetRequest

لتكرار محتوى ورقة البيانات.

تمثيل JSON
{
  "sourceSheetId": integer,
  "insertSheetIndex": integer,
  "newSheetId": integer,
  "newSheetName": string
}
الحقول
sourceSheetId

integer

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

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

insertSheetIndex

integer

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

newSheetId

integer

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

newSheetName

string

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

FindReplaceRequest

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

تمثيل JSON
{
  "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.
}
الحقول
find

string

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

replacement

string

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

matchCase

boolean

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

matchEntireCell

boolean

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

searchByRegex

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" على التوالي.

includeFormulas

boolean

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

حقل الاتحاد scope النطاق المراد البحث أو الاستبدال عليه -- يجب تعيين نطاق واحد فقط. scope واحد فقط مما يلي:
range

object (GridRange)

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

sheetId

integer

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

allSheets

boolean

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

InsertDimensionRequest

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

تمثيل JSON
{
  "range": {
    object (DimensionRange)
  },
  "inheritFromBefore": boolean
}
الحقول
range

object (DimensionRange)

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

inheritFromBefore

boolean

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

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

InsertRangeRequest

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

تمثيل JSON
{
  "range": {
    object (GridRange)
  },
  "shiftDimension": enum (Dimension)
}
الحقول
range

object (GridRange)

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

shiftDimension

enum (Dimension)

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

MoveDimensionRequest

نقل صف أو عمود واحد أو أكثر

تمثيل JSON
{
  "source": {
    object (DimensionRange)
  },
  "destinationIndex": integer
}
الحقول
source

object (DimensionRange)

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

destinationIndex

integer

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

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

UpdateEmbeddedObjectPositionRequest

عدِّل موضع عنصر مضمَّن (مثل نقل رسم بياني أو صورة أو تغيير حجمهما).

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

integer

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

newPosition

object (EmbeddedObjectPosition)

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

fields

string (FieldMask format)

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

PasteDataRequest

يقوم بإدراج البيانات في جدول البيانات بدءًا من الإحداثي المحدد.

تمثيل JSON
{
  "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.
}
الحقول
coordinate

object (GridCoordinate)

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

data

string

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

type

enum (PasteType)

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

حقل الاتحاد kind كيفية تفسير البيانات، يجب تعيين قيمة واحدة بالضبط. kind واحد فقط مما يلي:
delimiter

string

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

html

boolean

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

TextToColumnsRequest

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

تمثيل JSON
{
  "source": {
    object (GridRange)
  },
  "delimiter": string,
  "delimiterType": enum (DelimiterType)
}
الحقول
source

object (GridRange)

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

delimiter

string

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

delimiterType

enum (DelimiterType)

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

DelimiterType

المحدد الذي سيتم التقسيم عنده.

عمليات التعداد
DELIMITER_TYPE_UNSPECIFIED القيمة التلقائية. يجب عدم استخدام هذه القيمة.
COMMA
SEMICOLON
PERIOD ".
SPACE " "
CUSTOM قيمة مخصّصة على النحو المحدّد في المحدِّد.
AUTODETECT اكتشاف الأعمدة تلقائيًا.

UpdateFilterViewRequest

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

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

object (FilterView)

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

fields

string (FieldMask format)

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

DeleteRangeRequest

يؤدي هذا الإجراء إلى حذف نطاق من الخلايا، مع نقل الخلايا الأخرى إلى المنطقة المحذوفة.

تمثيل JSON
{
  "range": {
    object (GridRange)
  },
  "shiftDimension": enum (Dimension)
}
الحقول
range

object (GridRange)

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

shiftDimension

enum (Dimension)

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

AppendDimensionRequest

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

تمثيل JSON
{
  "sheetId": integer,
  "dimension": enum (Dimension),
  "length": integer
}
الحقول
sheetId

integer

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

dimension

enum (Dimension)

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

length

integer

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

AddConditionalFormatRuleRequest

تضيف قاعدة تنسيق شرطي جديدة في الفهرس المحدّد. كل القواعد اللاحقة" تتزايد المؤشرات.

تمثيل JSON
{
  "rule": {
    object (ConditionalFormatRule)
  },
  "index": integer
}
الحقول
rule

object (ConditionalFormatRule)

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

index

integer

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

UpdateConditionalFormatRuleRequest

لتعديل قاعدة تنسيق شرطي في فهرس معيّن، أو نقل قاعدة تنسيق شرطي إلى فهرس آخر.

تمثيل JSON
{
  "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.
}
الحقول
index

integer

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

sheetId

integer

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

حقل الاتحاد instruction نوع التحديث الذي من المفترض أن يحدث. instruction واحد فقط مما يلي:
rule

object (ConditionalFormatRule)

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

newIndex

integer

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

DeleteConditionalFormatRuleRequest

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

تمثيل JSON
{
  "index": integer,
  "sheetId": integer
}
الحقول
index

integer

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

sheetId

integer

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

SortRangeRequest

يفرز البيانات في صفوف استنادًا إلى نظام الفرز في كل عمود.

تمثيل JSON
{
  "range": {
    object (GridRange)
  },
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ]
}
الحقول
range

object (GridRange)

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

sortSpecs[]

object (SortSpec)

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

SetDataValidationRequest

تضبط قاعدة التحقّق من صحة البيانات على كل خلية في النطاق. لمحو التحقق من الصحة في نطاق، يمكنك استدعاء هذا بدون تحديد قاعدة.

تمثيل JSON
{
  "range": {
    object (GridRange)
  },
  "rule": {
    object (DataValidationRule)
  }
}
الحقول
range

object (GridRange)

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

rule

object (DataValidationRule)

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

SetBasicFilterRequest

لضبط الفلتر الأساسي المرتبط بالورقة.

تمثيل JSON
{
  "filter": {
    object (BasicFilter)
  }
}
الحقول
filter

object (BasicFilter)

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

AddProtectedRangeRequest

يضيف هذا الإجراء نطاقًا محميًا جديدًا.

تمثيل JSON
{
  "protectedRange": {
    object (ProtectedRange)
  }
}
الحقول
protectedRange

object (ProtectedRange)

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

UpdateProtectedRangeRequest

لتعديل نطاق محمي حالي باستخدام النطاق المحدّد protectedRangeId

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

object (ProtectedRange)

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

fields

string (FieldMask format)

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

DeleteProtectedRangeRequest

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

تمثيل JSON
{
  "protectedRangeId": integer
}
الحقول
protectedRangeId

integer

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

AutoResizeDimensionsRequest

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

تمثيل JSON
{

  // 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.
}
الحقول
حقل الاتحاد dimension_range نطاق البُعد. dimension_range واحد فقط مما يلي:
dimensions

object (DimensionRange)

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

dataSourceSheetDimensions

object (DataSourceSheetDimensionRange)

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

AddChartRequest

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

تمثيل JSON
{
  "chart": {
    object (EmbeddedChart)
  }
}
الحقول
chart

object (EmbeddedChart)

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

UpdateChartSpecRequest

تُعدِّل مواصفات الرسم البياني. (لا يؤدي هذا إلى نقل المخطط أو تغيير حجمه. لنقل مخطط أو تغيير حجمه، استخدم UpdateEmbeddedObjectPositionRequest).

تمثيل JSON
{
  "chartId": integer,
  "spec": {
    object (ChartSpec)
  }
}
الحقول
chartId

integer

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

spec

object (ChartSpec)

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

UpdateBandingRequest

يحدِّث خصائص النطاق المتباين المقدم.

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

object (BandedRange)

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

fields

string (FieldMask format)

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

AddBandingRequest

تضيف نطاقًا متباينًا جديدًا إلى جدول البيانات.

تمثيل JSON
{
  "bandedRange": {
    object (BandedRange)
  }
}
الحقول
bandedRange

object (BandedRange)

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

DeleteBandingRequest

يزيل النطاق ذي النطاق الترددي ذي المعرّف المحدد من جدول البيانات.

تمثيل JSON
{
  "bandedRangeId": integer
}
الحقول
bandedRangeId

integer

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

CreateDeveloperMetadataRequest

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

تمثيل JSON
{
  "developerMetadata": {
    object (DeveloperMetadata)
  }
}
الحقول
developerMetadata

object (DeveloperMetadata)

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

UpdateDeveloperMetadataRequest

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

تمثيل JSON
{
  "dataFilters": [
    {
      object (DataFilter)
    }
  ],
  "developerMetadata": {
    object (DeveloperMetadata)
  },
  "fields": string
}
الحقول
dataFilters[]

object (DataFilter)

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

developerMetadata

object (DeveloperMetadata)

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

fields

string (FieldMask format)

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

DeleteDeveloperMetadataRequest

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

تمثيل JSON
{
  "dataFilter": {
    object (DataFilter)
  }
}
الحقول
dataFilter

object (DataFilter)

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

RandomizeRangeRequest

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

تمثيل JSON
{
  "range": {
    object (GridRange)
  }
}
الحقول
range

object (GridRange)

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

AddDimensionGroupRequest

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

إذا كان النطاق المطلوب يتجاوز نطاق مجموعة حالية G، تتم زيادة عمق G وتصبح هذه المجموعة الجديدة G' عن عمق تلك المجموعة. على سبيل المثال، ينتج عن المجموعة [C:D، العمق 1] + [B:E] المجموعات [B:E، العمق 1] و[C:D، العمق 2]. وإذا كان النطاق المطلوب مجموعة فرعية من نطاق إحدى المجموعات الحالية G، فإن عمق المجموعة الجديدة G' يصبح أكبر من عمق G. على سبيل المثال، ينتج عن المجموعة [B:E، العمق 1] + [C:D] المجموعات [B:E، العمق 1] و[C:D، العمق 2]. إذا كان النطاق المطلوب يبدأ قبل وينتهي في نطاق المجموعة الحالية "G" أو يبدأ بعده وينتهي بعده، يصبح نطاق المجموعة الحالية "G" اتحاد النطاقات، وتصبح المجموعة الجديدة "G" بعمق أكبر من عمق G ويتراوح هو تقاطع النطاقات. على سبيل المثال، ينتج عن المجموعة [B:D، العمق 1] + [C:E] المجموعات [B:E، العمق 1] و[C:D، العمق 2].

تمثيل JSON
{
  "range": {
    object (DimensionRange)
  }
}
الحقول
range

object (DimensionRange)

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

DeleteDimensionGroupRequest

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

على سبيل المثال، افترض أن الورقة تحتوي على مجموعة depth-1 على B:E ومجموعة depth-2 على C:D. يؤدي حذف مجموعة فوق D:E إلى ترك الورقة بمجموعة depth-1 فوق B:D ومجموعة depth-2 على C:C.

تمثيل JSON
{
  "range": {
    object (DimensionRange)
  }
}
الحقول
range

object (DimensionRange)

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

UpdateDimensionGroupRequest

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

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

object (DimensionGroup)

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

fields

string (FieldMask format)

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

TrimWhitespaceRequest

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

تمثيل JSON
{
  "range": {
    object (GridRange)
  }
}
الحقول
range

object (GridRange)

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

DeleteDuplicatesRequest

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

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

تمثيل JSON
{
  "range": {
    object (GridRange)
  },
  "comparisonColumns": [
    {
      object (DimensionRange)
    }
  ]
}
الحقول
range

object (GridRange)

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

comparisonColumns[]

object (DimensionRange)

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

UpdateEmbeddedObjectBorderRequest

لتعديل خاصية حدود عنصر مضمّن.

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

integer

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

border

object (EmbeddedObjectBorder)

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

fields

string (FieldMask format)

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

AddSlicerRequest

لإضافة فلتر نطاق بيانات إلى ورقة في جدول البيانات

تمثيل JSON
{
  "slicer": {
    object (Slicer)
  }
}
الحقول
slicer

object (Slicer)

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

UpdateSlicerSpecRequest

يعدِّل مواصفات فلتر نطاق بيانات. (لا يؤدي هذا الإجراء إلى نقل فلتر نطاق بيانات أو تغيير حجمه. لنقل استخدام فلتر نطاق بيانات أو تغيير حجمه UpdateEmbeddedObjectPositionRequest

تمثيل JSON
{
  "slicerId": integer,
  "spec": {
    object (SlicerSpec)
  },
  "fields": string
}
الحقول
slicerId

integer

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

spec

object (SlicerSpec)

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

fields

string (FieldMask format)

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

AddDataSourceRequest

تضيف مصدر بيانات. بعد إضافة مصدر البيانات بنجاح، يمكن ربط مصدر بيانات DATA_SOURCE يتمّ إنشاء ورقة البيانات وتنفيذ عملية تنفيذ لإعادة تحميل ورقة البيانات وقراءة البيانات من مصدر البيانات.

يتطلب الطلب إضافة bigquery.readonly نطاق OAuth في حال إضافة مصدر بيانات BigQuery.

تمثيل JSON
{
  "dataSource": {
    object (DataSource)
  }
}
الحقول
dataSource

object (DataSource)

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

UpdateDataSourceRequest

تعمل هذه السياسة على تعديل مصدر بيانات. بعد تعديل مصدر البيانات بنجاح، يتمّ بدء عملية تنفيذ لإعادة تحميل مصدر البيانات المرتبط. DATA_SOURCE لقراءة البيانات من مصدر البيانات المحدث.

يتطلب الطلب إضافة bigquery.readonly نطاق OAuth في حال تعديل مصدر بيانات BigQuery.

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

object (DataSource)

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

fields

string (FieldMask format)

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

DeleteDataSourceRequest

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

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

string

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

RefreshDataSourceRequest

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

يتطلب الطلب إضافة bigquery.readonly نطاق OAuth في حال إعادة تحميل مصدر بيانات BigQuery.

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

تمثيل JSON
{
  "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.
}
الحقول
force

boolean

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

حقل الاتحاد target تحدِّد هذه السياسة العناصر المطلوب إعادة تحميلها. target واحد فقط مما يلي:
references

object (DataSourceObjectReferences)

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

dataSourceId

string

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

isAll

boolean

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

DataSourceObjectReferences

قائمة بالمراجع إلى عناصر مصدر البيانات

تمثيل JSON
{
  "references": [
    {
      object (DataSourceObjectReference)
    }
  ]
}
الحقول
references[]

object (DataSourceObjectReference)

المراجع.

CancelDataSourceRefreshRequest

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

يتطلب الطلب إضافة bigquery.readonly نطاق OAuth في حال إلغاء عملية إعادة التحميل على مصدر بيانات BigQuery.

تمثيل JSON
{

  // 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.
}
الحقول
حقل الاتحاد target لتحديد ما سيتم إلغاؤه. target واحد فقط مما يلي:
references

object (DataSourceObjectReferences)

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

dataSourceId

string

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

isAll

boolean

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