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)
  },
  "addTable": {
    object (AddTableRequest)
  },
  "updateTable": {
    object (UpdateTableRequest)
  },
  "deleteTable": {
    object (DeleteTableRequest)
  }
  // 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)

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

cancelDataSourceRefresh

object (CancelDataSourceRefreshRequest)

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

addTable

object (AddTableRequest)

تضيف هذه الطريقة جدولاً.

updateTable

object (UpdateTableRequest)

تعديل جدول

deleteTable

object (DeleteTableRequest)

طلب حذف جدول

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

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

حقل الدمج 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,

  // Union field area can be only one of the following:
  "tableId": string
  // End of list of possible types for union field area.
}
الحقول
sheetId

integer

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

rows[]

object (RowData)

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

fields

string (FieldMask format)

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

حقل الدمج area. يجب كتابة بيانات الموقع الجغرافي. area يمكن أن تكون إحدى القيم التالية فقط:
tableId

string

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

ويكون لهذا الحقل أيضًا الأولوية على الحقل sheetId.

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

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

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 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

قيمة منطقية تحدّد ما إذا كان يجب أن يشمل البحث الخلايا التي تحتوي على صيغ. يجب ضبط القيمة على "خطأ" لتخطّي الخلايا التي تحتوي على صيغ.

حقل الدمج 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

المُحدِّد المطلوب استخدامه. يُستخدَم فقط إذا كانت قيمة 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

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

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, depth 1] + [C:D] إلى المجموعتين [B:E, depth 1] و[C:D, depth 2]. إذا كان النطاق المطلوب يبدأ قبل نطاق المجموعة الحالية G وينتهي ضمنه، أو يبدأ ضمنه وينتهي بعده، يصبح نطاق المجموعة الحالية G هو اتحاد النطاقات، ويصبح عمق المجموعة الجديدة G' أكبر من عمق المجموعة G بمقدار واحد، ويصبح نطاقها هو تقاطع النطاقات. على سبيل المثال، تؤدي المجموعة [B:D، العمق 1] + [C:E] إلى المجموعتين [B:E، العمق 1] و[C:D، العمق 2].

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

object (DimensionRange)

النطاق الذي سيتم إنشاء مجموعة فيه.

DeleteDimensionGroupRequest

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

على سبيل المثال، لنفترض أنّ ورقة البيانات تحتوي على مجموعة بمستوى واحد فوق النطاق B:E ومجموعة بمستويَين فوق النطاق 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.bigquery.readonly

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

object (DataSource)

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

fields

string (FieldMask format)

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

DeleteDataSourceRequest

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

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

string

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

RefreshDataSourceRequest

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

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

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

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

المراجع

DataSourceObjectReference

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

تمثيل JSON 
{

  // Union field value can be only one of the following:
  "sheetId": string,
  "chartId": integer,
  "dataSourceTableAnchorCell": {
    object (GridCoordinate)
  },
  "dataSourcePivotTableAnchorCell": {
    object (GridCoordinate)
  },
  "dataSourceFormulaCell": {
    object (GridCoordinate)
  }
  // End of list of possible types for union field value.
}
الحقول
حقل الدمج value. نوع المرجع value يمكن أن تكون إحدى القيم التالية فقط:
sheetId

string

الإشارات إلى ورقة DATA_SOURCE

chartId

integer

إشارات إلى رسم بياني لمصدر بيانات

dataSourceTableAnchorCell

object (GridCoordinate)

إشارات إلى DataSourceTable مثبّتة في الخلية.

dataSourcePivotTableAnchorCell

object (GridCoordinate)

مراجع إلى مصدر بيانات PivotTable مثبّتة في الخلية

dataSourceFormulaCell

object (GridCoordinate)

مراجع إلى خلية تحتوي على DataSourceFormula

CancelDataSourceRefreshRequest

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

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

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

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

AddTableRequest

تضيف هذه الدالة جدولاً جديدًا إلى جدول البيانات.

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

object (Table)

الحقل مطلوب. الجدول المطلوب إضافته

UpdateTableRequest

تعدِّل هذه الطريقة جدولاً في جدول البيانات.

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

object (Table)

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

fields

string (FieldMask format)

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

DeleteTableRequest

يزيل هذا الإجراء الجدول الذي يحمل المعرّف المحدّد من جدول البيانات.

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

string

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