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

Na tej stronie opisaliśmy, jak rozwiązywać problemy z błędami interfejsu API Arkuszy.

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 API Arkuszy pojawiają się błędy 500, zwykle oznacza to, że wystąpił problem z samym interfejsem API. Prześlij raport o błędzie z żądaniem, które spowodowało błąd, w narzędziu Issue Tracker w interfejsie API Arkuszy.

503 Service Unavailable

Interfejs Arkuszy API zwraca błąd 503, gdy usługa jest niedostępna lub gdy złożoność żądania lub arkusza kalkulacyjnego jest duża. Poniżej znajdziesz kilka sugestii, które pomogą Ci ograniczyć liczbę błędów 503 przez modyfikowanie żądań do interfejsu API i odpowiedniego arkusza kalkulacyjnego.

Prośba

  • Użyj batchUpdate, aby połączyć powiązane aktualizacje w jednym żądaniu. Zachowaj ostrożność podczas grupowania dużych aktualizacji, ponieważ może to spowodować przekroczenie limitu czasu.
  • Ogranicz liczbę żądań równoczesnych do interfejsu API na arkusz kalkulacyjny do 1 żądania na sekundę.
  • W przypadku dużych arkuszy kalkulacyjnych pobieraj tylko niezbędne wartości, korzystając z notacji A1, i ogranicz używanie includeGridData.
  • Używaj masek pól, aby ograniczyć ilość danych zwracanych przez interfejs API.
  • Używaj wykładniczego ponowienia przy ponawianiu żądań.

Arkusz kalkulacyjny

  • W przypadku często aktualizowanych arkuszy zmieniaj je co jakiś czas, aby ograniczyć nagromadzenie wersji.
  • Ogranicz korzystanie z IMPORTRANGE, QUERY i innych złożonych formuł.
  • Rozważ podzielenie dużych arkuszy kalkulacyjnych na kilka.
  • Ogranicz używanie pojedynczego arkusza kalkulacyjnego jako źródła wielu formuł IMPORTRANGE.
  • Ogranicz dostęp do arkusza kalkulacyjnego tylko do tych osób, które go potrzebują.