تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Requests

الطلب

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

تمثيل JSON

تمثيل 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`. }

{

  // 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)` تُعيد تحميل مصدر بيانات واحد أو أكثر وعناصر dbobjects المرتبطة به.
`cancelDataSourceRefresh`	`object (CancelDataSourceRefreshRequest)` تلغي عمليات إعادة تحميل مصدر بيانات واحد أو أكثر وعناصر dbobjects المرتبطة.

UpdateSpreadsheetPropertiesRequest

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

تمثيل JSON
{ "properties": { object (`SpreadsheetProperties`) }, "fields": string }

الحقول

الحقول
`properties`	`object (SpreadsheetProperties)` السمات المطلوب تعديلها
`fields`	`string (FieldMask format)` الحقول التي يجب تعديلها يجب تحديد حقل واحد على الأقل. السمة الجذر "properties" ضمنية ولا يجب تحديدها. يمكن استخدام رمز `"*"` واحد كاختصار لعرض كل حقل.

properties

object (SpreadsheetProperties)

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

fields

string (FieldMask format)

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

UpdateSheetPropertiesRequest

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

تمثيل JSON
{ "properties": { object (`SheetProperties`) }, "fields": string }

الحقول

الحقول
`properties`	`object (SheetProperties)` السمات المطلوب تعديلها
`fields`	`string (FieldMask format)` الحقول التي يجب تعديلها يجب تحديد حقل واحد على الأقل. يتم تضمين الجذر `properties` ولا يجب تحديده. يمكن استخدام رمز `"*"` واحد كاختصار لعرض كل حقل.

properties

object (SheetProperties)

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

fields

string (FieldMask format)

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

UpdateDimensionPropertiesRequest

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

تمثيل JSON

تمثيل 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,

  // 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)` الأعمدة في ورقة بيانات مصدر البيانات

sheetId

integer

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

columnReferences[]

object (DataSourceColumnReference)

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

UpdateNamedRangeRequest

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

تمثيل JSON
{ "namedRange": { object (`NamedRange`) }, "fields": string }

الحقول

الحقول
`namedRange`	`object (NamedRange)` النطاق المُعنوَن المطلوب تعديله باستخدام السمات الجديدة
`fields`	`string (FieldMask format)` الحقول التي يجب تعديلها يجب تحديد حقل واحد على الأقل. يتم تضمين الجذر `namedRange` ولا يجب تحديده. يمكن استخدام رمز `"*"` واحد كاختصار لعرض كل حقل.

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` ولا يجب تحديده. يمكن استخدام رمز `"*"` واحد كاختصار لعرض كل حقل.

range

object (GridRange)

النطاق الذي ستتمّ فيه تكرار الخلية

cell

object (CellData)

البيانات المطلوب كتابتها

fields

string (FieldMask format)

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

AddNamedRangeRequest

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

تمثيل JSON
{ "namedRange": { object (`NamedRange`) } }

الحقول

الحقول
`namedRange`	`object (NamedRange)` النطاق المُعنوَن المطلوب إضافته الحقل `namedRangeId` اختياري. في حال عدم ضبطه، سيتم إنشاء معرّف عشوائيًا. (يحدث خطأ عند تحديد رقم تعريف نطاق متوفّر من قبل).

namedRange

object (NamedRange)

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

DeleteNamedRangeRequest

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

تمثيل JSON
{ "namedRangeId": string }

الحقول

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

namedRangeId

string

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

AddSheetRequest

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

تمثيل JSON
{ "properties": { object (`SheetProperties`) } }

الحقول

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

properties

object (SheetProperties)

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

DeleteSheetRequest

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

تمثيل JSON
{ "sheetId": integer }

الحقول

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

sheetId

integer

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

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

AutoFillRequest

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

تمثيل JSON

تمثيل 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,

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

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)` نوع البيانات التي تريد لصقها سيتم قطع جميع بيانات المصدر، بغض النظر عما يتم لصقه.

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)` كيفية دمج الخلايا

range

object (GridRange)

نطاق الخلايا المطلوب دمجه

mergeType

enum (MergeType)

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

MergeType

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

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

UnmergeCellsRequest

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

تمثيل JSON
{ "range": { object (`GridRange`) } }

الحقول

الحقول
`range`	`object (GridRange)` النطاق الذي يجب إلغاء دمج جميع الخلايا فيه إذا كان النطاق يشمل عمليات دمج متعددة، سيتم إلغاء دمج الكل. يجب ألا يمتد النطاق جزئيًا إلى أي عملية دمج.

range

object (GridRange)

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

UpdateBordersRequest

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

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

سيؤدي ذلك إلى ظهور حدود { top: RED, bottom: WHITE, left: BLUE } في A1:A5. إذا كنت تريد محو حدود، اضبط النمط صراحةً على NONE.

تمثيل JSON

تمثيل 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)
  }
}

الحقول
`range`	`object (GridRange)` النطاق الذي يجب تعديل حدوده
`top`	`object (Border)` الحدّ الذي سيتم وضعه في أعلى النطاق
`bottom`	`object (Border)` الحدّ الذي سيتم وضعه في أسفل النطاق
`left`	`object (Border)` الحدّ الذي سيتم وضعه على يمين النطاق
`right`	`object (Border)` الحدّ الذي سيتم وضعه على يسار النطاق
`innerHorizontal`	`object (Border)` الحدود الأفقية التي سيتم وضعها داخل النطاق
`innerVertical`	`object (Border)` الحدّ العمودي الذي سيتم وضعه داخل النطاق

UpdateCellsRequest

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

تمثيل JSON

تمثيل 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,

  // 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` اختياري. في حال عدم ضبطه، سيتم إنشاء معرّف عشوائيًا. (يحدث خطأ عند تحديد رقم تعريف فلتر متوفّر من قبل).

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". يمكن استخدام رمز `"*"` واحد كاختصار لعرض كل حقل.

