Responses

الردّ

ردّ واحد من تحديث

تمثيل JSON 
{

  "addNamedRange": {
    object (AddNamedRangeResponse)
  },
  "addSheet": {
    object (AddSheetResponse)
  },
  "addFilterView": {
    object (AddFilterViewResponse)
  },
  "duplicateFilterView": {
    object (DuplicateFilterViewResponse)
  },
  "duplicateSheet": {
    object (DuplicateSheetResponse)
  },
  "findReplace": {
    object (FindReplaceResponse)
  },
  "updateEmbeddedObjectPosition": {
    object (UpdateEmbeddedObjectPositionResponse)
  },
  "updateConditionalFormatRule": {
    object (UpdateConditionalFormatRuleResponse)
  },
  "deleteConditionalFormatRule": {
    object (DeleteConditionalFormatRuleResponse)
  },
  "addProtectedRange": {
    object (AddProtectedRangeResponse)
  },
  "addChart": {
    object (AddChartResponse)
  },
  "addBanding": {
    object (AddBandingResponse)
  },
  "createDeveloperMetadata": {
    object (CreateDeveloperMetadataResponse)
  },
  "updateDeveloperMetadata": {
    object (UpdateDeveloperMetadataResponse)
  },
  "deleteDeveloperMetadata": {
    object (DeleteDeveloperMetadataResponse)
  },
  "addDimensionGroup": {
    object (AddDimensionGroupResponse)
  },
  "deleteDimensionGroup": {
    object (DeleteDimensionGroupResponse)
  },
  "trimWhitespace": {
    object (TrimWhitespaceResponse)
  },
  "deleteDuplicates": {
    object (DeleteDuplicatesResponse)
  },
  "addSlicer": {
    object (AddSlicerResponse)
  },
  "addDataSource": {
    object (AddDataSourceResponse)
  },
  "updateDataSource": {
    object (UpdateDataSourceResponse)
  },
  "refreshDataSource": {
    object (RefreshDataSourceResponse)
  },
  "cancelDataSourceRefresh": {
    object (CancelDataSourceRefreshResponse)
  },
  "addTable": {
    object (AddTableResponse)
  }
}
الحقول
حقل الربط kind تمثّل هذه السمة نوع الردّ. قد لا يتم ضبط أي حقول إذا لم يتضمّن الطلب أي ردّ. يمكن أن يكون kind إحدى القيم التالية فقط:
addNamedRange

object (AddNamedRangeResponse)

ردّ من إضافة نطاق مُعنوَن.
addSheet

object (AddSheetResponse)

ردّ من إضافة ورقة

addFilterView

object (AddFilterViewResponse)

ردّ من إضافة عرض فلتر

duplicateFilterView

object (DuplicateFilterViewResponse)

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

duplicateSheet

object (DuplicateSheetResponse)

ردّ من تكرار ورقة

findReplace

object (FindReplaceResponse)

ردّ من عملية بحث واستبدال

updateEmbeddedObjectPosition

object (UpdateEmbeddedObjectPositionResponse)

ردّ من تعديل موضع عنصر مضمّن

updateConditionalFormatRule

object (UpdateConditionalFormatRuleResponse)

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

deleteConditionalFormatRule

object (DeleteConditionalFormatRuleResponse)

ردّ من حذف قاعدة تنسيق شرطي

addProtectedRange

object (AddProtectedRangeResponse)

ردّ من إضافة نطاق محميّ

addChart

object (AddChartResponse)

ردّ من إضافة رسم بياني

addBanding

object (AddBandingResponse)

ردّ من إضافة نطاق مقسَّم إلى شرائح

createDeveloperMetadata

object (CreateDeveloperMetadataResponse)

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

updateDeveloperMetadata

object (UpdateDeveloperMetadataResponse)

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

deleteDeveloperMetadata

object (DeleteDeveloperMetadataResponse)

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

addDimensionGroup

object (AddDimensionGroupResponse)

ردّ من إضافة مجموعة سمات

deleteDimensionGroup

object (DeleteDimensionGroupResponse)

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

trimWhitespace

object (TrimWhitespaceResponse)

ردّ من عملية إزالة المسافات البيضاء

deleteDuplicates

object (DeleteDuplicatesResponse)

ردّ من إزالة الصفوف التي تحتوي على قيم مكرّرة

addSlicer

object (AddSlicerResponse)

ردّ من إضافة أداة التقطيع

addDataSource

object (AddDataSourceResponse)

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

updateDataSource

object (UpdateDataSourceResponse)

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

refreshDataSource

object (RefreshDataSourceResponse)

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

cancelDataSourceRefresh

object (CancelDataSourceRefreshResponse)

