Rozwiązywanie problemów z błędami interfejsu API

Ta strona zawiera informacje o tym, jak rozwiązywać błędy związane z interfejsem Sheets API.

400 Bad Request

Ten błąd oznacza, że żądanie jest nieprawidłowo sformułowane. Aby rozwiązać problemy z tymi żądaniami, zapoznaj się z dokumentacją i stroną pomocy.

500 Internal Server Error

Jeśli podczas korzystania z interfejsu Sheets API występują błędy 500, zwykle oznacza to, że występuje problem z samym interfejsem API. Zgłoś błąd w narzędziu do śledzenia problemów z interfejsem Sheets API i podaj żądanie, które spowodowało błąd.

503 Service Unavailable

Interfejs Sheets API zwraca błąd 503, gdy usługa jest niedostępna lub gdy żądanie bądź arkusz kalkulacyjny są zbyt złożone. Oto 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 łączenia dużych aktualizacji, ponieważ może to spowodować przekroczenie limitu czasu.
  • Ogranicz liczbę jednoczesnych żądań do interfejsu API na arkusz kalkulacyjny do 1 żądania na sekundę.
  • W przypadku dużych arkuszy kalkulacyjnych pobieraj tylko niezbędne wartości 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 okresowo przełączaj się na nowy arkusz kalkulacyjny, aby ograniczyć gromadzenie się wersji.
  • Ogranicz użycie funkcji IMPORTRANGE, QUERY i innych złożonych formuł.
  • Rozważ podzielenie dużych arkuszy kalkulacyjnych na kilka arkuszy.
  • Ogranicz użycie jednego arkusza kalkulacyjnego jako źródła wielu IMPORTRANGE formuł.
  • Ogranicz dostęp do arkusza kalkulacyjnego tylko do osób, które go potrzebują.