Requests

الطلب

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

تمثيل JSON 
{

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

object (UpdateSpreadsheetPropertiesRequest)

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

updateSheetProperties

object (UpdateSheetPropertiesRequest)

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

updateDimensionProperties

object (UpdateDimensionPropertiesRequest)

يعدِّل سمات السمات.

updateNamedRange

object (UpdateNamedRangeRequest)

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

repeatCell

object (RepeatCellRequest)

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

addNamedRange

object (AddNamedRangeRequest)

لإضافة نطاق مُعنوَن.

deleteNamedRange

object (DeleteNamedRangeRequest)

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

addSheet

object (AddSheetRequest)

لإضافة ورقة.

deleteSheet

object (DeleteSheetRequest)

لحذف ورقة.

autoFill

object (AutoFillRequest)

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

cutPaste

object (CutPasteRequest)

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

copyPaste

object (CopyPasteRequest)

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

mergeCells

object (MergeCellsRequest)

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

unmergeCells

object (UnmergeCellsRequest)

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

updateBorders

object (UpdateBordersRequest)

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

updateCells

object (UpdateCellsRequest)

تحدّث العديد من الخلايا في آنٍ واحد.

addFilterView

object (AddFilterViewRequest)

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

appendCells

object (AppendCellsRequest)

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

clearBasicFilter

object (ClearBasicFilterRequest)

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

deleteDimension

object (DeleteDimensionRequest)

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

deleteEmbeddedObject

object (DeleteEmbeddedObjectRequest)

حذف عنصر مضمّن (على سبيل المثال، رسم بياني أو صورة) في ورقة بيانات

deleteFilterView

object (DeleteFilterViewRequest)

لحذف عرض فلتر من ورقة.

duplicateFilterView

object (DuplicateFilterViewRequest)

تكرار عرض فلتر

duplicateSheet

object (DuplicateSheetRequest)

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

findReplace

object (FindReplaceRequest)

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

insertDimension

object (InsertDimensionRequest)

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

insertRange

object (InsertRangeRequest)

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

moveDimension

object (MoveDimensionRequest)

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

updateEmbeddedObjectPosition

object (UpdateEmbeddedObjectPositionRequest)

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

pasteData

object (PasteDataRequest)

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

textToColumns

object (TextToColumnsRequest)

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

updateFilterView

object (UpdateFilterViewRequest)

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

deleteRange

object (DeleteRangeRequest)

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

appendDimension

object (AppendDimensionRequest)

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

addConditionalFormatRule

object (AddConditionalFormatRuleRequest)

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

updateConditionalFormatRule

object (UpdateConditionalFormatRuleRequest)

لتعديل قاعدة تنسيق شرطي حالية

deleteConditionalFormatRule

object (DeleteConditionalFormatRuleRequest)

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

sortRange

object (SortRangeRequest)

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

setDataValidation

object (SetDataValidationRequest)

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

setBasicFilter

object (SetBasicFilterRequest)

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

addProtectedRange

object (AddProtectedRangeRequest)

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

updateProtectedRange

object (UpdateProtectedRangeRequest)

يحدّث نطاقًا محميًا.

deleteProtectedRange

object (DeleteProtectedRangeRequest)

لحذف نطاق محمي.

autoResizeDimensions

object (AutoResizeDimensionsRequest)

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

addChart

object (AddChartRequest)

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

updateChartSpec

object (UpdateChartSpecRequest)

لتعديل مواصفات الرسم البياني

updateBanding

object (UpdateBandingRequest)

لتعديل نطاق بنطاق ترددي

addBanding

object (AddBandingRequest)

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

deleteBanding

object (DeleteBandingRequest)

إزالة نطاق ذي نطاق ترددي

createDeveloperMetadata

object (CreateDeveloperMetadataRequest)

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

updateDeveloperMetadata

object (UpdateDeveloperMetadataRequest)

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

deleteDeveloperMetadata

object (DeleteDeveloperMetadataRequest)

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

randomizeRange

object (RandomizeRangeRequest)

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

addDimensionGroup

object (AddDimensionGroupRequest)

ينشئ مجموعة في النطاق المحدد.

deleteDimensionGroup

object (DeleteDimensionGroupRequest)

حذف مجموعة خلال النطاق المحدد

updateDimensionGroup

object (UpdateDimensionGroupRequest)

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

trimWhitespace

object (TrimWhitespaceRequest)

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

deleteDuplicates

object (DeleteDuplicatesRequest)

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

updateEmbeddedObjectBorder

object (UpdateEmbeddedObjectBorderRequest)

لتحديث حد العنصر المضمّن.

addSlicer

object (AddSlicerRequest)

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

updateSlicerSpec

object (UpdateSlicerSpecRequest)

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

addDataSource

object (AddDataSourceRequest)

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

updateDataSource

object (UpdateDataSourceRequest)

لتعديل مصدر بيانات

deleteDataSource

object (DeleteDataSourceRequest)

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

refreshDataSource

object (RefreshDataSourceRequest)

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

cancelDataSourceRefresh

object (CancelDataSourceRefreshRequest)

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

UpdateSpreadsheetPropertiesRequest

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

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

object (SpreadsheetProperties)

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

fields

string (FieldMask format)

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

UpdateSheetPropertiesRequest

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

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

object (SheetProperties)

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

fields

string (FieldMask format)

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

UpdateDimensionPropertiesRequest

يحدّث خصائص الأبعاد ضمن النطاق المحدد.

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

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

object (DimensionProperties)

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

fields

string (FieldMask format)

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

حقل الاتحاد dimension_range. نطاق السمات. يمكن أن تكون السمة dimension_range واحدًا فقط مما يلي:
range

object (DimensionRange)

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

dataSourceSheetRange

object (DataSourceSheetDimensionRange)

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

DataSourceSheetDimensionRange

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

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

integer

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

columnReferences[]

object (DataSourceColumnReference)

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

UpdateNamedRangeRequest

تُعدِّل خصائص النطاق المُعنون باستخدام namedRangeId المحدَّد.

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

object (NamedRange)

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

fields

string (FieldMask format)

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

RepeatCellRequest

لتعديل جميع الخلايا في النطاق إلى القيم في كائن الخلية المحدّد ويتم فقط تعديل الحقول المدرَجة في الحقل fields، أما الحقول الأخرى، فلن يتم تعديلها.

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

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

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

object (GridRange)

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

cell

object (CellData)

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

fields

string (FieldMask format)

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

AddNamedRangeRequest

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

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

object (NamedRange)

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

DeleteNamedRangeRequest

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

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

string

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

AddSheetRequest

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

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

object (SheetProperties)

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

DeleteSheetRequest

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

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

integer

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

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

AutoFillRequest

يملأ المزيد من البيانات بناءً على البيانات الموجودة.

تمثيل JSON 
{
  "useAlternateSeries": boolean,

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

boolean

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

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

object (GridRange)

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

sourceAndDestination

object (SourceAndDestination)

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

SourceAndDestination

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

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

object (GridRange)

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

dimension

enum (Dimension)

السمة التي يجب ملء البيانات بها.

fillLength

integer

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

CutPasteRequest

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

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

object (GridRange)

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

destination

object (GridCoordinate)

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

pasteType

enum (PasteType)

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

PasteType

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

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

CopyPasteRequest

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

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

object (GridRange)

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

destination

object (GridRange)

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

pasteType

enum (PasteType)

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

pasteOrientation

enum (PasteOrientation)

كيف يجب توجيه هذه البيانات عند اللصق.

PasteOrientation

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

عمليات التعداد
NORMAL اللصق كالمعتاد.
TRANSPOSE لصق مع التحويل، حيث تصبح جميع الصفوف أعمدة والعكس صحيح.

MergeCellsRequest

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

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

object (GridRange)

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

mergeType

enum (MergeType)

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

MergeType

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

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

UnmergeCellsRequest

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

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

object (GridRange)

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

UpdateBordersRequest

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

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

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

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

object (GridRange)

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

top

object (Border)

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

bottom

object (Border)

الحد المطلوب وضعه أسفل النطاق.

left

object (Border)

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

right

object (Border)

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

innerHorizontal

object (Border)

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

innerVertical

object (Border)

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

UpdateCellsRequest

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

تمثيل JSON 
{
  "rows": [
    {
      object (RowData)
    }
  ],
  "fields": string,

  // Union field area can be only one of the following:
  "start": {
    object (GridCoordinate)
  },
  "range": {
    object (GridRange)
  }
  // End of list of possible types for union field area.
}
الحقول
rows[]

object (RowData)

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

fields

string (FieldMask format)

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

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

object (GridCoordinate)

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

range

object (GridRange)

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

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

AddFilterViewRequest

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

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

object (FilterView)

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

AppendCellsRequest

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

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

integer

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

rows[]

object (RowData)

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

fields

string (FieldMask format)

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

ClearBasicFilterRequest

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

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

integer

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

DeleteDimensionRequest

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

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

object (DimensionRange)

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

DeleteEmbeddedObjectRequest

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

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

integer

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

DeleteFilterViewRequest

حذف عرض فلتر معيّن.

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

integer

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

DuplicateFilterViewRequest

تكرار عرض فلتر معين.

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

integer

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

DuplicateSheetRequest

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

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

integer

الورقة المطلوب تكرارها.

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

insertSheetIndex

integer

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

newSheetId

integer

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

newSheetName

string

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

FindReplaceRequest

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

تمثيل JSON 
{
  "find": string,
  "replacement": string,
  "matchCase": boolean,
  "matchEntireCell": boolean,
  "searchByRegex": boolean,
  "includeFormulas": boolean,

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

string

قيمة البحث.

replacement

string

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

matchCase

boolean

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

matchEntireCell

boolean

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

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

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

حقل الاتحاد scope. النطاق الذي يتم البحث/استبداله - يجب تحديد نطاق واحد فقط. يمكن أن تكون السمة scope واحدًا فقط مما يلي:
range

object (GridRange)

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

sheetId

integer

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

allSheets

boolean

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

InsertDimensionRequest

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

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

object (DimensionRange)

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

inheritFromBefore

boolean

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

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

InsertRangeRequest

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

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

object (GridRange)

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

shiftDimension

enum (Dimension)

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

MoveDimensionRequest

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

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

object (DimensionRange)

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

destinationIndex

integer

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

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

UpdateEmbeddedObjectPositionRequest

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

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

integer

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

newPosition

object (EmbeddedObjectPosition)

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

fields

string (FieldMask format)

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

PasteDataRequest

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

تمثيل JSON 
{
  "coordinate": {
    object (GridCoordinate)
  },
  "data": string,
  "type": enum (PasteType),

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

object (GridCoordinate)

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

data

string

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

type

enum (PasteType)

الطريقة التي يجب لصق البيانات بها.

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

string

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

html

boolean

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

TextToColumnsRequest

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

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

object (GridRange)

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

delimiter

string

المحدِّد المطلوب استخدامه. ولا يتم استخدامها إلا إذا كانت قيمة delimiterType هي CUSTOM.

delimiterType

enum (DelimiterType)

نوع المحدِّد المطلوب استخدامه.

DelimiterType

المحدِّد المطلوب التقسيم بناءً عليه.

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

UpdateFilterViewRequest

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

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

object (FilterView)

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

fields

string (FieldMask format)

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

DeleteRangeRequest

حذف نطاق من الخلايا، ونقل الخلايا الأخرى إلى المنطقة المحذوفة

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

object (GridRange)

نطاق الخلايا المطلوب حذفه.

shiftDimension

enum (Dimension)

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

AppendDimensionRequest

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

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

integer

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

dimension

enum (Dimension)

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

length

integer

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

AddConditionalFormatRuleRequest

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

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

object (ConditionalFormatRule)

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

index

integer

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

UpdateConditionalFormatRuleRequest

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

تمثيل JSON 
{
  "index": integer,
  "sheetId": integer,

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

integer

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

sheetId

integer

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

حقل الاتحاد instruction. نوع التحديث الذي يجب أن يحدث. يمكن أن تكون السمة instruction واحدًا فقط مما يلي:
rule

object (ConditionalFormatRule)

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

newIndex

integer

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

DeleteConditionalFormatRuleRequest

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

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

integer

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

sheetId

integer

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

SortRangeRequest

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

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

object (GridRange)

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

sortSpecs[]

object (SortSpec)

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

SetDataValidationRequest

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

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

object (GridRange)

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

rule

object (DataValidationRule)

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

SetBasicFilterRequest

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

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

object (BasicFilter)

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

AddProtectedRangeRequest

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

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

object (ProtectedRange)

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

UpdateProtectedRangeRequest

تعمل هذه السياسة على تعديل نطاق محمي حالي باستخدام السمة protectedRangeId المحدّدة.

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

object (ProtectedRange)

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

fields

string (FieldMask format)

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

DeleteProtectedRangeRequest

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

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

integer

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

AutoResizeDimensionsRequest

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

تمثيل JSON 
{

  // Union field dimension_range can be only one of the following:
  "dimensions": {
    object (DimensionRange)
  },
  "dataSourceSheetDimensions": {
    object (DataSourceSheetDimensionRange)
  }
  // End of list of possible types for union field dimension_range.
}
الحقول
حقل الاتحاد dimension_range. نطاق السمات. يمكن أن تكون السمة dimension_range واحدًا فقط مما يلي:
dimensions

object (DimensionRange)

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

dataSourceSheetDimensions

object (DataSourceSheetDimensionRange)

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

AddChartRequest

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

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

object (EmbeddedChart)

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

UpdateChartSpecRequest

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

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

integer

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

spec

object (ChartSpec)

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

UpdateBandingRequest

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

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

object (BandedRange)

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

fields

string (FieldMask format)

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

AddBandingRequest

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

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

object (BandedRange)

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

DeleteBandingRequest

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

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

integer

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

CreateDeveloperMetadataRequest

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

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

object (DeveloperMetadata)

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

UpdateDeveloperMetadataRequest

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

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

object (DataFilter)

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

developerMetadata

object (DeveloperMetadata)

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

fields

string (FieldMask format)

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

DeleteDeveloperMetadataRequest

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

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

object (DataFilter)

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

RandomizeRangeRequest

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

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

object (GridRange)

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

AddDimensionGroupRequest

ينشئ مجموعة في النطاق المحدد.

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

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

object (DimensionRange)

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

DeleteDimensionGroupRequest

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

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

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

object (DimensionRange)

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

UpdateDimensionGroupRequest

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

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

object (DimensionGroup)

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

fields

string (FieldMask format)

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

TrimWhitespaceRequest

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

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

object (GridRange)

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

DeleteDuplicatesRequest

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

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

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

object (GridRange)

النطاق المطلوب إزالة الصفوف المكرّرة منه.

comparisonColumns[]

object (DimensionRange)

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

UpdateEmbeddedObjectBorderRequest

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

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

integer

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

border

object (EmbeddedObjectBorder)

الحد الذي ينطبق على الكائن المضمن.

fields

string (FieldMask format)

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

AddSlicerRequest

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

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

object (Slicer)

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

UpdateSlicerSpecRequest

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

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

integer

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

spec

object (SlicerSpec)

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

fields

string (FieldMask format)

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

AddDataSourceRequest

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

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

object (DataSource)

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

UpdateDataSourceRequest

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

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

object (DataSource)

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

fields

string (FieldMask format)

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

DeleteDataSourceRequest

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

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

string

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

RefreshDataSourceRequest

لإعادة تحميل عنصر واحد أو أكثر من عناصر مصدر البيانات في جدول البيانات حسب المراجع المحدّدة. يتطلب الطلب نطاق bigquery.readonly إضافيًا لبروتوكول OAuth.

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

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

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

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

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