ردّ من إلغاء عمليات إعادة تحميل عناصر مصدر البيانات

addTable

object (AddTableResponse)

ردّ من إضافة جدول

DataSourceObjectReference

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

تمثيل JSON 
{

  "sheetId": string,
  "chartId": integer,
  "dataSourceTableAnchorCell": {
    object (GridCoordinate)
  },
  "dataSourcePivotTableAnchorCell": {
    object (GridCoordinate)
  },
  "dataSourceFormulaCell": {
    object (GridCoordinate)
  }
}
الحقول
حقل الربط value نوع المرجع يمكن أن يكون value إحدى القيم التالية فقط:
sheetId

string

مراجع إلى DATA_SOURCE ورقة بيانات.
chartId

integer

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

dataSourceTableAnchorCell

object (GridCoordinate)

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

dataSourcePivotTableAnchorCell

object (GridCoordinate)

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

dataSourceFormulaCell

object (GridCoordinate)

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

AddNamedRangeResponse

نتيجة إضافة نطاق مُعنوَن.

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

object (NamedRange)

النطاق المُعنوَن المطلوب إضافته

AddSheetResponse

نتيجة إضافة ورقة بيانات.

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

object (SheetProperties)

خصائص الورقة المضافة حديثًا

AddFilterViewResponse

نتيجة إضافة عرض فلتر

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

object (FilterView)

عرض الفلتر الذي تمت إضافته حديثًا

DuplicateFilterViewResponse

نتيجة تكرار عرض الفلتر

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

object (FilterView)

الفلتر الذي تم إنشاؤه حديثًا

DuplicateSheetResponse

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

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

object (SheetProperties)

خصائص الورقة المكرّرة

FindReplaceResponse

نتيجة البحث والاستبدال

تمثيل JSON 
{
  "valuesChanged": integer,
  "formulasChanged": integer,
  "rowsChanged": integer,
  "sheetsChanged": integer,
  "occurrencesChanged": integer
}
الحقول
valuesChanged

integer

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

formulasChanged

integer

تغيّر عدد خلايا الصيغة.

rowsChanged

integer

عدد الصفوف التي تم تغييرها

sheetsChanged

integer

تغيّر عدد الأوراق.

occurrencesChanged

integer

تغيّر عدد مرات الظهور (ربما عدة مرات داخل الخلية). على سبيل المثال، إذا أردنا استبدال "e" بـ "o" في "Google Sheets"، سيصبح الناتج "3" لأنّ "Google Sheets" -> "Googlo Shoots".

UpdateEmbeddedObjectPositionResponse

نتيجة تعديل موضع كائن مضمّن

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

object (EmbeddedObjectPosition)

الموضع الجديد للعنصر المضمّن

UpdateConditionalFormatRuleResponse

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

تمثيل JSON 
{
  "newRule": {
    object (ConditionalFormatRule)
  },
  "newIndex": integer,

  "oldRule": {
    object (ConditionalFormatRule)
  },
  "oldIndex": integer
}
الحقول
newRule

object (ConditionalFormatRule)

القاعدة الجديدة التي حلّت محل القاعدة القديمة (في حال الاستبدال)، أو القاعدة التي تم نقلها (في حال النقل)

newIndex

integer

فهرس القاعدة الجديدة

حقل الربط old_info معلومات حول القاعدة السابقة يمكن أن يكون old_info إحدى القيم التالية فقط:
oldRule

object (ConditionalFormatRule)

القاعدة القديمة (المحذوفة) لا يتم ضبطها إذا تم نقل قاعدة (لأنّها تكون مماثلة لـ newRule).

oldIndex

integer

الفهرس القديم للقاعدة. لا يتم ضبطها إذا تم استبدال قاعدة (لأنّها مماثلة لـ newIndex).

DeleteConditionalFormatRuleResponse

نتيجة حذف قاعدة تنسيق شرطي

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

object (ConditionalFormatRule)

القاعدة التي تم حذفها

AddProtectedRangeResponse

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

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

object (ProtectedRange)

النطاق المحميّ الذي تمت إضافته حديثًا

AddChartResponse

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

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

object (EmbeddedChart)

الرسم البياني الذي تمت إضافته مؤخرًا

AddBandingResponse

نتيجة إضافة نطاق ذي ألوان متناوبة

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

object (BandedRange)

نطاق الصفوف المتناوبة الذي تمت إضافته

CreateDeveloperMetadataResponse

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

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

object (DeveloperMetadata)

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

UpdateDeveloperMetadataResponse

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

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

object (DeveloperMetadata)

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

DeleteDeveloperMetadataResponse

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

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

object (DeveloperMetadata)

البيانات الوصفية التي تم حذفها

AddDimensionGroupResponse

