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)
  }
  // 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 المرتبطة بها.

طلب تعديل جدول البيانات

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

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

object (SpreadsheetProperties)

السمات المراد تعديلها.

fields

string (FieldMask format)

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

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

تعدِّل سمات جدول البيانات باستخدام السمة sheetId المحدَّدة.

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

object (SheetProperties)

السمات المراد تعديلها.

fields

string (FieldMask format)

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

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

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

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

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

سلسلة بيانات مصدر البيانات

نطاق على طول سمة واحدة في ورقة DATA_SOURCE.

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

integer

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

columnReferences[]

object (DataSourceColumnReference)

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

تحديثNameRanRanRequest

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

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

object (NamedRange)

النطاق المُعَدّل لتعديله باستخدام السمات الجديدة.

fields

string (FieldMask format)

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

طلب تكرار الخلية

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

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

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

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

object (GridRange)

النطاق لتكرار الخلية.

cell

object (CellData)

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

fields

string (FieldMask format)

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

طلب إضافة اسم الاسم

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

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

object (NamedRange)

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

حذفNameNameRangeRequest

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

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

string

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

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

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

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

object (SheetProperties)

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

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

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

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

integer

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

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

طلب الملء التلقائي

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

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

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

قص ولصق الطلب

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

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

object (GridRange)

البيانات المصدر التي سيتم اقتصاصها

destination

object (GridCoordinate)

الإحداثيات الموجودة في أعلى يمين الشاشة حيث يجب لصق البيانات.

pasteType

enum (PasteType)

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

نوع اللصق

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

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

نسخ طلب اللصق

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

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

كيف يجب أن تكون هذه البيانات موجّهة عند اللصق؟

لصق الاتجاه

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

عمليات التعداد
NORMAL لصق المحتوى بشكل طبيعي:
TRANSPOSE تم لصق المحوِّل، حيث تتحوّل جميع الصفوف إلى أعمدة والعكس صحيح.

طلب دمج الخلايا

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

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

object (GridRange)

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

mergeType

enum (MergeType)

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

نوع الدمج

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

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

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

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

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

object (GridRange)

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

طلب تعديل الحدود

تعدِّل حدود نطاق ما. في حال عدم ضبط حقل في الطلب، يعني ذلك أنّ الحدود ستظل كما هي. على سبيل المثال، مع تحديثَي 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)

الحد الرأسي لوضعه داخل النطاق.

تعديل الخلايا

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

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

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

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

object (GridCoordinate)

التنسيق المطلوب لبدء كتابة البيانات على يمكن كتابة أي عدد من الصفوف والأعمدة (بما في ذلك عدد مختلف من الأعمدة لكل صف).

range

object (GridRange)

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

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

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

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

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

object (FilterView)

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

ملحق الخلايا

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

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

integer

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

rows[]

object (RowData)

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

fields

string (FieldMask format)

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

طلب_محو_الفلتر الأساسي

لمحو الفلتر الأساسي، في حال توفّره.

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

integer

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

حذف طلب

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

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

object (DimensionRange)

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

حذف،ObjectObjectRequest

حذف العنصر المضمّن باستخدام المعرّف المحدّد

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

integer

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

حذف RequestViewView

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

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

integer

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

طلب عرض مكرر

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

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

integer

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

طلب نسخة طبق الأصل

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

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

integer

الورقة مكررة.

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

insertSheetIndex

integer

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

newSheetId

integer

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

newSheetName

string

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

طلب الاستبدال

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

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

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

includeFormulas

boolean

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

حقل الاتحاد scope. النطاق الذي يمكن العثور عليه/استبداله، يجب ضبط نطاق واحد فقط. يمكن أن تكون السمة scope واحدة فقط من العناصر التالية:
range

object (GridRange)

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

sheetId

integer

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

allSheets

boolean

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

طلب الإدراج

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

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

object (DimensionRange)

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

inheritFromBefore

boolean

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

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

طلب الإدراج

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

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

object (GridRange)

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

shiftDimension

enum (Dimension)

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

طلب البُعد

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

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

تعديلطلب IncludeObjectPositionRequest

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

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

لصق بيانات

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

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

طلب النص إلى الأعمدة

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

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

object (GridRange)

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

delimiter

string

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

delimiterType

enum (DelimiterType)

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

نوع المُحدِّد

المُحدِّد للتقسيم عليه.

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

تعديلطلب الفلتر

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

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

object (FilterView)

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

fields

string (FieldMask format)

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

طلب حذف النطاق

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

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

object (GridRange)

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

shiftDimension

enum (Dimension)

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

طلب الملحق

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

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

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

تعديل الشرط الشرطيالطلب

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

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

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

طلب الترتيب

لترتيب البيانات في صفوف بناءً على ترتيب الترتيب لكل عمود.

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

object (GridRange)

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

sortSpecs[]

object (SortSpec)

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

طلب SetDatavalidation

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

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

object (GridRange)

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

rule

object (DataValidationRule)

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

طلب ضبط الفلتر الأساسي

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

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

object (BasicFilter)

الفلتر الذي يمكن ضبطه

طلب إضافة ProtectProtectedRange

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

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

object (ProtectedRange)

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

تحديث RequestProtectedRange

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

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

object (ProtectedRange)

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

fields

string (FieldMask format)

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

حذف RequestProtectedRange

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

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

integer

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

طلب تغيير الحجم التلقائي

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

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

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

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

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

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

object (EmbeddedChart)

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

طلب تعديل الرسم البياني

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

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

integer

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

spec

object (ChartSpec)

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

تعديل طلب الحظر

تعدِّل خصائص النطاق المتعدد المُزوَّد.

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

object (BandedRange)

النطاق المعدَّل المراد تعديله باستخدام السمات الجديدة.

fields

string (FieldMask format)

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

طلب إضافة حظر

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

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

object (BandedRange)

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

حذف طلب حظر

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

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

integer

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

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

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

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

object (DeveloperMetadata)

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

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

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

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

object (DataFilter)

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

developerMetadata

object (DeveloperMetadata)

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

fields

string (FieldMask format)

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

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

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

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

object (DataFilter)

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

ترتيب عشوائي لطلب البحث

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

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

object (GridRange)

النطاق العشوائي.

طلب إضافة مجموعة

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

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

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

object (DimensionRange)

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

حذف مجموعة المجموعة

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

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

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

object (DimensionRange)

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

تعديل طلب مجموعة

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

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

object (DimensionGroup)

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

fields

string (FieldMask format)

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

طلب القطع بالأبيض

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

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

object (GridRange)

النطاق الذي تريد قطع خلاياه

حذف الأموال المكررة

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

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

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

object (GridRange)

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

comparisonColumns[]

object (DimensionRange)

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

تعديل RequestObjectBorderRequest المُضمَّن

تعدِّل هذه السمة سمة الحدود للعنصر المضمَّن.

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

integer

رقم تعريف العنصر المضمّن المراد تعديله

border

object (EmbeddedObjectBorder)

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

fields

string (FieldMask format)

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

طلب إضافة

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

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

object (Slicer)

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

تعديلSlicerspecRequest

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

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

integer

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

spec

object (SlicerSpec)

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

fields

string (FieldMask format)

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

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

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

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

object (DataSource)

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

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

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

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

object (DataSource)

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

fields

string (FieldMask format)

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

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

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

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

string

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

طلب إعادة تحميل البيانات المصدر

تتم إعادة تحميل عنصر واحد أو أكثر من عناصر مصدر البيانات في جدول البيانات من خلال المراجع المحدّدة. يتطلب الطلب نطاق OAuth إضافيًا 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

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

مراجع البيانات

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

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

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