- طلب HTTP
- مَعلمات المسار
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- الطلب
- UpdateSpreadsheetPropertiesRequest
- UpdateSheetPropertiesRequest:
- UpdateDimensionPropertiesRequest
- DataSourceSheetDimensionRange
- UpdateNamedRangeRequest
- RepeatCellRequest
- AddNamedRangeRequest
- DeleteNamedRangeRequest
- AddSheetRequest
- DeleteSheetRequest
- AutoFillRequest
- SourceAndDestination
- CutPasteRequest
- PasteType
- CopyPasteRequest
- PasteOrientation
- MergeCellsRequest
- MergeType
- UnmergeCellsRequest
- UpdateBordersRequest
- UpdateCellsRequest
- AddFilterViewRequest
- AppendCellsRequest
- ClearBasicFilterRequest
- DeleteDimensionRequest
- DeleteEmbeddedObjectRequest
- DeleteFilterViewRequest
- DuplicateFilterViewRequest
- DuplicateSheetRequest
- FindReplaceRequest
- InsertDimensionRequest
- InsertRangeRequest
- MoveDimensionRequest
- UpdateEmbeddedObjectPositionRequest.
- PasteDataRequest
- TextToColumnsRequest
- DelimiterType
- UpdateFilterViewRequest
- DeleteRangeRequest
- AppendDimensionRequest
- AddConditionalFormatRuleRequest
- UpdateConditionalFormatRuleRequest
- DeleteConditionalFormatRuleRequest
- SortRangeRequest
- SetDataValidationRequest
- SetBasicFilterRequest
- AddProtectedRangeRequest
- UpdateProtectedRangeRequest
- DeleteProtectedRangeRequest
- AutoResizeDimensionsRequest
- AddChartRequest
- UpdateChartSpecRequest:
- UpdateBandingRequest
- AddBandingRequest
- DeleteBandingRequest
- CreateDeveloperMetadataRequest
- UpdateDeveloperMetadataRequest.
- DeleteDeveloperMetadataRequest
- RandomizeRangeRequest
- AddDimensionGroupRequest
- DeleteDimensionGroupRequest
- UpdateDimensionGroupRequest
- TrimWhitespaceRequest
- DeleteDuplicatesRequest
- UpdateEmbeddedObjectBorderRequest.
- AddSlicerRequest
- UpdateSlicerSpecRequest
- AddDataSourceRequest
- UpdateDataSourceRequest
- DeleteDataSourceRequest
- RefreshDataSourceRequest
- DataSourceObjectReferences
- DataSourceObjectReference
- CancelDataSourceRefreshRequest
- الرد
- AddNamedRangeResponse
- AddSheetResponse
- AddFilterViewResponse
- DuplicateFilterViewResponse
- DuplicateSheetResponse
- FindReplaceResponse
- UpdateEmbeddedObjectPositionResponse
- UpdateConditionalFormatRuleResponse
- DeleteConditionalFormatRuleResponse
- AddProtectedRangeResponse
- AddChartResponse
- AddBandingResponse
- CreateDeveloperMetadataResponse
- UpdateDeveloperMetadataResponse.
- DeleteDeveloperMetadataResponse
- AddDimensionGroupResponse
- DeleteDimensionGroupResponse (حذف السمة المجمّعة)
- TrimWhitespaceResponse
- DeleteDuplicatesResponse
- AddSlicerResponse
- AddDataSourceResponse (إضافة بيانات مصدر البيانات)
- UpdateDataSourceResponse
- RefreshDataSourceResponse
- RefreshDataSourceObjectExecutionStatus
- CancelDataSourceRefreshResponse
- CancelDataSourceRefreshStatus
- RefreshCancellationStatus
- RefreshCancellationState
- RefreshCancellationErrorCode
- جرِّبه الآن
يتم تطبيق تعديل واحد أو أكثر على جدول البيانات.
يتم التحقّق من صحة كل request
قبل تطبيقها. إذا كان أي طلب غير صالح، فسيفشل الطلب بالكامل ولن يتم تطبيق أي شيء.
تحتوي بعض الطلبات على replies
لتزويدك ببعض المعلومات عن كيفية تطبيقها. ستعكس الردود الطلبات. على سبيل المثال، إذا طبّقت 4 تعديلات وكان الردّ الثالث يتضمّن ردًا، سيتضمّن الردّ ردَّين فارغَين، الردّ الفعلي وردًّا آخر فارغًا بهذا الترتيب.
نظرًا للطبيعة التعاونية لجداول البيانات، لا يمكن ضمان أن يعكس جدول البيانات التغييرات التي أجريتها بالضبط بعد اكتمال ذلك، ولكن يمكنك أن تضمن تطبيق التعديلات في الطلب معًا بشكل شامل. قد يتم إجراء تغييرات على تغييرات المتعاونين. إذا لم يكن هناك متعاونون، يجب أن يعكس جدول البيانات التغييرات التي أجريتها.
طلب HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}:batchUpdate
يستخدم عنوان URL بنية تحويل الترميز gRPC.
معلمات المسار
المَعلمات | |
---|---|
spreadsheetId |
جدول البيانات الذي تريد تطبيق التعديلات عليه. |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"requests": [
{
object ( |
الحقول | |
---|---|
requests[] |
قائمة التعديلات التي سيتم تطبيقها على جدول البيانات. سيتم تطبيق الطلبات بالترتيب الذي تم تحديدها به. وفي حال كان أي طلب غير صالح، لن يتم تطبيق أي طلبات. |
includeSpreadsheetInResponse |
تحدِّد ما إذا كان يجب أن تتضمّن استجابة التحديث مورد جدول البيانات. |
responseRanges[] |
يحدّ هذا الخيار من النطاقات المضمّنة في جدول بيانات الردود. يكون مفيدًا فقط إذا كانت قيمة |
responseIncludeGridData |
True إذا كان يجب عرض بيانات الشبكة. يكون مفيدًا فقط إذا كانت قيمة |
نص الاستجابة
الردّ على التعديل المجمّع لجدول بيانات.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "spreadsheetId": string, "replies": [ { object ( |
الحقول | |
---|---|
spreadsheetId |
جدول البيانات الذي تم تطبيق التعديلات عليه. |
replies[] |
الردّ على التعديلات يؤدي هذا إلى الربط بين شخصين بالتعديلات، على الرغم من أنّ الردود على بعض الطلبات قد تكون فارغة. |
updatedSpreadsheet |
جدول البيانات بعد تطبيق التعديلات. ولا يتم ضبط هذه السياسة إلا إذا كانت قيمة السمة |
نطاقات التفويض
يتطلب استخدام أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.