نتيجة إضافة مجموعة

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

object (DimensionGroup)

جميع مجموعات السمة بعد إضافة مجموعة إلى تلك السمة

DeleteDimensionGroupResponse

نتيجة حذف مجموعة

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

object (DimensionGroup)

جميع مجموعات السمة بعد حذف مجموعة من تلك السمة

TrimWhitespaceResponse

نتيجة إزالة المسافات البيضاء في الخلايا

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

integer

عدد الخلايا التي تمت إزالة المسافة البيضاء منها.

DeleteDuplicatesResponse

نتيجة إزالة القيم المكرّرة في نطاق

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

integer

عدد الصفوف المكرّرة التي تمت إزالتها

AddSlicerResponse

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

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

object (Slicer)

فلتر نطاق البيانات الذي تمت إضافته حديثًا.

AddDataSourceResponse

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

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

object (DataSource)

مصدر البيانات الذي تم إنشاؤه

dataExecutionStatus

object (DataExecutionStatus)

تمثّل هذه السمة حالة تنفيذ البيانات.

UpdateDataSourceResponse

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

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

object (DataSource)

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

dataExecutionStatus

object (DataExecutionStatus)

تمثّل هذه السمة حالة تنفيذ البيانات.

RefreshDataSourceResponse

الردّ من إعادة تحميل عنصر واحد أو أكثر من عناصر مصدر البيانات

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

object (RefreshDataSourceObjectExecutionStatus)

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

RefreshDataSourceObjectExecutionStatus

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

تمثيل JSON 
{
  "reference": {
    object (DataSourceObjectReference)
  },
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
الحقول
reference

object (DataSourceObjectReference)

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

dataExecutionStatus

object (DataExecutionStatus)

تمثّل هذه السمة حالة تنفيذ البيانات.

CancelDataSourceRefreshResponse

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

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

object (CancelDataSourceRefreshStatus)

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

CancelDataSourceRefreshStatus

حالة إلغاء إعادة تحميل عنصر واحد من عناصر مصدر البيانات

تمثيل JSON 
{
  "reference": {
    object (DataSourceObjectReference)
  },
  "refreshCancellationStatus": {
    object (RefreshCancellationStatus)
  }
}
الحقول
reference

object (DataSourceObjectReference)

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

refreshCancellationStatus

object (RefreshCancellationStatus)

حالة الإلغاء

RefreshCancellationStatus

حالة إلغاء عملية إعادة تحميل البيانات.

يمكنك إرسال cancel request لإلغاء عملية إعادة تحميل واحدة أو أكثر من عمليات إعادة تحميل عناصر مصدر البيانات بشكل صريح.

تمثيل JSON 
{
  "state": enum (RefreshCancellationState),
  "errorCode": enum (RefreshCancellationErrorCode)
}
الحقول
state

enum (RefreshCancellationState)

حالة طلب إلغاء إعادة التحميل في "جداول بيانات Google".

errorCode

enum (RefreshCancellationErrorCode)

رمز الخطأ

RefreshCancellationState

تعداد لحالات إلغاء إعادة التحميل.

عمليات التعداد
REFRESH_CANCELLATION_STATE_UNSPECIFIED القيمة التلقائية، لا تستخدِمها.
CANCEL_SUCCEEDED نجح طلب البيانات من واجهة برمجة التطبيقات إلى "جداول بيانات Google" لإلغاء إعادة التحميل. لا يعني هذا أنّ عملية الإلغاء تمت بنجاح، بل يعني أنّ المكالمة قد تمت بنجاح.
CANCEL_FAILED تعذّر إكمال طلب البيانات من واجهة برمجة التطبيقات إلى "جداول بيانات Google" لإلغاء إعادة التحميل.

RefreshCancellationErrorCode

تعداد لرموز أخطاء إلغاء إعادة التحميل.

عمليات التعداد
REFRESH_CANCELLATION_ERROR_CODE_UNSPECIFIED القيمة التلقائية، لا تستخدِمها.
EXECUTION_NOT_FOUND لم يتم العثور على عملية التنفيذ المطلوب إلغاؤها في محرك طلب البحث أو في "جداول بيانات Google".
CANCEL_PERMISSION_DENIED لا يملك المستخدم الإذن بإلغاء طلب البحث.
QUERY_EXECUTION_COMPLETED اكتمل تنفيذ طلب البحث، وبالتالي تعذّر إلغاؤه.
CONCURRENT_CANCELLATION هناك عملية إلغاء أخرى قيد المعالجة حاليًا.
CANCEL_OTHER_ERROR جميع الأخطاء الأخرى

AddTableResponse

نتيجة إضافة جدول

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

object (Table)

النتائج فقط. الجدول الذي تمت إضافته