API-Fehler beheben

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

400 Bad Request

Dieser Fehler gibt an, dass die Anfrage falsch formatiert 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 Sheets API 500-Fehler auftreten, liegt in der Regel ein Problem mit der API selbst vor. Erstellen Sie im Issue Tracker der Sheets API einen Fehler bericht mit der Anfrage, die den Fehler verursacht hat.

503 Service Unavailable

Die Sheets API gibt einen 503-Fehler zurück, wenn der Dienst nicht verfügbar ist oder wenn die Anfrage oder die Tabelle sehr komplex ist. Im Folgenden finden Sie einige Vorschläge, wie Sie die Anzahl der 503-Fehler reduzieren können, indem Sie die API-Anfragen und die zugrunde liegende Tabelle ändern.

Anfrage

  • Verwenden Sie batchUpdate, um zusammengehörige Aktualisierungen in einer einzigen Anfrage zu kombinieren. Seien Sie vorsichtig, wenn Sie große Aktualisierungen zusammenfassen, da dies zu einem Timeout führen kann.
  • Beschränken Sie die Anzahl gleichzeitiger Anfragen an die API pro Tabelle auf eine Anfrage pro Sekunde.
  • Rufen Sie bei großen Tabellen nur die erforderlichen Tabellenwerte mit der A1-Notation ab und beschränken Sie die Verwendung von includeGridData.
  • Verwenden Sie Feldmasken, um die von der API zurückgegebene Datenmenge zu begrenzen.
  • Verwenden Sie den exponentiellen Backoff, wenn Sie Anfragen erneut senden.

Tabelle

  • Bei häufig aktualisierten Tabellen sollten Sie regelmäßig zu einer neuen Tabelle wechseln, um die Anzahl der Versionen zu reduzieren.
  • Beschränken Sie die Verwendung von IMPORTRANGE, QUERY und anderen komplexen Formeln.
  • Erwägen Sie, große Tabellen in mehrere Tabellen aufzuteilen.
  • Beschränken Sie die Verwendung einer einzelnen Tabelle als Quelle für viele IMPORTRANGE Formeln.
  • Beschränken Sie den Zugriff auf die Tabelle auf die Personen, die ihn benötigen.