- Żądanie HTTP
- Parametry ścieżki
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- Prośba
- UpdateArkuszPropertiesRequest
- UpdateSheetPropertiesRequest
- UpdateDimensionsPropertiesRequest
- DataSourceSheetDimensionsRange
- UpdateNamedRangeRequest
- RequestedCellRequest
- AddNamedRangeRequest
- DeleteNamedRangeRequest
- AddSheetRequest
- DeleteSheetRequest
- AutouzupełnianieRequest
- SourceAndDestination
- CutCutRequest
- Wklej
- CopyWklejRequest
- Wklejanie
- MergeCellsRequest
- MergeType
- UnmergeCells
- UpdateBordersRequest
- UpdateCellsRequest
- AddFilterViewRequest
- IncludeCellsRequest
- ClearBasicFilterRequest
- DeleteDimensionsRequest
- DeleteUmieśćObjectObject
- DeleteFilterViewRequest
- CopyFilterViewRequest
- DuplikatArkuszRequest
- FindReplaceRequest
- InsertwymiarRequest
- InsertRangeRequest
- MoveDimensionsRequest
- UpdateEmbedObjectPositionRequest
- Wklej dane
- TextToColumnRequest
- Typ separatora
- UpdateFilterViewRequest
- DeleteRangeRequest
- IncludewymiarRequest
- AddConditionalFormatRuleRequest
- UpdateConditionalFormatRuleRequest
- DeleteConditionalFormatRuleRequest
- RequestRangeRequest
- SetDataValidationRequest
- SetBasicFilterRequest
- AddProtectedRangeRequest
- UpdateProtectedRangeRequest
- DeleteProtectedRangeRequest
- AutoResizeDimensionsRequest
- AddChartRequest
- UpdateChartSpecRequest
- UpdateBandingRequest
- AddBandingRequest
- DeleteBandingRequest
- CreateDeveloperMetadataRequest
- UpdateDeveloperMetadataRequest
- DeleteDeveloperMetadataRequest
- LoizeRangeRequest
- AddDimensionsGroupRequest
- DeleteGroupGroupRequest
- UpdateDimensionsGroupRequest
- CutWhitespaceRequest
- DeleteDuplikatsRequest
- UpdateEmbedObjectBorderRequest
- AddSlicerRequest
- UpdateSlicerSpecRequest
- AddDataSourceRequest
- UpdateDataSourceRequest
- DeleteDataSourceRequest
- RefreshDataSourceRequest
- DataSourceObjectReferences
- DataSourceObjectReference
- Odpowiedź
- AddNamedRangeResponse
- AddSheetResponse
- AddFilterViewResponse
- DuplikatFiltrView
- DuplikatSheetResponse
- FindReplaceResponse
- UpdateUmieśćObjectPositionResponse
- UpdateConditionalFormatRuleResponse
- DeleteConditionalFormatRuleResponse
- AddProtectedRangeResponse
- AddChartResponse
- AddBandingResponse
- CreateDeveloperMetadataResponse
- UpdateDeveloperMetadataResponse
- DeleteDeveloperMetadataResponse
- AddDimensionsGroupResponse
- DeleteDimensionsGroupResponse
- CutWhitespaceResponse
- DeleteDuplikatsResponse
- AddSlicerResponse
- AddDataSourceResponse
- UpdateDataSourceResponse
- RefreshDataSourceResponse
- RefreshDataSourceObjectExecutionStatus
- Wypróbuj
Stosuje co najmniej jedną aktualizację arkusza kalkulacyjnego.
Każdy request
jest sprawdzany przed zastosowaniem. Jeśli któreś z żądań jest nieprawidłowe, nie powiedzie się żadne żądanie.
Niektóre żądania zawierają dane replies
, które zawierają informacje o tym, jak je stosujemy. Odpowiedzi będą odzwierciedlać żądania. Jeśli na przykład zastosowałeś 4 aktualizacje, a trzecia miała odpowiedź, wtedy odpowiedź będzie miała 2 puste odpowiedzi, faktyczną i kolejną pustą odpowiedź w tej kolejności.
Ze względu na charakter arkusza kalkulacyjnego nie gwarantujemy, że po jego zakończeniu zmiany będą dokładnie odzwierciedlać zmiany, ale gwarantujemy, że aktualizacje w żądaniu zostaną zastosowane atomowo. Zmiany mogą dotyczyć zmian wprowadzanych przez współpracowników. Jeśli nie ma współpracowników, arkusz kalkulacyjny powinien odzwierciedlać zmiany.
Żądanie HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}:batchUpdate
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
spreadsheetId |
Arkusz kalkulacyjny, do którego chcesz zastosować aktualizacje. |
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{
"requests": [
{
object ( |
Pola | |
---|---|
requests[] |
Lista zmian, które zostaną zastosowane w arkuszu kalkulacyjnym. Żądania będą stosowane w określonej kolejności. Jeśli któreś z żądań jest nieprawidłowe, nie są one stosowane. |
includeSpreadsheetInResponse |
Określa, czy odpowiedź powinna zawierać zasób arkusza kalkulacyjnego. |
responseRanges[] |
Ogranicza zakresy uwzględnione w arkuszu odpowiedzi. Ma znaczenie tylko wtedy, gdy |
responseIncludeGridData |
Wartość to „prawda”, jeśli mają być zwracane dane siatki. Ma znaczenie tylko wtedy, gdy |
Treść odpowiedzi
Odpowiedź dotycząca zbiorczego aktualizowania arkusza kalkulacyjnego.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "spreadsheetId": string, "replies": [ { object ( |
Pola | |
---|---|
spreadsheetId |
Arkusz kalkulacyjny, do którego zostały zastosowane aktualizacje. |
replies[] |
Odpowiedź na aktualizacje. Odpowiada on mapom 1:1 zawierającym aktualizacje, chociaż odpowiedzi na niektóre żądania mogą być puste. |
updatedSpreadsheet |
Arkusz kalkulacyjny po zastosowaniu aktualizacji. Tę wartość ustawia się tylko wtedy, gdy |
Zakresy autoryzacji
Wymaga jednego z tych zakresów OAuth:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
Więcej informacji znajdziesz w przewodniku po autoryzacji.