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)
  },
  "insertComment": {
    object (InsertCommentResponse)
  },
  "addCommentReply": {
    object (AddCommentReplyResponse)
  }
}
الحقول
تمثّل هذه السمة نوع الردّ. قد لا يتم ضبط أي حقول إذا لم يتضمّن الطلب أي ردّ. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الرد:
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)

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

insertComment

object (InsertCommentResponse)

نتيجة إنشاء تعليق

addCommentReply

object (AddCommentReplyResponse)

نتيجة إنشاء رد

نهاية الحقول التي يستبعد كلّ منها الآخر

DataSourceObjectReference

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

تمثيل JSON 
{

  "sheetId": string,
  "chartId": integer,
  "dataSourceTableAnchorCell": {
    object (GridCoordinate)
  },
  "dataSourcePivotTableAnchorCell": {
    object (GridCoordinate)
  },
  "dataSourceFormulaCell": {
    object (GridCoordinate)
  }
}
الحقول
نوع المرجع في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الرد:
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

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

معلومات حول القاعدة السابقة في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الرد:
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)

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

InsertCommentResponse

نتيجة إنشاء تعليق

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

object (CommentThread)

سلسلة التعليقات التي تم إدراجها حديثًا

AddCommentReplyResponse

نتيجة إنشاء رد

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

object (Post)

الردّ الذي تم إدراجه حديثًا Post.