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

Na tej stronie opisano, jak rozwiązywać błędy występujące w interfejsie Sheets API.

400 Bad Request

Ten błąd wskazuje, że żądanie miało nieprawidłowy format. Aby rozwiązać problemy z tymi prośbami, zapoznaj się z dokumentacją referencyjną i stroną pomocy.

500 Internal Server Error

Jeśli podczas korzystania z interfejsu Sheets API występują błędy 500, zwykle oznacza to, że problem dotyczy samego interfejsu API. Prześlij raport o błędzie interfejsu Sheets API za pomocą śledzika problemów, podając żą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 lub arkusz kalkulacyjny jest bardzo skomplikowany. Poniżej znajdziesz kilka sugestii dotyczących ograniczenia liczby błędów 503 poprzez zmodyfikowanie żądań do interfejsu API i podstawowego arkusza kalkulacyjnego.

Żądanie

  • Aby połączyć powiązane aktualizacje w jednym żądaniu, użyj parametru batchUpdate. Zachowaj ostrożność podczas grupowania 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 za pomocą notacji A1 i ograniczaj użycie includeGridData.
  • Użyj masek pól, aby ograniczyć ilość danych zwracanych przez interfejs API.
  • Stosuj odczekiwanie wykładnicze podczas ponownego próbowania żądań.

Arkusz kalkulacyjny

  • W przypadku często aktualizowanych arkuszy okresowo przenoś je do nowego arkusza kalkulacyjnego, aby ograniczyć gromadzenie się wersji.
  • Ogranicz stosowanie funkcji IMPORTRANGE, QUERY i innych złożonych formuł.
  • Rozważ podzielenie dużych arkuszy kalkulacyjnych na kilka arkuszy.
  • Ogranicz używanie pojedynczego arkusza kalkulacyjnego jako źródła wielu IMPORTRANGEformuł.
  • Ogranicz dostęp do arkusza kalkulacyjnego tylko do osób, które go potrzebują.