sheetId

integer

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

rows[]

object (RowData)

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

fields

string (FieldMask format)

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

ClearBasicFilterRequest

تمحو هذه العملية الفلتر الأساسي، في حال توفّره في الورقة.

تمثيل JSON
{ "sheetId": integer }

الحقول

الحقول
`sheetId`	`integer` رقم تعريف ورقة البيانات التي يجب محو الفلتر الأساسي منها

sheetId

integer

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

DeleteDimensionRequest

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

تمثيل JSON
{ "range": { object (`DimensionRange`) } }

الحقول

الحقول
`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` صحيح إذا كان البحث حسّاسًا لحالة الأحرف.
`matchEntireCell`	`boolean` صحيح إذا كان يجب أن تتطابق قيمة البحث مع الخلية بأكملها.
`searchByRegex`	`boolean` صحيحة إذا كانت قيمة البحث عبارة عن تعبير عادي. يجب أن يتّبع التعبير العادي والاستبدال قواعد التعبير العادي في Java على الرابط 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` صحيح إذا كان البحث يجب أن يتضمّن خلايا تحتوي على صِيَغ. خطأ لتخطّي الخلايا التي تحتوي على صِيَغ
حقل الربط `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` صحيح إذا كانت البيانات بتنسيق HTML.

TextToColumnsRequest

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

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

الحقول

source

object (GridRange)

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

delimiter

string

المُحدِّد المراد استخدامه. لا يتم استخدامها إلا إذا كان نوع المُحدِّد هو 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`) }, "filteredRowsIncluded": boolean }

الحقول

range

object (GridRange)

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

rule

object (DataValidationRule)

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

filteredRowsIncluded

boolean

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

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

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

على سبيل المثال، لنفترض أنّ ورقة البيانات تحتوي على مجموعة من المستوى 1 على B:E ومجموعة من المستوى 2 على C:D. يؤدي حذف مجموعة على D:E إلى ترك ورقة البيانات مع مجموعة من المستوى 1 على B:D ومجموعة من المستوى 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 ويتم بدء التنفيذ لإعادة تحميل ورقة البيانات من أجل قراءة البيانات من مصدر البيانات.

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

تمثيل JSON
{ "dataSource": { object (`DataSource`) } }

الحقول

dataSource

object (DataSource)

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

UpdateDataSourceRequest

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

يتطلب الطلب نطاق OAuth إضافيًا bigquery.readonly إذا كنت تعدِّل مصدر بيانات 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` تلغي جميع عمليات إعادة تحميل عناصر مصدر البيانات الحالية لجميع مصادر البيانات في جدول البيانات.