API-Fehler beheben

Auf dieser Seite wird beschrieben, wie Sie Fehler mit der Google Tabellen API beheben.

400 Bad Request

Dieser Fehler gibt an, dass die Anfrage fehlerhaft war. Informationen zur Fehlerbehebung bei diesen Anfragen finden Sie in der Referenzdokumentation und auf der Supportseite.

500 Internal Server Error

Wenn bei der Verwendung der Google Tabellen API 500-Fehler auftreten, liegt in der Regel ein Problem mit der API selbst vor. Reichen Sie im Issue Tracker der Google Tabellen API einen Fehlerbericht mit der Anfrage ein, die den Fehler verursacht hat.

503 Service Unavailable

Die Google Tabellen API gibt den Fehler 503 zurück, wenn der Dienst nicht verfügbar ist oder die Anfrage oder Tabelle sehr komplex ist. Im Folgenden finden Sie einige Vorschläge, wie Sie die Häufigkeit von 503-Fehlern durch Ändern der API-Anfragen und der zugrunde liegenden Tabelle begrenzen können.

Anfrage

  • Verwenden Sie batchUpdate, um ähnliche Aktualisierungen in einer einzigen Anfrage zu kombinieren. Seien Sie vorsichtig, wenn Sie viele Updates gleichzeitig vornehmen, da dies zu einem Zeitüberschreitungsfehler führen kann.
  • Begrenzen Sie die Anzahl der gleichzeitigen Anfragen an die API pro Tabelle auf eine Anfrage pro Sekunde.
  • Rufen Sie bei großen Tabellen nur die erforderlichen Tabellenwerte mithilfe der A1-Notation ab und beschränken Sie die Verwendung von includeGridData.
  • Verwenden Sie Feldmasken, um die Menge der von der API zurückgegebenen Daten zu begrenzen.
  • Verwenden Sie den exponentiellen Backoff, wenn Sie Anfragen noch einmal senden.

Tabelle

  • Wenn Sie häufig aktualisierte Tabellen verwenden, sollten Sie regelmäßig zu einer neuen Tabelle wechseln, um die Anzahl der Versionen zu reduzieren.
  • Begrenzen Sie die Verwendung von IMPORTRANGE, QUERY und anderen komplexen Formeln.
  • Große Tabellen sollten in mehrere Tabellen aufgeteilt werden.
  • Verwenden Sie eine einzelne Tabelle nicht als Quelle für viele IMPORTRANGE-Formeln.
  • Beschränken Sie den Zugriff auf die Tabelle auf diejenigen, die ihn benötigen.