- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- अनुरोध
- 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 अपडेट लागू किए हैं और तीसरे वाले पर कोई जवाब दिया है, तो जवाब में इसी क्रम में दो खाली जवाब, असली जवाब और दूसरा खाली जवाब होगा.
स्प्रेडशीट में किए जाने वाले बदलाव, एक साथ मिलकर काम करते हैं. इस वजह से, इस बात की कोई गारंटी नहीं है कि स्प्रेडशीट में आपके किए गए बदलाव पूरे होने के बाद दिखेंगे. हालांकि, इस बात की गारंटी है कि अनुरोध में किए गए अपडेट, एक-दूसरे के साथ मिलकर लागू होंगे. सहयोगकर्ता के परिवर्तनों के संबंध में आपके परिवर्तन बदल सकते हैं. अगर कोई सहयोगी नहीं है, तो स्प्रेडशीट में आपके बदलाव दिखेंगे.
एचटीटीपी अनुरोध
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}:batchUpdate
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ के पैरामीटर
पैरामीटर | |
---|---|
spreadsheetId |
वह स्प्रेडशीट जिस पर अपडेट लागू करने हैं. |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, इस तरह का डेटा शामिल होता है:
जेएसओएन के काेड में दिखाना |
---|
{
"requests": [
{
object ( |
फ़ील्ड | |
---|---|
requests[] |
स्प्रेडशीट पर लागू करने के लिए अपडेट की सूची. अनुरोध उसी क्रम में लागू किए जाएंगे जिस क्रम में वे तय किए गए हैं. अगर कोई अनुरोध मान्य नहीं है, तो कोई अनुरोध लागू नहीं किया जाएगा. |
includeSpreadsheetInResponse |
यह तय करता है कि अपडेट के रिस्पॉन्स में स्प्रेडशीट का संसाधन शामिल होना चाहिए या नहीं. |
responseRanges[] |
जवाब वाली स्प्रेडशीट में शामिल रेंज को सीमित करता है. इसका मतलब सिर्फ़ तब है, जब |
responseIncludeGridData |
अगर ग्रिड डेटा दिया जाना चाहिए, तो सही. इसका मतलब सिर्फ़ तब है, जब |
जवाब का मुख्य भाग
स्प्रेडशीट को अपडेट करने के बैच का जवाब.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
जेएसओएन के काेड में दिखाना |
---|
{ "spreadsheetId": string, "replies": [ { object ( |
फ़ील्ड | |
---|---|
spreadsheetId |
वह स्प्रेडशीट जिस पर अपडेट लागू किए गए थे. |
replies[] |
अपडेट का जवाब. इसमें अपडेट के साथ 1:1 मैप किया गया है. हालांकि, हो सकता है कि कुछ अनुरोधों के जवाब खाली हों. |
updatedSpreadsheet |
अपडेट लागू होने के बाद की स्प्रेडशीट. यह सिर्फ़ तब सेट होता है, जब |
अनुमति के दायरे
इनमें से किसी एक OAuth दायरों की ज़रूरत होती है:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.