Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Na tej stronie dowiesz się, jak rozwiązywać problemy z interfejsem Google Sheets API.
400 Bad Request
Ten błąd oznacza, że żądanie miało nieprawidłowy format. Informacje o rozwiązywaniu problemów z tymi żądaniami znajdziesz w dokumentacji referencyjnej i na stronie pomocy.
500 Internal Server Error
Jeśli podczas korzystania z interfejsu Sheets API napotkasz błędy 500, zwykle oznacza to, że występuje problem z samym interfejsem API. Zgłoś błąd w Issue Trackerze interfejsu API Arkuszy z żądaniem, które spowodowało błąd.
503 Service Unavailable
Interfejs Sheets API zwraca błąd 503, gdy usługa jest niedostępna lub gdy złożoność żądania lub arkusza kalkulacyjnego jest wysoka. Poniżej znajdziesz kilka sugestii, jak ograniczyć liczbę błędów 503, modyfikując żądania do interfejsu API i powiązany arkusz kalkulacyjny.
Żądanie
Użyj batchUpdate, aby połączyć powiązane aktualizacje w jedno żądanie.
Zachowaj ostrożność podczas przetwarzania dużych aktualizacji, ponieważ może to spowodować przekroczenie limitu czasu.
Ogranicz liczbę równoczesnych żądań do interfejsu API na arkusz kalkulacyjny do 1 żądania na sekundę.
W przypadku dużych arkuszy kalkulacyjnych pobieraj tylko niezbędne wartości arkusza kalkulacyjnego za pomocą notacji A1 i ogranicz użycie includeGridData.
Używaj masek pól, aby ograniczyć ilość danych zwracanych przez interfejs API.
Podczas ponawiania żądań używaj wzrastającego czasu do ponowienia.
Arkusz kalkulacyjny
W przypadku często aktualizowanych arkuszy co jakiś czas przełączaj się na nowy arkusz kalkulacyjny, aby zmniejszyć liczbę wersji.
Ogranicz używanie funkcji IMPORTRANGE, QUERY i innych złożonych formuł.
Rozważ podzielenie dużych arkuszy kalkulacyjnych na kilka mniejszych.
Ogranicz używanie jednego arkusza kalkulacyjnego jako źródła wielu formuł IMPORTRANGE.
Ogranicz dostęp do arkusza kalkulacyjnego tylko do osób, które go potrzebują.
[null,null,["Ostatnia aktualizacja: 2025-08-29 UTC."],[],[],null,["# Troubleshoot API errors\n\nThis page describes how to troubleshoot errors with the Sheets API.\n| **Note:** The [Status\n| Dashboard](https://www.google.com/appsstatus/dashboard/) is a good place to start when troubleshooting errors with the Sheets API. It provides real-time information about the status of the Sheets API.\n\n`400 Bad Request`\n-----------------\n\nThis error indicates that the request was malformed. For troubleshooting these\nrequests, see the [reference documentation](https://developers.google.com/workspace/sheets/api/reference/rest) and the\n[support page](https://developers.google.com/workspace/sheets/api/support#questions_advice).\n\n`500 Internal Server Error`\n---------------------------\n\nIf you are encountering 500 errors when using the Sheets API, it\ntypically indicates that there is an issue with the API itself. File a bug\nreport on the Sheets API [Issue Tracker](https://developers.google.com/workspace/sheets/api/support#developer_product_feedback) with the request that caused\nthe error.\n\n`503 Service Unavailable`\n-------------------------\n\nThe Sheets API returns a 503 error when the service is unavailable or\nwhen the complexity of the request or spreadsheet is high. The following are\nsome suggestions to limit the rate of 503 errors by modifying the API requests\nand the underlying spreadsheet.\n\n### Request\n\n- Use [`batchUpdate`](https://developers.google.com/workspace/sheets/api/guides/batch) to combine related updates into a single request. Exercise caution when batching large updates as this might trigger a timeout.\n- Limit the number of concurrent requests to the API per spreadsheet to 1 request per second.\n- For large spreadsheets, retrieve only the necessary spreadsheet values using [A1 notation](https://developers.google.com/workspace/sheets/api/guides/concepts#cell) and limit the use of [`includeGridData`](https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/get#query-parameters).\n- Use [field masks](https://developers.google.com/workspace/sheets/api/guides/performance#partial) to limit the amount of data returned by the API.\n- Use exponential backoff when retrying requests.\n\n### Spreadsheet\n\n- For frequently updated sheets, rotate to a new spreadsheet periodically to reduce accumulation of versions.\n- Limit the use of [`IMPORTRANGE`](https://support.google.com/docs/answer/3093340), [`QUERY`](https://support.google.com/docs/answer/3093343), and other complex formulas.\n- Consider splitting large spreadsheets into multiple spreadsheets.\n- Limit the use of a single spreadsheet as a source for many [`IMPORTRANGE`](https://support.google.com/docs/answer/3093340) formulas.\n- Limit access to the spreadsheet to only those who need it."]]
